Deprecate nturl2path

Author: barneygale

Doc/whatsnew/3.14.rst

@@ -1135,6 +1135,11 @@ Deprecated
   or *sequence* as keyword arguments is now deprecated.
   (Contributed by Kirill Podoprigora in :gh:`121676`.)
 
+* :mod:`!nturl2path`: This module is now deprecated. Call
+  :func:`urllib.request.url2pathname` and :func:`~urllib.request.pathname2url`
+  instead.
+  (Contributed by Barney Gale in gh:`125866`.)
+
 * :mod:`os`:
   :term:`Soft deprecate <soft deprecated>` :func:`os.popen` and
   :func:`os.spawn* <os.spawnl>` functions. They should no longer be used to

Lib/nturl2path.py

@@ -5,6 +5,11 @@
 """
 # Testing is done through test_nturl2path.
 
+import warnings
+
+
+warnings._deprecated(__name__, remove=(3, 19))
+
 def url2pathname(url):
     """OS-specific conversion from a relative URL of the 'file' scheme
     to a file system path; not recommended for general use."""

Lib/test/test_nturl2path.py

@@ -1,6 +1,10 @@
-import nturl2path
 import unittest
 
+from test.support import warnings_helper
+
+nturl2path = warnings_helper.import_deprecated("nturl2path")
+
+
 
 class NTURL2PathTest(unittest.TestCase):
     """Test pathname2url() and url2pathname()"""

Misc/NEWS.d/next/Library/2025-03-19-00-09-15.gh-issue-125866.sIIJ5N.rst

@@ -0,0 +1,3 @@
+Deprecate the :mod:`!nturl2path` module. Call
+:func:`urllib.request.url2pathname` and :func:`~urllib.request.pathname2url`
+instead.