mimetypes Namespace Reference

Data Structures
class	MimeTypes

Functions
def	guess_type
def	guess_extension
def	init
def	read_mime_types
def	usage

Variables
list	__all__ = ["guess_type","guess_extension","read_mime_types","init"]
list	knownfiles
int	inited = 0
dictionary	suffix_map
dictionary	encodings_map
dictionary	types_map
dictionary	common_types
string	USAGE
int	strict = 1
int	extension = 0
tuple	guess = guess_extension(gtype, strict)

Detailed Description

Guess the MIME type of a file.

This module defines two useful functions:

guess_type(url, strict=1) -- guess the MIME type and encoding of a URL.

guess_extension(type, strict=1) -- guess the extension for a given MIME type.

It also contains the following, for tuning the behavior:

Data:

knownfiles -- list of files to parse
inited -- flag set when init() has been called
suffix_map -- dictionary mapping suffixes to suffixes
encodings_map -- dictionary mapping suffixes to encodings
types_map -- dictionary mapping suffixes to types

Functions:

init([files]) -- parse a list of files, default knownfiles
read_mime_types(file) -- parse one file, return a dictionary or None

Function Documentation

def mimetypes.guess_extension	(		type,
			strict = 1
	)

Guess the extension for a file based on its MIME type.

Return value is a string giving a filename extension, including the
leading dot ('.').  The extension is not guaranteed to have been
associated with any particular data stream, but would be mapped to the
MIME type `type' by guess_type().  If no extension can be guessed for
`type', None is returned.

Optional `strict' argument when false adds a bunch of commonly found,
but non-standard types.

Definition at line 191 of file mimetypes.py.

References init().

def guess_extension(type, strict=1):
    """Guess the extension for a file based on its MIME type.

    Return value is a string giving a filename extension, including the
    leading dot ('.').  The extension is not guaranteed to have been
    associated with any particular data stream, but would be mapped to the
    MIME type `type' by guess_type().  If no extension can be guessed for
    `type', None is returned.

    Optional `strict' argument when false adds a bunch of commonly found,
    but non-standard types.
    """
    init()
    return guess_extension(type, strict)