Added deprecation warnings to all modules not previously prefixed with an underscore

This was done to discourage anyone from importing `wheel`.

Author: agronholm

README.rst

@@ -1,19 +1,25 @@
 wheel
 =====
 
-This library is the reference implementation of the Python wheel packaging
-standard, as defined in `PEP 427`_.
+This is a command line tool for manipulating Python wheel files, as defined in
+`PEP 427`_. It contains the following functionality:
 
-It has two different roles:
+* Convert ``.egg`` archives into ``.whl``
+* Unpack wheel archives
+* Repack wheel archives
+* Add or remove tags in existing wheel archives
 
-#. A setuptools_ extension for building wheels that provides the
-   ``bdist_wheel`` setuptools command
-#. A command line tool for working with wheel files
+Historical note
+---------------
 
-It should be noted that wheel is **not** intended to be used as a library, and
-as such there is no stable, public API.
+This library used to be the reference implementation of the Python wheel packaging
+standard, and a setuptools_ extension containing the ``bdist_wheel`` command. The wheel
+file processing functionality has since been moved to the packaging_ library, and the
+``bdist_wheel`` command has been merged into setuptools itself, leaving this project to
+only contain the command line interface.
 
 .. _PEP 427: https://www.python.org/dev/peps/pep-0427/
+.. _packaging: https://pypi.org/project/packaging/
 .. _setuptools: https://pypi.org/project/setuptools/
 
 Documentation

docs/news.rst

@@ -4,6 +4,7 @@ Release Notes
 **UNRELEASED**
 
 - Canonicalize requirements in METADATA file (PR by Wim Jeantine-Glenn)
+- Added deprecation warnings to all modules not previously prefixed with an underscore
 
 **0.43.0 (2024-03-11)**
 

pyproject.toml

@@ -32,7 +32,7 @@ Changelog = "https://wheel.readthedocs.io/en/stable/news.html"
 Source = "https://github.com/pypa/wheel"
 
 [project.scripts]
-wheel = "wheel.cli:main"
+wheel = "wheel._cli:main"
 
 [project.entry-points."distutils.commands"]
 bdist_wheel = "wheel.bdist_wheel:bdist_wheel"

src/wheel/__main__.py

@@ -14,9 +14,9 @@ def main():  # needed for console script
 
         path = os.path.dirname(os.path.dirname(__file__))
         sys.path[0:0] = [path]
-    import wheel.cli
+    from wheel import _cli
 
-    sys.exit(wheel.cli.main())
+    sys.exit(_cli.main())
 
 
 if __name__ == "__main__":