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

[3.13] Document ``mimetypes.MimeTypes.add_type()`` (GH-122301) (#122328)

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 91e8c30f8607..8ad4850584a7 100644
--- a/Doc/library/mimetypes.rst
+++ b/Doc/library/mimetypes.rst
@@ -295,3 +295,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.