gh-111637: Clarify MIME type recognition behavior in mimetypes documentation (GH-129546)

This commit is contained in:
donBarbos 2025-02-03 20:42:12 +04:00 committed by GitHub
parent 75b628adeb
commit bb5c6875d6
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -47,9 +47,11 @@ the information :func:`init` sets up.
The optional *strict* argument is a flag specifying whether the list of known MIME types The optional *strict* argument is a flag specifying whether the list of known MIME types
is limited to only the official types `registered with IANA is limited to only the official types `registered with IANA
<https://www.iana.org/assignments/media-types/media-types.xhtml>`_. <https://www.iana.org/assignments/media-types/media-types.xhtml>`_.
When *strict* is ``True`` (the default), only the IANA types are supported; when However, the behavior of this module also depends on the underlying operating
*strict* is ``False``, some additional non-standard but commonly used MIME types system. Only file types recognized by the OS or explicitly registered with
are also recognized. Python's internal database can be identified. When *strict* is ``True`` (the
default), only the IANA types are supported; when *strict* is ``False``, some
additional non-standard but commonly used MIME types are also recognized.
.. versionchanged:: 3.8 .. versionchanged:: 3.8
Added support for *url* being a :term:`path-like object`. Added support for *url* being a :term:`path-like object`.