spin 0.15__tar.gz → 0.16__tar.gz

{spin-0.15/spin.egg-info → spin-0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spin
-Version: 0.15
+Version: 0.16
 Summary: Developer tool for scientific Python libraries
 Maintainer-email: Scientific Python <spin@discuss.scientific-python.org>
 License: BSD 3-Clause License
@@ -41,17 +41,17 @@ Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: click<8.3,>=8
+Requires-Dist: click<=8.2,>=8; python_version == "3.10"
+Requires-Dist: click!=8.3.0,<8.4,>=8
 Requires-Dist: tomli; python_version < "3.11"
 Requires-Dist: colorama; platform_system == "Windows"
 Requires-Dist: importlib_metadata>=7
@@ -189,6 +189,7 @@ Available as `spin.cmds.build.*`:
 
 ```
 sdist      📦 Build a source distribution in `dist/`
+wheel      📦 Build a wheel distribution in `dist/`
 ```
 
 ### [pip](https://pip.pypa.io) (Package Installer for Python)
@@ -359,6 +360,9 @@ nox -s test -- -v
 nox -s test -- -v spin/tests/test_meson.py
 ```
 
+`spin` takes a slightly more conservative approach than [SPEC 0](https://scientific-python.org/specs/spec-0000/), and
+supports all non-EOL versions of Python.
+
 ## History
 
 The `dev.py` tool was [proposed for SciPy](https://github.com/scipy/scipy/issues/15489) by Ralf Gommers and [implemented](https://github.com/scipy/scipy/pull/15959) by Sayantika Banik, Eduardo Naufel Schettino, and Ralf Gommers (also see [Sayantika's blog post](https://labs.quansight.org/blog/the-evolution-of-the-scipy-developer-cli)).

{spin-0.15 → spin-0.16}/README.md

@@ -126,6 +126,7 @@ Available as `spin.cmds.build.*`:
 
 ```
 sdist      📦 Build a source distribution in `dist/`
+wheel      📦 Build a wheel distribution in `dist/`
 ```
 
 ### [pip](https://pip.pypa.io) (Package Installer for Python)
@@ -296,6 +297,9 @@ nox -s test -- -v
 nox -s test -- -v spin/tests/test_meson.py
 ```
 
+`spin` takes a slightly more conservative approach than [SPEC 0](https://scientific-python.org/specs/spec-0000/), and
+supports all non-EOL versions of Python.
+
 ## History
 
 The `dev.py` tool was [proposed for SciPy](https://github.com/scipy/scipy/issues/15489) by Ralf Gommers and [implemented](https://github.com/scipy/scipy/pull/15959) by Sayantika Banik, Eduardo Naufel Schettino, and Ralf Gommers (also see [Sayantika's blog post](https://labs.quansight.org/blog/the-evolution-of-the-scipy-developer-cli)).

{spin-0.15 → spin-0.16}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "spin"
-requires-python = ">=3.9"
+requires-python = ">=3.10"  # Oldest non-EOL Python here
 description = "Developer tool for scientific Python libraries"
 readme = "README.md"
 license = {file = "LICENSE"}
@@ -15,7 +15,6 @@ classifiers = [
   "License :: OSI Approved :: BSD License",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
@@ -24,7 +23,8 @@ classifiers = [
   "Programming Language :: Python :: 3 :: Only",
 ]
 dependencies = [
-  "click>=8,<8.3",
+  "click>=8,<=8.2; python_version == '3.10'",  # cannot deepcopy cmd params (specifically, Sentinel.UNSET) on 3.10
+  "click>=8,!=8.3.0,<8.4",
   "tomli; python_version < '3.11'",
   "colorama; platform_system == 'Windows'",
   "importlib_metadata >= 7"

{spin-0.15 → spin-0.16}/spin/__init__.py

@@ -6,7 +6,7 @@ For usage information see `python -m spin`.
 Read more at https://github.com/scientific-python/spin
 """
 
-__version__ = "0.15"
+__version__ = "0.16"
 
 from .cmds import util
 

{spin-0.15 → spin-0.16}/spin/__main__.py

@@ -6,7 +6,6 @@ import pathlib
 import sys
 import textwrap
 import traceback
-from typing import Union
 
 import click
 
@@ -31,7 +30,7 @@ config_filenames = (
 )
 
 
-def _detect_config_dir(path: pathlib.Path) -> Union[pathlib.Path, None]:
+def _detect_config_dir(path: pathlib.Path) -> pathlib.Path | None:
     path = path.resolve()
     files = os.listdir(path)
     if any(f in files for f in config_filenames):

{spin-0.15 → spin-0.16}/spin/cmds/build.py

@@ -13,3 +13,15 @@ def sdist(pyproject_build_args):
       spin sdist -- -x -n
     """
     run(["pyproject-build", ".", "--sdist"] + list(pyproject_build_args))
+
+
+@click.command()
+@click.argument("pyproject-build-args", metavar="", nargs=-1)
+def wheel(pyproject_build_args):
+    """📦 Build a wheel distribution in `dist/`
+
+    Extra arguments are passed to `pyproject-build`, e.g.
+
+      spin wheel -- -x -n
+    """
+    run(["pyproject-build", ".", "--wheel"] + list(pyproject_build_args))

{spin-0.15 → spin-0.16}/spin/cmds/meson.py

@@ -8,7 +8,6 @@ import signal
 import sys
 from enum import Enum
 from pathlib import Path
-from typing import Union
 
 import click
 
@@ -36,7 +35,7 @@ def _meson_cli():
         return [meson_cli]
 
 
-def editable_install_path(distname: str) -> Union[str, None]:
+def editable_install_path(distname: str) -> str | None:
     """Return path of the editable install for package `distname`.
 
     If the package is not an editable install, return None.
@@ -191,7 +190,7 @@ def _get_site_packages(build_dir: str) -> str:
     return site_packages
 
 
-def _meson_version() -> Union[str, None]:
+def _meson_version() -> str | None:
     try:
         p = _run(_meson_cli() + ["--version"], output=False, echo=False)
         return p.stdout.decode("ascii").strip()
@@ -199,7 +198,7 @@ def _meson_version() -> Union[str, None]:
         return None
 
 
-def _meson_version_configured(build_dir: str) -> Union[str, None]:
+def _meson_version_configured(build_dir: str) -> str | None:
     try:
         meson_info_fn = os.path.join(build_dir, "meson-info", "meson-info.json")
         with open(meson_info_fn) as f:
@@ -445,7 +444,7 @@ def _get_configured_command(command_name):
     metavar="N_JOBS",
     default="1",
     help=(
-        "Number of parallel jobs for testing. Can be set to `auto` to use all cores."
+        "Number of parallel jobs for testing with pytest-xdist. Can be set to `auto` to use all cores."
     ),
 )
 @click.option(

{spin-0.15 → spin-0.16}/spin/cmds/util.py

@@ -127,7 +127,14 @@ def extend_command(
         Command to extend.
     doc : str
         Replacement docstring.
-        The wrapped function's docstring is also appended.
+        The decorated function's docstring is also appended.
+        This is done so that two modes of documenting are enabled:
+
+        1. Extend original command documentation.
+           Do this by providing a docstring on the decorated function.
+        2. Replace the original command's documentation.
+           Do this either by setting ``doc`` to a docstring, or by
+           setting ``doc=''`` and adding a docstring to the decorated function.
     remove_args : tuple of str
         List of arguments to remove from the parent command.
         These arguments can still be set explicitly by calling

{spin-0.15 → spin-0.16}/spin/tests/test_build_cmds.py

@@ -2,7 +2,7 @@ import os
 import subprocess
 import sys
 import tempfile
-from pathlib import Path
+from pathlib import Path, PureWindowsPath
 
 import pytest
 
@@ -19,6 +19,10 @@ from .testutil import (
 )
 
 
+def unix_path(p: str) -> str:
+    return PureWindowsPath(p).as_posix()
+
+
 def test_basic_build(example_pkg):
     """Does the package build?"""
     spin("build")
@@ -39,7 +43,7 @@ def test_debug_builds(example_pkg):
 
 def test_prefix_builds(example_pkg):
     """does spin build --prefix create a build-install directory with the correct structure?"""
-    spin("build", "--prefix=/foobar/")
+    spin("build", f"--prefix={os.path.abspath('/foobar')}")
     assert (Path("build-install") / Path("foobar")).exists()
 
 
@@ -116,6 +120,12 @@ def test_sdist(example_pkg):
     spin("sdist")
 
 
+def test_wheel(example_pkg):
+    spin("wheel")
+    wheel_file_list = list(Path("dist").glob("example_pkg-0.0.dev0-*.whl"))
+    assert len(wheel_file_list) == 1, "Wheel file not created in dist/"
+
+
 def test_example(example_pkg):
     spin("example")
 
@@ -178,7 +188,7 @@ def test_parallel_builds(example_pkg):
     spin("build")
     spin("build", "-C", "parallel/build")
     p = spin("python", "--", "-c", "import example_pkg; print(example_pkg.__file__)")
-    example_pkg_path = stdout(p).split("\n")[-1]
+    example_pkg_path = unix_path(stdout(p).split("\n")[-1])
     p = spin(
         "python",
         "-C",
@@ -187,7 +197,7 @@ def test_parallel_builds(example_pkg):
         "-c",
         "import example_pkg; print(example_pkg.__file__)",
     )
-    example_pkg_parallel_path = stdout(p).split("\n")[-1]
+    example_pkg_parallel_path = unix_path(stdout(p).split("\n")[-1])
     assert "build-install" in example_pkg_path
     assert "parallel/build-install" in example_pkg_parallel_path
     assert "parallel/build-install" not in example_pkg_path

{spin-0.15 → spin-0.16}/spin/tests/testutil.py

@@ -24,12 +24,21 @@ skip_py_lt_311 = pytest.mark.skipif(
 
 def spin(*args, **user_kwargs):
     args = (str(el) for el in args)
+    # Capture stdout, stderr separately
     default_kwargs = {
         "stdout": subprocess.PIPE,
         "stderr": subprocess.PIPE,
-        "sys_exit": True,
+        "sys_exit": False,
     }
-    return run(["spin"] + list(args), **{**default_kwargs, **user_kwargs})
+    p = run(["spin"] + list(args), **{**default_kwargs, **user_kwargs})
+    if p.returncode != 0:
+        print(p.stdout.decode("utf-8"), end="")
+        print(p.stderr.decode("utf-8"), end="")
+        # Exit unless the spin call explicitly asks us not to
+        # by setting sys_exit=False
+        if user_kwargs.get("sys_exit", True):
+            sys.exit(p.returncode)
+    return p
 
 
 def stdout(p):

{spin-0.15 → spin-0.16/spin.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spin
-Version: 0.15
+Version: 0.16
 Summary: Developer tool for scientific Python libraries
 Maintainer-email: Scientific Python <spin@discuss.scientific-python.org>
 License: BSD 3-Clause License
@@ -41,17 +41,17 @@ Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: click<8.3,>=8
+Requires-Dist: click<=8.2,>=8; python_version == "3.10"
+Requires-Dist: click!=8.3.0,<8.4,>=8
 Requires-Dist: tomli; python_version < "3.11"
 Requires-Dist: colorama; platform_system == "Windows"
 Requires-Dist: importlib_metadata>=7
@@ -189,6 +189,7 @@ Available as `spin.cmds.build.*`:
 
 ```
 sdist      📦 Build a source distribution in `dist/`
+wheel      📦 Build a wheel distribution in `dist/`
 ```
 
 ### [pip](https://pip.pypa.io) (Package Installer for Python)
@@ -359,6 +360,9 @@ nox -s test -- -v
 nox -s test -- -v spin/tests/test_meson.py
 ```
 
+`spin` takes a slightly more conservative approach than [SPEC 0](https://scientific-python.org/specs/spec-0000/), and
+supports all non-EOL versions of Python.
+
 ## History
 
 The `dev.py` tool was [proposed for SciPy](https://github.com/scipy/scipy/issues/15489) by Ralf Gommers and [implemented](https://github.com/scipy/scipy/pull/15959) by Sayantika Banik, Eduardo Naufel Schettino, and Ralf Gommers (also see [Sayantika's blog post](https://labs.quansight.org/blog/the-evolution-of-the-scipy-developer-cli)).

{spin-0.15 → spin-0.16}/spin.egg-info/requires.txt

@@ -1,4 +1,4 @@
-click<8.3,>=8
+click!=8.3.0,<8.4,>=8
 importlib_metadata>=7
 
 [:platform_system == "Windows"]
@@ -7,6 +7,9 @@ colorama
 [:python_version < "3.11"]
 tomli
 
+[:python_version == "3.10"]
+click<=8.2,>=8
+
 [dev]
 changelist==0.5