spin 0.13__tar.gz → 0.14__tar.gz

{spin-0.13/spin.egg-info → spin-0.14}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: spin
-Version: 0.13
+Version: 0.14
 Summary: Developer tool for scientific Python libraries
 Maintainer-email: Scientific Python <spin@discuss.scientific-python.org>
 License: BSD 3-Clause License
@@ -41,14 +41,13 @@ 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.8
 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 :: Only
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click
@@ -56,9 +55,10 @@ Requires-Dist: tomli; python_version < "3.11"
 Requires-Dist: colorama; platform_system == "Windows"
 Requires-Dist: importlib_metadata>=7
 Provides-Extra: lint
-Requires-Dist: pre-commit==4.0.1; extra == "lint"
+Requires-Dist: pre-commit==4.2.0; extra == "lint"
 Provides-Extra: dev
 Requires-Dist: changelist==0.5; extra == "dev"
+Dynamic: license-file
 
 # 💫 Scientific Python INcantations (`spin`)
 
@@ -92,6 +92,7 @@ Most of the Meson commands listed below should work "out of the box" for those.
   - [Argument overrides](#argument-overrides)
   - [Advanced: adding arguments to built-in commands](#advanced-adding-arguments-to-built-in-commands)
   - [Advanced: override Meson CLI](#advanced-override-meson-cli)
+- [Auto-completion](#auto-completion)
 - [FAQ](#faq)
 - [For contributors](#for-contributors)
 - [History](#history)
@@ -307,6 +308,28 @@ Meson CLI can be set in `pyproject.toml`:
 cli = 'path/to/custom/meson'
 ```
 
+## Auto-completion
+
+To enable shell auto-completion, first install `spin`, then follow these instructions
+(from the [click documentation](https://click.palletsprojects.com/en/stable/shell-completion/#enabling-completion)).
+The same instructions work for ZSH, just replace "bash" with "zsh".
+
+1. Create a completions file:
+
+```
+_SPIN_COMPLETE=bash_source spin > ~/.spin-complete.bash
+```
+
+Ignore the "need valid configuration" error messages.
+
+2. In your `~/.bashrc`, add:
+
+```
+source ~/.spin-complete.bash
+```
+
+Auto-completions should now work in any spin-enabled project directory.
+
 ## FAQ
 
 - Running `spin`, the emojis in the command list don't show up.

{spin-0.13 → spin-0.14}/README.md

@@ -30,6 +30,7 @@ Most of the Meson commands listed below should work "out of the box" for those.
   - [Argument overrides](#argument-overrides)
   - [Advanced: adding arguments to built-in commands](#advanced-adding-arguments-to-built-in-commands)
   - [Advanced: override Meson CLI](#advanced-override-meson-cli)
+- [Auto-completion](#auto-completion)
 - [FAQ](#faq)
 - [For contributors](#for-contributors)
 - [History](#history)
@@ -245,6 +246,28 @@ Meson CLI can be set in `pyproject.toml`:
 cli = 'path/to/custom/meson'
 ```
 
+## Auto-completion
+
+To enable shell auto-completion, first install `spin`, then follow these instructions
+(from the [click documentation](https://click.palletsprojects.com/en/stable/shell-completion/#enabling-completion)).
+The same instructions work for ZSH, just replace "bash" with "zsh".
+
+1. Create a completions file:
+
+```
+_SPIN_COMPLETE=bash_source spin > ~/.spin-complete.bash
+```
+
+Ignore the "need valid configuration" error messages.
+
+2. In your `~/.bashrc`, add:
+
+```
+source ~/.spin-complete.bash
+```
+
+Auto-completions should now work in any spin-enabled project directory.
+
 ## FAQ
 
 - Running `spin`, the emojis in the command list don't show up.

{spin-0.13 → spin-0.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "spin"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 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.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
@@ -35,7 +34,7 @@ dynamic = ['version']
 spin = "spin.__main__:main"
 
 [project.optional-dependencies]
-lint = ["pre-commit == 4.0.1"]
+lint = ["pre-commit == 4.2.0"]
 dev = ["changelist == 0.5"]
 
 [project.urls]

{spin-0.13 → spin-0.14}/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.13"
+__version__ = "0.14"
 
 from .cmds import util
 

{spin-0.13 → spin-0.14}/spin/__main__.py

@@ -1,11 +1,11 @@
 import collections
 import importlib
 import importlib.util
+import inspect
 import os
 import pathlib
 import sys
 import textwrap
-import traceback
 from typing import Union
 
 import click
@@ -199,20 +199,26 @@ def main():
 
     try:
         group()
-    except Exception:
-        click.secho("\n" + traceback.format_exc(limit=-3), fg="red", file=sys.stderr)
+    except Exception as e:
         click.secho(
             textwrap.dedent(
                 f"""\
-        An internal error has occurred. Please file a bug report at
 
-          https://github.com/scientific-python/spin
+            {type(e).__name__}: {e}
 
-        including the above traceback and the following information:
+            This exception was raised from:
 
-          spin: {__version__}, package: {proj_name}
+              {inspect.trace()[-1].filename}
 
-        Aborting."""
+            If you suspect this is a bug in `spin`, please file a report at:
+
+              https://github.com/scientific-python/spin
+
+            including the above traceback and the following information:
+
+              spin: {__version__}, package: {proj_name}
+
+            Aborting."""
             ),
             fg="red",
             bold=True,

{spin-0.13 → spin-0.14}/spin/cmds/meson.py

@@ -236,6 +236,16 @@ if sys.platform.startswith("win"):
 else:
     DEFAULT_PREFIX = "/usr"
 
+
+build_option = click.option(
+    "--no-build",
+    "build",
+    is_flag=True,
+    callback=lambda ctx, param, value: not value,  # store opposite value in `build` var
+    default=False,
+    help="Disable building before executing command",
+)
+
 build_dir_option = click.option(
     "-C",
     "--build-dir",
@@ -283,13 +293,15 @@ def build(
     quiet=False,
     build_dir=None,
     prefix=None,
+    meson_compile_args=(),
+    meson_install_args=(),
 ):
     """🔧 Build package with Meson/ninja
 
     The package is installed to `build-install` (unless a different
     build directory is specified with `-C`).
 
-    MESON_ARGS are passed through e.g.:
+    MESON_ARGS are passed through to `meson setup` e.g.:
 
       spin build -- -Dpkg_config_path=/lib64/pkgconfig
 
@@ -328,12 +340,14 @@ def build(
             )
         return
 
-    meson_args = list(meson_args)
+    meson_args_setup = list(meson_args)
 
     if gcov:
-        meson_args = meson_args + ["-Db_coverage=true"]
+        meson_args_setup = meson_args_setup + ["-Db_coverage=true"]
 
-    setup_cmd = _meson_cli() + ["setup", build_dir, f"--prefix={prefix}"] + meson_args
+    setup_cmd = (
+        _meson_cli() + ["setup", build_dir, f"--prefix={prefix}"] + meson_args_setup
+    )
 
     if clean:
         print(f"Removing `{build_dir}`")
@@ -365,10 +379,15 @@ def build(
         compile_flags += ["-j", str(jobs)]
 
     p = _run(
-        _meson_cli() + ["compile"] + compile_flags + ["-C", build_dir],
+        _meson_cli()
+        + ["compile"]
+        + compile_flags
+        + ["-C", build_dir]
+        + list(meson_compile_args),
         sys_exit=True,
         output=not quiet,
     )
+
     p = _run(
         _meson_cli()
         + [
@@ -380,7 +399,8 @@ def build(
             install_dir
             if os.path.isabs(install_dir)
             else os.path.relpath(abs_install_dir, abs_build_dir),
-        ],
+        ]
+        + list(meson_install_args),
         output=(not quiet) and verbose,
     )
 
@@ -437,6 +457,7 @@ Which tests to run. Can be a module, function, class, or method:
     default="html",
     help=f"Format of the gcov report. Can be one of {', '.join(e.value for e in GcovReportFormat)}.",
 )
+@build_option
 @build_dir_option
 @click.pass_context
 def test(
@@ -449,6 +470,7 @@ def test(
     coverage=False,
     gcov=None,
     gcov_format=None,
+    build=None,
     build_dir=None,
 ):
     """🔧 Run tests
@@ -531,15 +553,16 @@ def test(
         )
         raise SystemExit(1)
 
-    build_cmd = _get_configured_command("build")
-    if build_cmd:
-        click.secho(
-            "Invoking `build` prior to running tests:", bold=True, fg="bright_green"
-        )
-        if gcov is not None:
-            ctx.invoke(build_cmd, build_dir=build_dir, gcov=bool(gcov))
-        else:
-            ctx.invoke(build_cmd, build_dir=build_dir)
+    if build:
+        build_cmd = _get_configured_command("build")
+        if build_cmd:
+            click.secho(
+                "Invoking `build` prior to running tests:", bold=True, fg="bright_green"
+            )
+            if gcov is not None:
+                ctx.invoke(build_cmd, build_dir=build_dir, gcov=bool(gcov))
+            else:
+                ctx.invoke(build_cmd, build_dir=build_dir)
 
     site_path = _set_pythonpath(build_dir)
 
@@ -637,9 +660,10 @@ def test(
     "--code", "-c", metavar="CODE", help="Python program passed in as a string"
 )
 @click.argument("gdb_args", nargs=-1)
+@build_option
 @build_dir_option
 @click.pass_context
-def gdb(ctx, *, code, gdb_args, build_dir):
+def gdb(ctx, *, code, gdb_args, build=None, build_dir=None):
     """👾 Execute code through GDB
 
       spin gdb -c 'import numpy as np; print(np.__version__)'
@@ -660,12 +684,13 @@ def gdb(ctx, *, code, gdb_args, build_dir):
      spin gdb my_tests.py
      spin gdb -- my_tests.py --mytest-flag
     """
-    build_cmd = _get_configured_command("build")
-    if build_cmd:
-        click.secho(
-            "Invoking `build` prior to invoking gdb:", bold=True, fg="bright_green"
-        )
-        ctx.invoke(build_cmd, build_dir=build_dir)
+    if build:
+        build_cmd = _get_configured_command("build")
+        if build_cmd:
+            click.secho(
+                "Invoking `build` prior to invoking gdb:", bold=True, fg="bright_green"
+            )
+            ctx.invoke(build_cmd, build_dir=build_dir)
 
     _set_pythonpath(build_dir)
     gdb_args = list(gdb_args)
@@ -690,21 +715,25 @@ def gdb(ctx, *, code, gdb_args, build_dir):
 
 @click.command()
 @click.argument("ipython_args", nargs=-1)
+@build_option
 @build_dir_option
 @click.pass_context
-def ipython(ctx, *, ipython_args, build_dir, pre_import=""):
+def ipython(ctx, *, ipython_args, build=None, build_dir=None, pre_import=""):
     """💻 Launch IPython shell with PYTHONPATH set
 
     IPYTHON_ARGS are passed through directly to IPython, e.g.:
 
     spin ipython -- -i myscript.py
     """
-    build_cmd = _get_configured_command("build")
-    if build_cmd:
-        click.secho(
-            "Invoking `build` prior to launching ipython:", bold=True, fg="bright_green"
-        )
-        ctx.invoke(build_cmd, build_dir=build_dir)
+    if build:
+        build_cmd = _get_configured_command("build")
+        if build_cmd:
+            click.secho(
+                "Invoking `build` prior to launching ipython:",
+                bold=True,
+                fg="bright_green",
+            )
+            ctx.invoke(build_cmd, build_dir=build_dir)
 
     p = _set_pythonpath(build_dir)
     if p:
@@ -716,9 +745,10 @@ def ipython(ctx, *, ipython_args, build_dir, pre_import=""):
 
 @click.command()
 @click.argument("shell_args", nargs=-1)
+@build_option
 @build_dir_option
 @click.pass_context
-def shell(ctx, shell_args=[], build_dir=None):
+def shell(ctx, shell_args=[], build=None, build_dir=None):
     """💻 Launch shell with PYTHONPATH set
 
     SHELL_ARGS are passed through directly to the shell, e.g.:
@@ -728,12 +758,15 @@ def shell(ctx, shell_args=[], build_dir=None):
     Ensure that your shell init file (e.g., ~/.zshrc) does not override
     the PYTHONPATH.
     """
-    build_cmd = _get_configured_command("build")
-    if build_cmd:
-        click.secho(
-            "Invoking `build` prior to invoking shell:", bold=True, fg="bright_green"
-        )
-        ctx.invoke(build_cmd, build_dir=build_dir)
+    if build:
+        build_cmd = _get_configured_command("build")
+        if build_cmd:
+            click.secho(
+                "Invoking `build` prior to invoking shell:",
+                bold=True,
+                fg="bright_green",
+            )
+            ctx.invoke(build_cmd, build_dir=build_dir)
 
     p = _set_pythonpath(build_dir)
     if p:
@@ -748,21 +781,25 @@ def shell(ctx, shell_args=[], build_dir=None):
 
 @click.command()
 @click.argument("python_args", nargs=-1)
+@build_option
 @build_dir_option
 @click.pass_context
-def python(ctx, *, python_args, build_dir):
+def python(ctx, *, python_args, build=None, build_dir=None):
     """🐍 Launch Python shell with PYTHONPATH set
 
     PYTHON_ARGS are passed through directly to Python, e.g.:
 
     spin python -- -c 'import sys; print(sys.path)'
     """
-    build_cmd = _get_configured_command("build")
-    if build_cmd:
-        click.secho(
-            "Invoking `build` prior to invoking Python:", bold=True, fg="bright_green"
-        )
-        ctx.invoke(build_cmd, build_dir=build_dir)
+    if build:
+        build_cmd = _get_configured_command("build")
+        if build_cmd:
+            click.secho(
+                "Invoking `build` prior to invoking Python:",
+                bold=True,
+                fg="bright_green",
+            )
+            ctx.invoke(build_cmd, build_dir=build_dir)
 
     p = _set_pythonpath(build_dir)
     if p:
@@ -789,10 +826,11 @@ def python(ctx, *, python_args, build_dir):
 
 
 @click.command(context_settings={"ignore_unknown_options": True})
+@build_option
 @build_dir_option
 @click.argument("args", nargs=-1)
 @click.pass_context
-def run(ctx, *, args, build_dir=None):
+def run(ctx, *, args, build=None, build_dir=None):
     """🏁 Run a shell command with PYTHONPATH set
 
     \b
@@ -811,12 +849,13 @@ def run(ctx, *, args, build_dir=None):
     if not len(args) > 0:
         raise RuntimeError("No command given")
 
-    build_cmd = _get_configured_command("build")
-    if build_cmd:
-        # Redirect spin generated output
-        with contextlib.redirect_stdout(sys.stderr):
-            # Also ask build to be quiet
-            ctx.invoke(build_cmd, build_dir=build_dir, quiet=True)
+    if build:
+        build_cmd = _get_configured_command("build")
+        if build_cmd:
+            # Redirect spin generated output
+            with contextlib.redirect_stdout(sys.stderr):
+                # Also ask build to be quiet
+                ctx.invoke(build_cmd, build_dir=build_dir, quiet=True)
 
     is_posix = sys.platform in ("linux", "darwin")
     shell = len(args) == 1
@@ -872,12 +911,6 @@ def run(ctx, *, args, build_dir=None):
     default=False,
     help="Clean previously built docs before building",
 )
-@click.option(
-    "--build/--no-build",
-    "first_build",
-    default=True,
-    help="Build project before generating docs",
-)
 @click.option(
     "--plot/--no-plot",
     "sphinx_gallery_plot",
@@ -891,6 +924,7 @@ def run(ctx, *, args, build_dir=None):
     metavar="N_JOBS",
     help="Number of parallel build jobs",
 )
+@build_option
 @build_dir_option
 @click.pass_context
 def docs(
@@ -898,10 +932,10 @@ def docs(
     *,
     sphinx_target,
     clean,
-    first_build,
     jobs,
     sphinx_gallery_plot,
     clean_dirs=None,
+    build=None,
     build_dir=None,
 ):
     """📖 Build Sphinx documentation
@@ -931,7 +965,7 @@ def docs(
 
     if sphinx_target in ("targets", "help"):
         clean = False
-        first_build = False
+        build = False
         sphinx_target = "help"
 
     if clean:
@@ -953,7 +987,7 @@ def docs(
 
     build_cmd = _get_configured_command("build")
 
-    if build_cmd and first_build:
+    if build_cmd and build:
         click.secho(
             "Invoking `build` prior to building docs:", bold=True, fg="bright_green"
         )
@@ -979,7 +1013,7 @@ def docs(
 
     if site_path:
         os.environ["PYTHONPATH"] = (
-            f'{site_path}{os.sep}:{os.environ.get("PYTHONPATH", "")}'
+            f"{site_path}{os.sep}:{os.environ.get('PYTHONPATH', '')}"
         )
         click.secho(
             f"$ export PYTHONPATH={os.environ['PYTHONPATH']}",
@@ -997,9 +1031,10 @@ def docs(
     "--code", "-c", metavar="CODE", help="Python program passed in as a string"
 )
 @click.argument("lldb_args", nargs=-1)
+@build_option
 @build_dir_option
 @click.pass_context
-def lldb(ctx, *, code, lldb_args, build_dir=None):
+def lldb(ctx, *, code, lldb_args, build=None, build_dir=None):
     """👾 Execute code through LLDB
 
       spin lldb -c 'import numpy as np; print(np.__version__)'
@@ -1022,12 +1057,13 @@ def lldb(ctx, *, code, lldb_args, build_dir=None):
      spin lldb -- --arch x86_64 -- my_tests.py
      spin lldb -c 'import numpy as np; print(np.__version__)' -- --arch x86_64
     """
-    build_cmd = _get_configured_command("build")
-    if build_cmd:
-        click.secho(
-            "Invoking `build` prior to invoking lldb:", bold=True, fg="bright_green"
-        )
-        ctx.invoke(build_cmd, build_dir=build_dir)
+    if build:
+        build_cmd = _get_configured_command("build")
+        if build_cmd:
+            click.secho(
+                "Invoking `build` prior to invoking lldb:", bold=True, fg="bright_green"
+            )
+            ctx.invoke(build_cmd, build_dir=build_dir)
 
     _set_pythonpath(build_dir)
     lldb_args = list(lldb_args)

{spin-0.13 → spin-0.14}/spin/cmds/util.py

@@ -1,10 +1,11 @@
 from __future__ import (
-    annotations,  # noqa: F401  # TODO: remove once only >3.8 is supported
+    annotations,  # noqa: F401  # TODO: remove once only >3.14 is supported
 )
 
 import copy
 import os
 import shlex
+import shutil
 import subprocess
 import sys
 from collections.abc import Callable
@@ -65,8 +66,15 @@ def run(
         kwargs = {**output_kwargs, **kwargs}
 
     if replace and (sys.platform in ("linux", "darwin")):
+        if not shutil.which(cmd[0]):
+            click.secho(
+                f"`{cmd[0]}` executable not found; exiting.",
+                fg="bright_red",
+            )
+            raise SystemExit(1) from None
+
         os.execvp(cmd[0], cmd)
-        print(f"Failed to launch `{cmd}`")
+        print(f"Failed to launch `{cmd}`; exiting.")
         sys.exit(-1)
     else:
         try:

{spin-0.13 → spin-0.14}/spin/tests/test_build_cmds.py

@@ -14,6 +14,7 @@ from .testutil import (
     skip_unless_linux,
     skip_unless_macos,
     spin,
+    stderr,
     stdout,
 )
 
@@ -23,9 +24,9 @@ def test_basic_build(example_pkg):
     spin("build")
 
     assert Path("build").exists(), "`build` folder not created after `spin build`"
-    assert Path(
-        "build-install"
-    ).exists(), "`build-install` folder not created after `spin build`"
+    assert Path("build-install").exists(), (
+        "`build-install` folder not created after `spin build`"
+    )
 
 
 def test_debug_builds(example_pkg):
@@ -64,17 +65,17 @@ def test_coverage_reports(example_pkg, report_type, output_file):
     spin("test", "--gcov", f"--gcov-format={report_type}")
 
     coverage_report = Path("./build/meson-logs", output_file)
-    assert (
-        coverage_report.exists()
-    ), f"coverage report not generated for gcov build ({report_type})"
+    assert coverage_report.exists(), (
+        f"coverage report not generated for gcov build ({report_type})"
+    )
 
 
 def test_expand_pythonpath(example_pkg):
     """Does an $ENV_VAR get expanded in `spin run`?"""
     output = spin("run", "echo $PYTHONPATH")
-    assert any(
-        p in stdout(output) for p in ("site-packages", "dist-packages")
-    ), f"Expected value of $PYTHONPATH, got {stdout(output)} instead"
+    assert any(p in stdout(output) for p in ("site-packages", "dist-packages")), (
+        f"Expected value of $PYTHONPATH, got {stdout(output)} instead"
+    )
 
 
 def test_run_stdout(example_pkg):
@@ -85,9 +86,18 @@ def test_run_stdout(example_pkg):
         "-c",
         "import sys; del sys.path[0]; import example_pkg; print(example_pkg.__version__)",
     )
-    assert (
-        stdout(p) == "0.0.0dev0"
-    ), f"`spin run` stdout did not yield version, but {stdout(p)}"
+    assert stdout(p) == "0.0.0dev0", (
+        f"`spin run` stdout did not yield version, but {stdout(p)}"
+    )
+
+
+def test_run_no_build(example_pkg):
+    """Does spin run ... --no-build correctly avoid building."""
+    output = stderr(spin("run", "echo $PYTHONPATH"))
+    assert "meson compile" in output
+
+    output = stderr(spin("run", "--no-build", "echo $PYTHONPATH"))
+    assert "meson compile" not in output
 
 
 # Detecting whether a file is executable is not that easy on Windows,
@@ -97,9 +107,9 @@ def test_recommend_run_python(example_pkg):
     """If `spin run file.py` is called, is `spin run python file.py` recommended?"""
     with tempfile.NamedTemporaryFile(suffix=".py") as f:
         p = spin("run", f.name, sys_exit=False)
-        assert "Did you mean to call" in stdout(
-            p
-        ), "Failed to recommend `python run python file.py`"
+        assert "Did you mean to call" in stdout(p), (
+            "Failed to recommend `python run python file.py`"
+        )
 
 
 def test_sdist(example_pkg):

{spin-0.13 → spin-0.14}/spin/tests/test_editable.py

@@ -2,9 +2,9 @@ from .testutil import spin, stdout
 
 
 def test_detect_editable(example_pkg, editable_install):
-    assert "Editable install of same source detected" in stdout(
-        spin("build")
-    ), "Failed to detect and warn about editable install"
+    assert "Editable install of same source detected" in stdout(spin("build")), (
+        "Failed to detect and warn about editable install"
+    )
 
 
 def test_editable_tests(example_pkg, editable_install):

{spin-0.13 → spin-0.14/spin.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: spin
-Version: 0.13
+Version: 0.14
 Summary: Developer tool for scientific Python libraries
 Maintainer-email: Scientific Python <spin@discuss.scientific-python.org>
 License: BSD 3-Clause License
@@ -41,14 +41,13 @@ 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.8
 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 :: Only
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click
@@ -56,9 +55,10 @@ Requires-Dist: tomli; python_version < "3.11"
 Requires-Dist: colorama; platform_system == "Windows"
 Requires-Dist: importlib_metadata>=7
 Provides-Extra: lint
-Requires-Dist: pre-commit==4.0.1; extra == "lint"
+Requires-Dist: pre-commit==4.2.0; extra == "lint"
 Provides-Extra: dev
 Requires-Dist: changelist==0.5; extra == "dev"
+Dynamic: license-file
 
 # 💫 Scientific Python INcantations (`spin`)
 
@@ -92,6 +92,7 @@ Most of the Meson commands listed below should work "out of the box" for those.
   - [Argument overrides](#argument-overrides)
   - [Advanced: adding arguments to built-in commands](#advanced-adding-arguments-to-built-in-commands)
   - [Advanced: override Meson CLI](#advanced-override-meson-cli)
+- [Auto-completion](#auto-completion)
 - [FAQ](#faq)
 - [For contributors](#for-contributors)
 - [History](#history)
@@ -307,6 +308,28 @@ Meson CLI can be set in `pyproject.toml`:
 cli = 'path/to/custom/meson'
 ```
 
+## Auto-completion
+
+To enable shell auto-completion, first install `spin`, then follow these instructions
+(from the [click documentation](https://click.palletsprojects.com/en/stable/shell-completion/#enabling-completion)).
+The same instructions work for ZSH, just replace "bash" with "zsh".
+
+1. Create a completions file:
+
+```
+_SPIN_COMPLETE=bash_source spin > ~/.spin-complete.bash
+```
+
+Ignore the "need valid configuration" error messages.
+
+2. In your `~/.bashrc`, add:
+
+```
+source ~/.spin-complete.bash
+```
+
+Auto-completions should now work in any spin-enabled project directory.
+
 ## FAQ
 
 - Running `spin`, the emojis in the command list don't show up.

{spin-0.13 → spin-0.14}/spin.egg-info/requires.txt

@@ -11,4 +11,4 @@ tomli
 changelist==0.5
 
 [lint]
-pre-commit==4.0.1
+pre-commit==4.2.0