gh-91217: deprecate-pipes (GH-91779)

Author: brettcannon

Diff for: Doc/whatsnew/3.11.rst

@@ -919,6 +919,7 @@ Deprecated
   * :mod:`nis`
   * :mod:`nntplib`
   * :mod:`ossaudiodev`
+  * :mod:`pipes`
 
   (Contributed by Brett Cannon in :issue:`47061`.)
 

Diff for: Lib/pipes.py

@@ -60,10 +60,13 @@
 import re
 import os
 import tempfile
+import warnings
 # we import the quote function rather than the module for backward compat
 # (quote used to be an undocumented but used function in pipes)
 from shlex import quote
 
+warnings._deprecated(__name__, remove=(3, 13))
+
 __all__ = ["Template"]
 
 # Conversion step kinds

Diff for: Lib/test/test_pipes.py

@@ -1,10 +1,12 @@
-import pipes
 import os
 import string
 import unittest
 import shutil
 from test.support import reap_children, unix_shell
 from test.support.os_helper import TESTFN, unlink
+from test.support.warnings_helper import import_deprecated
+
+pipes = import_deprecated("pipes")
 
 
 if os.name != 'posix':

Diff for: Misc/NEWS.d/next/Library/2022-04-17-12-07-50.gh-issue-91217.TIvrsq.rst

@@ -0,0 +1 @@
+Deprecate the 'pipes' module.