[docs] Bug in mimetypes.MimeTypes documentation (original) (raw)

Łukasz Cieśnik lukasz.ciesnik at gmail.com
Thu Jun 9 10:38:43 CEST 2011

Hello,

I have found that MimeTypes class does not provide same interface as mimetypes module does in terms of types_map and common_types attributes. There is no common_types dictionary found in MimeTypes instances and types_map is a tuple of (non_strict, strict) extension to mime type mappings:

Python 2.7.1 (r271:86832, Nov 27 2010, 17:19:03) [MSC v.1500 64 bit (AMD64)] on win32 Type "help", "copyright", "credits" or "license" for more information.

import mimetypes m = mimetypes.MimeTypes() type(m.types_map) <type 'tuple'> m.common_types Traceback (most recent call last): File "", line 1, in AttributeError: MimeTypes instance has no attribute 'common_types' m.types_map[True] {'.obj': 'application/octet-stream', '.ra': 'audio/x-pn-realaudio', '.dwfx': 'model/vnd.dwfx+xps', '.wsdl': 'application/xml', [...] '.wvx': 'video/x-ms-wvx'} m.types_map[False] {'.xul': 'text/xul', '.pic': 'image/pict', '.pict': 'image/pict', '.jpg': 'image/jpg', '.rtf': 'application/rtf', '.pct': 'image/pict', '.mid': 'audio/midi', '.midi': 'audio/midi'}

At the same time documentation advertises this quite differently:

18.7.1. MimeTypes Objects http://docs.python.org/library/mimetypes.html#mimetypes-objects

.. attribute:: MimeTypes.types_map

 Dictionary mapping filename extensions to MIME types.  This is

initially a copy of the global types_map defined in the module.

.. attribute:: MimeTypes.common_types

 Dictionary mapping filename extensions to non-standard, but

commonly found MIME types. This is initially a copy of the global common_types defined in the module.

It would be nice if it resembled module interface, so this might be a code issue as well. Nevertheless currently documentation says something different than code does.

Thanks,

-- Łukasz Cieśnik

More information about the docs mailing list