]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.12] Document ``mimetypes.MimeTypes.add_type()`` (GH-122301) (#122329)
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Fri, 26 Jul 2024 22:10:01 +0000 (00:10 +0200)
committerGitHub <noreply@github.com>
Fri, 26 Jul 2024 22:10:01 +0000 (22:10 +0000)
Document ``mimetypes.MimeTypes.add_type()`` (GH-122301)
(cherry picked from commit d52726ccd456833ea9f09cabb4b8aef09755e472)

Co-authored-by: Subrahmanya Gaonkar <148525245+negativenagesh@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Doc/library/mimetypes.rst

index 930b4793189a6fe0d3c175d01ad9ee6b75bf0fcf..1522285b4efe40ff6670558829b17559d7000cfb 100644 (file)
@@ -272,3 +272,13 @@ than one MIME-type database; it provides an interface similar to the one of the
       types, else to the list of non-standard types.
 
       .. versionadded:: 3.2
+
+
+   .. method:: MimeTypes.add_type(type, ext, strict=True)
+
+      Add a mapping from the MIME type *type* to the extension *ext*. When the
+      extension is already known, the new type will replace the old one. When the type
+      is already known the extension will be added to the list of known extensions.
+
+      When *strict* is ``True`` (the default), the mapping will be added to the
+      official MIME types, otherwise to the non-standard ones.