feat: add guess_file_type to mimetypes module to support path-based MIME lookups

Author: NaveenKumarG-dev

Doc/library/mimetypes.rst

@@ -28,8 +28,8 @@ the information :func:`init` sets up.
 
    .. index:: pair: MIME; headers
 
-   Guess the type of a file based on its filename, path or URL, given by *url*.
-   URL can be a string or a :term:`path-like object`.
+   Guess the type of a file based on its URL, given by *url*.
+   URL can be a string.
 
    The return value is a tuple ``(type, encoding)`` where *type* is ``None`` if the
    type can't be guessed (missing or unknown suffix) or a string of the form
@@ -57,6 +57,7 @@ the information :func:`init` sets up.
    .. deprecated:: 3.16
       Passing a file path (or path-like object) instead of a URL.
       Use :func:`guess_file_type` instead.
+      Soft-deprecated since Python 3.13, scheduled for removal in Python 3.21.
 
 
 .. function:: guess_file_type(path, *, strict=True)
@@ -265,6 +266,7 @@ than one MIME-type database; it provides an interface similar to the one of the
       .. deprecated:: 3.16
          Passing a file path (or path-like object) instead of a URL.
          Use :meth:`guess_file_type` instead.
+         Soft-deprecated since Python 3.13, scheduled for removal in Python 3.21.
 
    .. method:: MimeTypes.guess_file_type(path, *, strict=True)
 

Lib/mimetypes.py

@@ -108,10 +108,6 @@ def add_type(self, type, ext, strict=True):
     def guess_type(self, url, strict=True):
         """Guess the type of a file based on its URL.
 
-        .. deprecated:: 3.16
-           Passing a file path (or path-like object) is deprecated.
-           Use :meth:`guess_file_type` instead.
-
         Return value is a tuple (type, encoding) where type is None if
         the type can't be guessed (no or unknown suffix) or a string
         of the form type/subtype, usable for a MIME Content-type
@@ -139,7 +135,6 @@ def guess_type(self, url, strict=True):
             scheme = p.scheme
             url = p.path
         else:
-            # Input has no URL scheme — it is a file path, not a URL.
             warnings.warn(
                 "Passing a file path to guess_type() is deprecated and will be "
                 "removed in a future version. Use guess_file_type() instead.",

Lib/test/test_mimetypes.py

@@ -501,92 +501,7 @@ def test_keywords_args_api(self):
             type='image/jpeg', strict=True), ['.jpg', '.jpe', '.jpeg'])
 
 
-class GuessTypeDeprecationTestCase(unittest.TestCase):
-    """Tests that guess_type() emits DeprecationWarning for file path inputs."""
 
-    def setUp(self):
-        self.db = mimetypes.MimeTypes()
-
-    # --- Module-level function tests ---
-
-    def test_module_plain_string_path_warns(self):
-        """Module-level guess_type() warns for a plain string with no URL scheme."""
-        with self.assertWarns(DeprecationWarning) as cm:
-            mimetypes.guess_type("file.txt")
-        self.assertIn("guess_file_type", str(cm.warning))
-        self.assertIn("deprecated", str(cm.warning).lower())
-
-    def test_module_pathlike_warns(self):
-        """Module-level guess_type() warns for a path-like object."""
-        with self.assertWarns(DeprecationWarning):
-            mimetypes.guess_type(pathlib.Path("file.txt"))
-
-    def test_module_bytes_path_warns(self):
-        """Module-level guess_type() warns for a bytes path."""
-        with self.assertWarns(DeprecationWarning):
-            mimetypes.guess_type(b"file.txt")
-
-    def test_module_url_with_scheme_no_warning(self):
-        """Module-level guess_type() does NOT warn for a proper URL."""
-        with warnings.catch_warnings():
-            warnings.simplefilter("error", DeprecationWarning)
-            # Should not raise -- http:// is a valid multi-char scheme.
-            mimetypes.guess_type("http://example.com/file.html")
-
-    def test_module_data_url_no_warning(self):
-        """Module-level guess_type() does NOT warn for data: URLs."""
-        with warnings.catch_warnings():
-            warnings.simplefilter("error", DeprecationWarning)
-            mimetypes.guess_type("data:text/plain,hello")
-
-    # --- MimeTypes class method tests ---
-
-    def test_method_plain_string_path_warns(self):
-        """MimeTypes.guess_type() warns for a plain string with no URL scheme."""
-        with self.assertWarns(DeprecationWarning) as cm:
-            self.db.guess_type("file.html")
-        self.assertIn("guess_file_type", str(cm.warning))
-
-    def test_method_pathlike_warns(self):
-        """MimeTypes.guess_type() warns for a path-like object."""
-        with self.assertWarns(DeprecationWarning):
-            self.db.guess_type(pathlib.Path("file.html"))
-
-    def test_method_bytes_path_warns(self):
-        """MimeTypes.guess_type() warns for a bytes path."""
-        with self.assertWarns(DeprecationWarning):
-            self.db.guess_type(b"file.html")
-
-    def test_method_url_with_scheme_no_warning(self):
-        """MimeTypes.guess_type() does NOT warn for a proper URL."""
-        with warnings.catch_warnings():
-            warnings.simplefilter("error", DeprecationWarning)
-            self.db.guess_type("http://example.com/file.html")
-
-    def test_method_ftp_url_no_warning(self):
-        """MimeTypes.guess_type() does NOT warn for an ftp: URL."""
-        with warnings.catch_warnings():
-            warnings.simplefilter("error", DeprecationWarning)
-            self.db.guess_type("ftp://example.com/file.tar.gz")
-
-    def test_result_unchanged(self):
-        """guess_type() with a file path still returns the correct MIME type."""
-        with self.assertWarns(DeprecationWarning):
-            result = mimetypes.guess_type("file.html")
-        expected = mimetypes.guess_file_type("file.html")
-        self.assertEqual(result, expected)
-
-    def test_result_unchanged_pathlike(self):
-        """guess_type() with a PathLike still returns the correct MIME type."""
-        with self.assertWarns(DeprecationWarning):
-            result = self.db.guess_type(pathlib.Path("file.tar.gz"))
-        expected = self.db.guess_file_type(pathlib.Path("file.tar.gz"))
-        self.assertEqual(result, expected)
-
-    def test_os_helper_fakepath_warns(self):
-        """guess_type() warns for os_helper.FakePath (a path-like object)."""
-        with self.assertWarns(DeprecationWarning):
-            self.db.guess_type(os_helper.FakePath("file.tar.gz"))
 
 
 @unittest.skipUnless(sys.platform.startswith("win"), "Windows only")

Misc/NEWS.d/next/Library/2026-06-17-09-45-00.gh-issue-151575.mimetype.rst

@@ -1 +1 @@
-Emit DeprecationWarning when a file path is passed to :func:`mimetypes.guess_type`. Use :func:`mimetypes.guess_file_type` instead.
+Deprecate passing a file path to :func:`mimetypes.guess_type`. Use :func:`mimetypes.guess_file_type` instead.