Add machinery to generate test-only wheels.

anntzer · SidharthBansal · commit 781c5405dfe2 · 2020-05-18T00:18:08.000+05:30
Generate a matplotlib.tests wheel that can be uploaded to PyPI as a
separate PyPI package ("distribution", in distutils parlance), to make
it possible to install tests and test data from PyPI.

This is useful e.g. for mplcairo, whose test suite relies on
matplotlib's one.
diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst
@@ -277,6 +277,10 @@ day), generate the tarball ::
   git checkout v2.0.0
   git clean -xfd
   python setup.py sdist
+  # Generate test-only wheels.
+  for dir in sub-wheels/*; do
+    (cd "$dir" && python setup.py bdist_wheel)
+  done
 
 and copy all of the wheels into :file:`dist` directory.  First, check
 that the dist files are OK ::
diff --git a/sub-wheels/matplotlib.tests/README.rst b/sub-wheels/matplotlib.tests/README.rst
@@ -0,0 +1,12 @@
+Running ``python setup.py bdist_wheel`` (*not* ``pip wheel .``) generates a
+wheel for a ``matplotlib.tests`` distribution (in the distutils sense, i.e.
+a PyPI package) that can be installed alongside a main, test-less Matplotlib
+distribution.
+
+Note that
+
+- ``pip wheel`` doesn't work as that starts by copying the *current* directory
+  to a temporary one (for isolation purposes), before we get to ``chdir`` back
+  to the root directory.
+- ``python setup.py sdist`` doesn't work as that would pick up the
+  ``MANIFEST.in`` file in the root directory.
diff --git a/sub-wheels/matplotlib.tests/setup.py b/sub-wheels/matplotlib.tests/setup.py
@@ -0,0 +1,27 @@
+import os
+from pathlib import Path
+import sys
+
+
+rootdir = str(Path(__file__).resolve().parents[2])
+sys.path.insert(0, rootdir)
+os.chdir(rootdir)
+
+
+from setuptools import setup, find_packages
+import versioneer
+
+
+__version__ = versioneer.get_version()
+
+
+if "sdist" in sys.argv:
+    sys.exit("Only wheels can be generated.")
+setup(
+    name="matplotlib.tests",
+    version=__version__,
+    package_dir={"": "lib"},
+    packages=find_packages("lib", include=["*.tests"]),
+    include_package_data=True,
+    install_requires=["matplotlib=={}".format(__version__)]
+)
