pantomime
is a small library that handles the parsing and normalisation
of internet MIME types in Python. This can be useful to normalise invalid,
or misformatted MIME types emitted by remote web servers.
The simplest use is to normalise a MIME type:
from pantomime import normalize_mimetype
assert normalize_mimetype('TEXT/PLAIN') == 'text/plain'
assert normalize_mimetype('plain/text') == 'text/plain'
assert normalize_mimetype(None) == 'application/octet-stream'
assert normalize_mimetype('') == 'application/octet-stream'
Internally, pantomime
uses a MIMEType
object to handle parsing. It can
be used to access more specific information, like human readable labels:
from pantomime import parse_mimetype
parsed = parse_mimetype('text/plain')
assert parsed.family == 'text'
assert parsed.subtype == 'plain'
assert parsed.label == 'Plain text'
- Internationalisation, i.e. make the human-readable labels available in multiple languages.
- Expand replacements for specific MIME types.
Licensed under MIT terms, see the LICENSE
file included in this repository.