From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 26 Jul 2024 22:10:01 +0000 (+0200)
Subject: [3.12] Document ``mimetypes.MimeTypes.add_type()`` (GH-122301) (#122329)
X-Git-Tag: v3.12.5~50
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d4ca183a3892587cf4d9f4de2bfa379d211368f7;p=thirdparty%2FPython%2Fcpython.git

[3.12] Document ``mimetypes.MimeTypes.add_type()`` (GH-122301) (#122329)

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>
---

diff --git a/Doc/library/mimetypes.rst b/Doc/library/mimetypes.rst
index 930b4793189a..1522285b4efe 100644
--- a/Doc/library/mimetypes.rst
+++ b/Doc/library/mimetypes.rst
@@ -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.