Recommend build instead of invoking setup.py directly (#439)

pypa · Jan 11, 2022 · ab82cea · ab82cea
1 parent 0e07002
commit ab82cea
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 5 deletions.
diff --git a/docs/quickstart.rst b/docs/quickstart.rst
@@ -1,9 +1,10 @@
 Quickstart
 ==========
 
-To build a wheel for your setuptools based project::
+To build a wheel for your project::
 
-    python setup.py bdist_wheel
+    python -m pip install build
+    python -m build --wheel
 
 The wheel will go to ``dist/yourproject-<tags>.whl``.
 

diff --git a/docs/user_guide.rst b/docs/user_guide.rst
@@ -4,9 +4,10 @@ User Guide
 Building Wheels
 ---------------
 
-Building wheels from a setuptools_ based project is simple::
+To build a wheel for your project::
 
-    python setup.py bdist_wheel
+    python -m pip install build
+    python -m build --wheel
 
 This will build any C extensions in the project and then package those and the
 pure Python code into a ``.whl`` file in the ``dist`` directory.
@@ -20,7 +21,6 @@ adding this to your ``setup.cfg`` file:
     [bdist_wheel]
     universal = 1
 
-.. _setuptools: https://pypi.org/project/setuptools/
 
 Including license files in the generated wheel file
 ---------------------------------------------------