duty 1.4.1__tar.gz → 1.4.3__tar.gz

{duty-1.4.1 → duty-1.4.3}/CHANGELOG.md

@@ -5,6 +5,22 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 <!-- insertion marker -->
+## [1.4.3](https://github.com/pawamoy/duty/releases/tag/1.4.3) - 2024-10-17
+
+<small>[Compare with 1.4.2](https://github.com/pawamoy/duty/compare/1.4.2...1.4.3)</small>
+
+### Build
+
+- Drop support for Python 3.8 ([4f5d6ec](https://github.com/pawamoy/duty/commit/4f5d6ecbb0a84e5c42cab4d584239f16e8397d86) by Timothée Mazzucotelli).
+
+## [1.4.2](https://github.com/pawamoy/duty/releases/tag/1.4.2) - 2024-09-10
+
+<small>[Compare with 1.4.1](https://github.com/pawamoy/duty/compare/1.4.1...1.4.2)</small>
+
+### Bug Fixes
+
+- Add missing (new) `check_only` argument to blacken-docs ([1a6dc99](https://github.com/pawamoy/duty/commit/1a6dc995dc0caa47d8734a9feb54eb766652cadc) by Timothée Mazzucotelli). [Issue-22](https://github.com/pawamoy/duty/issues/22)
+
 ## [1.4.1](https://github.com/pawamoy/duty/releases/tag/1.4.1) - 2024-08-15
 
 <small>[Compare with 1.4.0](https://github.com/pawamoy/duty/compare/1.4.0...1.4.1)</small>

{duty-1.4.1 → duty-1.4.3}/CONTRIBUTING.md

@@ -23,12 +23,11 @@ make setup
 > You can install it with:
 >
 > ```bash
-> python3 -m pip install --user pipx
-> pipx install uv
+> curl -LsSf https://astral.sh/uv/install.sh | sh
 > ```
 >
 > Now you can try running `make setup` again,
-> or simply `uv install`.
+> or simply `uv sync`.
 
 You now have the dependencies installed.
 

{duty-1.4.1 → duty-1.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: duty
-Version: 1.4.1
+Version: 1.4.3
 Summary: A simple task runner.
 Keywords: task-runner,task,runner,cross-platform
 Author-Email: =?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>
@@ -10,12 +10,12 @@ Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-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.14
 Classifier: Topic :: Documentation
 Classifier: Topic :: Software Development
 Classifier: Topic :: Utilities
@@ -28,7 +28,7 @@ Project-URL: Issues, https://github.com/pawamoy/duty/issues
 Project-URL: Discussions, https://github.com/pawamoy/duty/discussions
 Project-URL: Gitter, https://gitter.im/duty/community
 Project-URL: Funding, https://github.com/sponsors/pawamoy
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Requires-Dist: eval-type-backport; python_version < "3.10"
 Requires-Dist: failprint!=1.0.0,>=0.11
 Requires-Dist: typing-extensions>=4.0; python_version < "3.11"
@@ -39,7 +39,6 @@ Description-Content-Type: text/markdown
 [![ci](https://github.com/pawamoy/duty/workflows/ci/badge.svg)](https://github.com/pawamoy/duty/actions?query=workflow%3Aci)
 [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/duty/)
 [![pypi version](https://img.shields.io/pypi/v/duty.svg)](https://pypi.org/project/duty/)
-[![gitpod](https://img.shields.io/badge/gitpod-workspace-708FCC.svg?style=flat)](https://gitpod.io/#https://github.com/pawamoy/duty)
 [![gitter](https://badges.gitter.im/join%20chat.svg)](https://app.gitter.im/#/room/#duty:gitter.im)
 
 A simple task runner.
@@ -50,17 +49,14 @@ Inspired by [Invoke](https://github.com/pyinvoke/invoke).
 
 ## Installation
 
-With `pip`:
-
 ```bash
 pip install duty
 ```
 
-With [`pipx`](https://github.com/pipxproject/pipx):
+With [`uv`](https://docs.astral.sh/uv/):
 
 ```bash
-python3.8 -m pip install --user pipx
-pipx install duty
+uv tool install duty
 ```
 
 ## Quick start

{duty-1.4.1 → duty-1.4.3}/README.md

@@ -3,7 +3,6 @@
 [![ci](https://github.com/pawamoy/duty/workflows/ci/badge.svg)](https://github.com/pawamoy/duty/actions?query=workflow%3Aci)
 [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/duty/)
 [![pypi version](https://img.shields.io/pypi/v/duty.svg)](https://pypi.org/project/duty/)
-[![gitpod](https://img.shields.io/badge/gitpod-workspace-708FCC.svg?style=flat)](https://gitpod.io/#https://github.com/pawamoy/duty)
 [![gitter](https://badges.gitter.im/join%20chat.svg)](https://app.gitter.im/#/room/#duty:gitter.im)
 
 A simple task runner.
@@ -14,17 +13,14 @@ Inspired by [Invoke](https://github.com/pyinvoke/invoke).
 
 ## Installation
 
-With `pip`:
-
 ```bash
 pip install duty
 ```
 
-With [`pipx`](https://github.com/pipxproject/pipx):
+With [`uv`](https://docs.astral.sh/uv/):
 
 ```bash
-python3.8 -m pip install --user pipx
-pipx install duty
+uv tool install duty
 ```
 
 ## Quick start

{duty-1.4.1 → duty-1.4.3}/config/ruff.toml

@@ -1,4 +1,4 @@
-target-version = "py38"
+target-version = "py39"
 line-length = 120
 
 [lint]

{duty-1.4.1 → duty-1.4.3}/duties.py

@@ -7,11 +7,13 @@ import sys
 from contextlib import contextmanager
 from importlib.metadata import version as pkgversion
 from pathlib import Path
-from typing import TYPE_CHECKING, Iterator
+from typing import TYPE_CHECKING
 
 from duty import duty, tools
 
 if TYPE_CHECKING:
+    from collections.abc import Iterator
+
     from duty.context import Context
 
 
@@ -53,8 +55,8 @@ def changelog(ctx: Context, bump: str = "") -> None:
     ctx.run(tools.git_changelog(bump=bump or None), title="Updating changelog")
 
 
-@duty(pre=["check_quality", "check_types", "check_docs", "check_dependencies", "check-api"])
-def check(ctx: Context) -> None:  # noqa: ARG001
+@duty(pre=["check-quality", "check-types", "check-docs", "check-api"])
+def check(ctx: Context) -> None:
     """Check it all!"""
 
 

{duty-1.4.1 → duty-1.4.3}/mkdocs.yml

@@ -129,13 +129,15 @@ plugins:
           show_root_heading: true
           show_root_full_path: false
           show_signature_annotations: true
+          show_source: true
           show_symbol_type_heading: true
           show_symbol_type_toc: true
           signature_crossrefs: true
           summary: true
-- git-committers:
+- git-revision-date-localized:
     enabled: !ENV [DEPLOY, false]
-    repository: pawamoy/duty
+    enable_creation_date: true
+    type: timeago
 - minify:
     minify_html: !ENV [DEPLOY, false]
 - group:

{duty-1.4.1 → duty-1.4.3}/pyproject.toml

@@ -11,7 +11,7 @@ authors = [
     { name = "Timothée Mazzucotelli", email = "dev@pawamoy.fr" },
 ]
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 keywords = [
     "task-runner",
     "task",
@@ -25,12 +25,12 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Documentation",
     "Topic :: Software Development",
     "Topic :: Utilities",
@@ -41,7 +41,7 @@ dependencies = [
     "failprint>=0.11,!=1.0.0",
     "typing-extensions>=4.0; python_version < '3.11'",
 ]
-version = "1.4.1"
+version = "1.4.3"
 
 [project.license]
 text = "ISC"
@@ -74,7 +74,6 @@ source-includes = [
     "scripts",
     "share",
     "tests",
-    "devdeps.txt",
     "duties.py",
     "mkdocs.yml",
     "*.md",
@@ -85,3 +84,32 @@ source-includes = [
 data = [
     { path = "share/**/*", relative-to = "." },
 ]
+
+[tool.uv]
+dev-dependencies = [
+    "editables>=0.5",
+    "build>=1.2",
+    "git-changelog>=2.5",
+    "twine>=5.1",
+    "duty>=1.4",
+    "ruff>=0.4",
+    "pytest>=8.2",
+    "pytest-cov>=5.0",
+    "pytest-randomly>=3.15",
+    "pytest-xdist>=3.6",
+    "mypy>=1.10",
+    "types-markdown>=3.6",
+    "types-pyyaml>=6.0",
+    "black>=24.4",
+    "markdown-callouts>=0.4",
+    "markdown-exec>=1.8",
+    "mkdocs>=1.6",
+    "mkdocs-coverage>=1.0",
+    "mkdocs-gen-files>=0.5",
+    "mkdocs-git-revision-date-localized-plugin>=1.2",
+    "mkdocs-literate-nav>=0.6",
+    "mkdocs-material>=9.5",
+    "mkdocs-minify-plugin>=0.8",
+    "mkdocstrings[python]>=0.25",
+    "tomli>=2.0; python_version < '3.11'",
+]

{duty-1.4.1 → duty-1.4.3}/scripts/gen_credits.py

@@ -5,17 +5,18 @@ from __future__ import annotations
 import os
 import sys
 from collections import defaultdict
+from collections.abc import Iterable
 from importlib.metadata import distributions
 from itertools import chain
 from pathlib import Path
 from textwrap import dedent
-from typing import Dict, Iterable, Union
+from typing import Union
 
 from jinja2 import StrictUndefined
 from jinja2.sandbox import SandboxedEnvironment
 from packaging.requirements import Requirement
 
-# TODO: Remove once support for Python 3.10 is dropped.
+# YORE: EOL 3.10: Replace block with line 2.
 if sys.version_info >= (3, 11):
     import tomllib
 else:
@@ -26,11 +27,10 @@ with project_dir.joinpath("pyproject.toml").open("rb") as pyproject_file:
     pyproject = tomllib.load(pyproject_file)
 project = pyproject["project"]
 project_name = project["name"]
-with project_dir.joinpath("devdeps.txt").open() as devdeps_file:
-    devdeps = [line.strip() for line in devdeps_file if line.strip() and not line.strip().startswith(("-e", "#"))]
+devdeps = [dep for dep in pyproject["tool"]["uv"]["dev-dependencies"] if not dep.startswith("-e")]
 
-PackageMetadata = Dict[str, Union[str, Iterable[str]]]
-Metadata = Dict[str, PackageMetadata]
+PackageMetadata = dict[str, Union[str, Iterable[str]]]
+Metadata = dict[str, PackageMetadata]
 
 
 def _merge_fields(metadata: dict) -> PackageMetadata:

{duty-1.4.1 → duty-1.4.3}/scripts/make

@@ -9,12 +9,10 @@ import subprocess
 import sys
 from contextlib import contextmanager
 from pathlib import Path
+from textwrap import dedent
 from typing import Any, Iterator
 
-PYTHON_VERSIONS = os.getenv("PYTHON_VERSIONS", "3.8 3.9 3.10 3.11 3.12 3.13").split()
-
-exe = ""
-prefix = ""
+PYTHON_VERSIONS = os.getenv("PYTHON_VERSIONS", "3.9 3.10 3.11 3.12 3.13 3.14").split()
 
 
 def shell(cmd: str, capture_output: bool = False, **kwargs: Any) -> str | None:
@@ -37,17 +35,13 @@ def environ(**kwargs: str) -> Iterator[None]:
         os.environ.update(original)
 
 
-def uv_install() -> None:
+def uv_install(venv: Path) -> None:
     """Install dependencies using uv."""
-    uv_opts = ""
-    if "UV_RESOLUTION" in os.environ:
-        uv_opts = f"--resolution={os.getenv('UV_RESOLUTION')}"
-    requirements = shell(f"uv pip compile {uv_opts} pyproject.toml devdeps.txt", capture_output=True)
-    shell("uv pip install -r -", input=requirements, text=True)
-    if "CI" not in os.environ:
-        shell("uv pip install --no-deps -e .")
-    else:
-        shell("uv pip install --no-deps .")
+    with environ(UV_PROJECT_ENVIRONMENT=str(venv), PYO3_USE_ABI3_FORWARD_COMPATIBILITY="1"):
+        if "CI" in os.environ:
+            shell("uv sync --no-editable")
+        else:
+            shell("uv sync")
 
 
 def setup() -> None:
@@ -59,7 +53,7 @@ def setup() -> None:
     default_venv = Path(".venv")
     if not default_venv.exists():
         shell("uv venv --python python")
-    uv_install()
+    uv_install(default_venv)
 
     if PYTHON_VERSIONS:
         for version in PYTHON_VERSIONS:
@@ -67,39 +61,22 @@ def setup() -> None:
             venv_path = Path(f".venvs/{version}")
             if not venv_path.exists():
                 shell(f"uv venv --python {version} {venv_path}")
-            with environ(VIRTUAL_ENV=str(venv_path.resolve())):
-                uv_install()
-
-
-def activate(path: str) -> None:
-    """Activate a virtual environment."""
-    global exe, prefix  # noqa: PLW0603
-
-    if (bin := Path(path, "bin")).exists():
-        activate_script = bin / "activate_this.py"
-    elif (scripts := Path(path, "Scripts")).exists():
-        activate_script = scripts / "activate_this.py"
-        exe = ".exe"
-        prefix = f"{path}/Scripts/"
-    else:
-        raise ValueError(f"make: activate: Cannot find activation script in {path}")
-
-    if not activate_script.exists():
-        raise ValueError(f"make: activate: Cannot find activation script in {path}")
-
-    exec(activate_script.read_text(), {"__file__": str(activate_script)})  # noqa: S102
+            with environ(UV_PROJECT_ENVIRONMENT=str(venv_path.resolve())):
+                uv_install(venv_path)
 
 
-def run(version: str, cmd: str, *args: str, **kwargs: Any) -> None:
+def run(version: str, cmd: str, *args: str, no_sync: bool = False, **kwargs: Any) -> None:
     """Run a command in a virtual environment."""
     kwargs = {"check": True, **kwargs}
+    uv_run = ["uv", "run"]
+    if no_sync:
+        uv_run.append("--no-sync")
     if version == "default":
-        activate(".venv")
-        subprocess.run([f"{prefix}{cmd}{exe}", *args], **kwargs)  # noqa: S603, PLW1510
+        with environ(UV_PROJECT_ENVIRONMENT=".venv"):
+            subprocess.run([*uv_run, cmd, *args], **kwargs)  # noqa: S603, PLW1510
     else:
-        activate(f".venvs/{version}")
-        os.environ["MULTIRUN"] = "1"
-        subprocess.run([f"{prefix}{cmd}{exe}", *args], **kwargs)  # noqa: S603, PLW1510
+        with environ(UV_PROJECT_ENVIRONMENT=f".venvs/{version}", MULTIRUN="1"):
+            subprocess.run([*uv_run, cmd, *args], **kwargs)  # noqa: S603, PLW1510
 
 
 def multirun(cmd: str, *args: str, **kwargs: Any) -> None:
@@ -124,10 +101,10 @@ def clean() -> None:
     for path in paths_to_clean:
         shell(f"rm -rf {path}")
 
-    cache_dirs = [".cache", ".pytest_cache", ".mypy_cache", ".ruff_cache", "__pycache__"]
-    for dirpath in Path(".").rglob("*"):
-        if any(dirpath.match(pattern) for pattern in cache_dirs) and not (dirpath.match(".venv") or dirpath.match(".venvs")):
-            shutil.rmtree(path, ignore_errors=True)
+    cache_dirs = {".cache", ".pytest_cache", ".mypy_cache", ".ruff_cache", "__pycache__"}
+    for dirpath in Path(".").rglob("*/"):
+        if dirpath.parts[0] not in (".venv", ".venvs") and dirpath.name in cache_dirs:
+            shutil.rmtree(dirpath, ignore_errors=True)
 
 
 def vscode() -> None:
@@ -143,22 +120,25 @@ def main() -> int:
         if len(args) > 1:
             run("default", "duty", "--help", args[1])
         else:
-            print("Available commands")  # noqa: T201
-            print("  help                  Print this help. Add task name to print help.")  # noqa: T201
-            print("  setup                 Setup all virtual environments (install dependencies).")  # noqa: T201
-            print("  run                   Run a command in the default virtual environment.")  # noqa: T201
-            print("  multirun              Run a command for all configured Python versions.")  # noqa: T201
-            print("  allrun                Run a command in all virtual environments.")  # noqa: T201
-            print("  3.x                   Run a command in the virtual environment for Python 3.x.")  # noqa: T201
-            print("  clean                 Delete build artifacts and cache files.")  # noqa: T201
-            print("  vscode                Configure VSCode to work on this project.")  # noqa: T201
-            try:
-                run("default", "python", "-V", capture_output=True)
-            except (subprocess.CalledProcessError, ValueError):
-                pass
-            else:
-                print("\nAvailable tasks")  # noqa: T201
-                run("default", "duty", "--list")
+            print(
+                dedent(
+                    """
+                    Available commands
+                      help                  Print this help. Add task name to print help.
+                      setup                 Setup all virtual environments (install dependencies).
+                      run                   Run a command in the default virtual environment.
+                      multirun              Run a command for all configured Python versions.
+                      allrun                Run a command in all virtual environments.
+                      3.x                   Run a command in the virtual environment for Python 3.x.
+                      clean                 Delete build artifacts and cache files.
+                      vscode                Configure VSCode to work on this project.
+                    """
+                ),
+                flush=True,
+            )  # noqa: T201
+            if os.path.exists(".venv"):
+                print("\nAvailable tasks", flush=True)  # noqa: T201
+                run("default", "duty", "--list", no_sync=True)
         return 0
 
     while args:

{duty-1.4.1 → duty-1.4.3}/src/duty/callables/blacken_docs.py

@@ -4,10 +4,14 @@ from __future__ import annotations
 
 import re
 from pathlib import Path
-from typing import Pattern, Sequence
+from re import Pattern
+from typing import TYPE_CHECKING
 
 from failprint.lazy import lazy
 
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
 
 @lazy(name="blacken_docs")
 def run(
@@ -24,6 +28,7 @@ def run(
     magic_trailing_comma: bool = True,
     python_cell_magics: set[str] | None = None,
     preview: bool = False,
+    check_only: bool = False,
 ) -> int:
     """Run `blacken-docs`.
 
@@ -44,6 +49,8 @@ def run(
             Useful for formatting cells with custom python magics.
         preview: Enable potentially disruptive style changes that may be added
             to Black's main functionality in the next major release.
+        check_only: Don't modify files but indicate when changes are necessary
+            with a message and non-zero return code.
 
     Returns:
         Success/failure.
@@ -80,5 +87,6 @@ def run(
             black_mode,
             skip_errors=skip_errors,
             rst_literal_blocks=rst_literal_blocks,
+            check_only=check_only,
         )
     return retv

{duty-1.4.1 → duty-1.4.3}/src/duty/callables/ruff.py

@@ -1,16 +1,16 @@
-"""Callable for [Ruff](https://github.com/charliermarsh/ruff)."""
+"""Callable for [Ruff](https://github.com/astral-sh/ruff)."""
 
 from __future__ import annotations
 
 import os
 import subprocess
 import sys
-from functools import lru_cache
+from functools import cache
 
 from failprint.lazy import lazy
 
 
-@lru_cache(maxsize=None)
+@cache
 def _find_ruff() -> str:
     from ruff.__main__ import find_ruff_bin
 
@@ -90,34 +90,34 @@ def check(
     """Run Ruff on the given files or directories.
 
     Parameters:
-        fix: Attempt to automatically fix lint violations
-        config: Path to the `pyproject.toml` or `ruff.toml` file to use for configuration
-        show_source: Show violations with source code
-        show_fixes: Show an enumeration of all autofixed lint violations
-        diff: Avoid writing any fixed files back; instead, output a diff for each changed file to stdout
-        watch: Run in watch mode by re-running whenever files change
-        fix_only: Fix any fixable lint violations, but don't report on leftover violations. Implies `--fix`
-        output_format: Output serialization format for violations [env: RUFF_FORMAT=] [possible values: text, json, junit, grouped, github, gitlab, pylint]
-        statistics: Show counts for every rule with at least one violation
-        add_noqa: Enable automatic additions of `noqa` directives to failing lines
-        show_files: See the files Ruff will be run against with the current settings
-        show_settings: See the settings Ruff will use to lint a given Python file
-        select: Comma-separated list of rule codes to enable (or ALL, to enable all rules)
-        ignore: Comma-separated list of rule codes to disable
-        extend_select: Like --select, but adds additional rule codes on top of the selected ones
-        per_file_ignores: List of mappings from file pattern to code to exclude
-        fixable: List of rule codes to treat as eligible for autofix. Only applicable when autofix itself is enabled (e.g., via `--fix`)
-        unfixable: List of rule codes to treat as ineligible for autofix. Only applicable when autofix itself is enabled (e.g., via `--fix`)
-        exclude: List of paths, used to omit files and/or directories from analysis
-        extend_exclude: Like --exclude, but adds additional files and directories on top of those already excluded
-        respect_gitignore: Respect file exclusions via `.gitignore` and other standard ignore files
-        force_exclude: Enforce exclusions, even for paths passed to Ruff directly on the command-line
-        no_cache: Disable cache reads
-        isolated: Ignore all configuration files
-        cache_dir: Path to the cache directory [env: RUFF_CACHE_DIR=]
-        stdin_filename: The name of the file when passing it through stdin
-        exit_zero: Exit with status code "0", even upon detecting lint violations
-        exit_non_zero_on_fix: Exit with a non-zero status code if any files were modified via autofix, even if no lint violations remain
+        fix: Attempt to automatically fix lint violations.
+        config: Path to the `pyproject.toml` or `ruff.toml` file to use for configuration.
+        show_source: Show violations with source code.
+        show_fixes: Show an enumeration of all autofixed lint violations.
+        diff: Avoid writing any fixed files back; instead, output a diff for each changed file to stdout.
+        watch: Run in watch mode by re-running whenever files change.
+        fix_only: Fix any fixable lint violations, but don't report on leftover violations. Implies `--fix`.
+        output_format: Output serialization format for violations (env: RUFF_FORMAT=) (possible values: text, json, junit, grouped, github, gitlab, pylint).
+        statistics: Show counts for every rule with at least one violation.
+        add_noqa: Enable automatic additions of `noqa` directives to failing lines.
+        show_files: See the files Ruff will be run against with the current settings.
+        show_settings: See the settings Ruff will use to lint a given Python file.
+        select: Comma-separated list of rule codes to enable (or ALL, to enable all rules).
+        ignore: Comma-separated list of rule codes to disable.
+        extend_select: Like --select, but adds additional rule codes on top of the selected ones.
+        per_file_ignores: List of mappings from file pattern to code to exclude.
+        fixable: List of rule codes to treat as eligible for autofix. Only applicable when autofix itself is enabled (e.g., via `--fix`).
+        unfixable: List of rule codes to treat as ineligible for autofix. Only applicable when autofix itself is enabled (e.g., via `--fix`).
+        exclude: List of paths, used to omit files and/or directories from analysis.
+        extend_exclude: Like --exclude, but adds additional files and directories on top of those already excluded.
+        respect_gitignore: Respect file exclusions via `.gitignore` and other standard ignore files.
+        force_exclude: Enforce exclusions, even for paths passed to Ruff directly on the command-line.
+        no_cache: Disable cache reads.
+        isolated: Ignore all configuration files.
+        cache_dir: Path to the cache directory (env: RUFF_CACHE_DIR=).
+        stdin_filename: The name of the file when passing it through stdin.
+        exit_zero: Exit with status code "0", even upon detecting lint violations.
+        exit_non_zero_on_fix: Exit with a non-zero status code if any files were modified via autofix, even if no lint violations remain.
         verbose: Enable verbose logging.
         quiet: Print lint violations, but nothing else.
         silent: Disable all logging (but still exit with status code "1" upon detecting lint violations).
@@ -368,7 +368,7 @@ def linter(
     """List all supported upstream linters.
 
     Parameters:
-        output_format: Output format [default: pretty] [possible values: text, json, pretty].
+        output_format: Output format (default: pretty) (possible values: text, json, pretty).
         verbose: Enable verbose logging.
         quiet: Print lint violations, but nothing else.
         silent: Disable all logging (but still exit with status code "1" upon detecting lint violations).

{duty-1.4.1 → duty-1.4.3}/src/duty/callables/safety.py

@@ -5,10 +5,13 @@ from __future__ import annotations
 import importlib
 import sys
 from io import StringIO
-from typing import Literal, Sequence, cast
+from typing import TYPE_CHECKING, Literal, cast
 
 from failprint.lazy import lazy
 
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
 
 @lazy(name="safety.check")
 def check(

{duty-1.4.1 → duty-1.4.3}/src/duty/collection.py

@@ -6,11 +6,11 @@ import inspect
 import sys
 from copy import deepcopy
 from importlib import util as importlib_util
-from typing import Any, Callable, ClassVar, List, Union
+from typing import Any, Callable, ClassVar, Union
 
 from duty.context import Context
 
-DutyListType = List[Union[str, Callable, "Duty"]]
+DutyListType = list[Union[str, Callable, "Duty"]]
 default_duties_file = "duties.py"
 
 

{duty-1.4.1 → duty-1.4.3}/src/duty/context.py

@@ -4,14 +4,17 @@ from __future__ import annotations
 
 import os
 from contextlib import contextmanager, suppress
-from typing import Any, Callable, Iterator, List, Union
+from typing import TYPE_CHECKING, Any, Callable, Union
 
 from failprint.runners import run as failprint_run
 
 from duty.exceptions import DutyFailure
 from duty.tools import Tool
 
-CmdType = Union[str, List[str], Callable]
+if TYPE_CHECKING:
+    from collections.abc import Iterator
+
+CmdType = Union[str, list[str], Callable]
 
 
 class Context:

{duty-1.4.1 → duty-1.4.3}/src/duty/decorator.py

@@ -4,11 +4,13 @@ from __future__ import annotations
 
 import inspect
 from functools import wraps
-from typing import TYPE_CHECKING, Any, Callable, Iterable, overload
+from typing import TYPE_CHECKING, Any, Callable, overload
 
 from duty.collection import Duty, DutyListType
 
 if TYPE_CHECKING:
+    from collections.abc import Iterable
+
     from duty.context import Context
 
 

{duty-1.4.1 → duty-1.4.3}/src/duty/tools/_blacken_docs.py

@@ -4,10 +4,14 @@ from __future__ import annotations
 
 import re
 from pathlib import Path
-from typing import Pattern, Sequence
+from re import Pattern
+from typing import TYPE_CHECKING
 
 from duty.tools._base import Tool
 
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
 
 class blacken_docs(Tool):  # noqa: N801
     """Call [blacken-docs](https://github.com/adamchainz/blacken-docs)."""
@@ -29,6 +33,7 @@ class blacken_docs(Tool):  # noqa: N801
         magic_trailing_comma: bool = True,
         python_cell_magics: set[str] | None = None,
         preview: bool = False,
+        check_only: bool = False,
     ) -> None:
         """Run `blacken-docs`.
 
@@ -49,6 +54,8 @@ class blacken_docs(Tool):  # noqa: N801
                 Useful for formatting cells with custom python magics.
             preview: Enable potentially disruptive style changes that may be added
                 to Black's main functionality in the next major release.
+            check_only: Don't modify files but indicate when changes are necessary
+                with a message and non-zero return code.
 
         Returns:
             Success/failure.
@@ -77,6 +84,7 @@ class blacken_docs(Tool):  # noqa: N801
         preview = self.py_args["preview"]
         skip_errors = self.py_args["skip_errors"]
         rst_literal_blocks = self.py_args["rst_literal_blocks"]
+        check_only = self.py_args["check_only"]
 
         # Build filepaths.
         exts = ("md", "py") if exts is None else tuple(ext.lstrip(".") for ext in exts)
@@ -111,5 +119,6 @@ class blacken_docs(Tool):  # noqa: N801
                 black_mode,
                 skip_errors=skip_errors,
                 rst_literal_blocks=rst_literal_blocks,
+                check_only=check_only,
             )
         return retv

{duty-1.4.1 → duty-1.4.3}/src/duty/tools/_ruff.py

@@ -1,16 +1,16 @@
-"""Callable for [Ruff](https://github.com/charliermarsh/ruff)."""
+"""Callable for [Ruff](https://github.com/astral-sh/ruff)."""
 
 from __future__ import annotations
 
 import os
 import subprocess
 import sys
-from functools import lru_cache
+from functools import cache
 
 from duty.tools._base import Tool
 
 
-@lru_cache(maxsize=None)
+@cache
 def _find_ruff() -> str:
     from ruff.__main__ import find_ruff_bin
 
@@ -31,7 +31,7 @@ def _find_ruff() -> str:
 
 
 class ruff(Tool):  # noqa: N801
-    """Call [Ruff](https://github.com/charliermarsh/ruff)."""
+    """Call [Ruff](https://github.com/astral-sh/ruff)."""
 
     cli_name = "ruff"
 
@@ -74,34 +74,34 @@ class ruff(Tool):  # noqa: N801
         """Run Ruff on the given files or directories.
 
         Parameters:
-            fix: Attempt to automatically fix lint violations
-            config: Path to the `pyproject.toml` or `ruff.toml` file to use for configuration
-            show_source: Show violations with source code
-            show_fixes: Show an enumeration of all autofixed lint violations
-            diff: Avoid writing any fixed files back; instead, output a diff for each changed file to stdout
-            watch: Run in watch mode by re-running whenever files change
-            fix_only: Fix any fixable lint violations, but don't report on leftover violations. Implies `--fix`
-            output_format: Output serialization format for violations [env: RUFF_FORMAT=] [possible values: text, json, junit, grouped, github, gitlab, pylint]
-            statistics: Show counts for every rule with at least one violation
-            add_noqa: Enable automatic additions of `noqa` directives to failing lines
-            show_files: See the files Ruff will be run against with the current settings
-            show_settings: See the settings Ruff will use to lint a given Python file
-            select: Comma-separated list of rule codes to enable (or ALL, to enable all rules)
-            ignore: Comma-separated list of rule codes to disable
-            extend_select: Like --select, but adds additional rule codes on top of the selected ones
-            per_file_ignores: List of mappings from file pattern to code to exclude
-            fixable: List of rule codes to treat as eligible for autofix. Only applicable when autofix itself is enabled (e.g., via `--fix`)
-            unfixable: List of rule codes to treat as ineligible for autofix. Only applicable when autofix itself is enabled (e.g., via `--fix`)
-            exclude: List of paths, used to omit files and/or directories from analysis
-            extend_exclude: Like --exclude, but adds additional files and directories on top of those already excluded
-            respect_gitignore: Respect file exclusions via `.gitignore` and other standard ignore files
-            force_exclude: Enforce exclusions, even for paths passed to Ruff directly on the command-line
-            no_cache: Disable cache reads
-            isolated: Ignore all configuration files
-            cache_dir: Path to the cache directory [env: RUFF_CACHE_DIR=]
-            stdin_filename: The name of the file when passing it through stdin
-            exit_zero: Exit with status code "0", even upon detecting lint violations
-            exit_non_zero_on_fix: Exit with a non-zero status code if any files were modified via autofix, even if no lint violations remain
+            fix: Attempt to automatically fix lint violations.
+            config: Path to the `pyproject.toml` or `ruff.toml` file to use for configuration.
+            show_source: Show violations with source code.
+            show_fixes: Show an enumeration of all autofixed lint violations.
+            diff: Avoid writing any fixed files back; instead, output a diff for each changed file to stdout.
+            watch: Run in watch mode by re-running whenever files change.
+            fix_only: Fix any fixable lint violations, but don't report on leftover violations. Implies `--fix`.
+            output_format: Output serialization format for violations (env: RUFF_FORMAT=) (possible values: text, json, junit, grouped, github, gitlab, pylint).
+            statistics: Show counts for every rule with at least one violation.
+            add_noqa: Enable automatic additions of `noqa` directives to failing lines.
+            show_files: See the files Ruff will be run against with the current settings.
+            show_settings: See the settings Ruff will use to lint a given Python file.
+            select: Comma-separated list of rule codes to enable (or ALL, to enable all rules).
+            ignore: Comma-separated list of rule codes to disable.
+            extend_select: Like --select, but adds additional rule codes on top of the selected ones.
+            per_file_ignores: List of mappings from file pattern to code to exclude.
+            fixable: List of rule codes to treat as eligible for autofix. Only applicable when autofix itself is enabled (e.g., via `--fix`).
+            unfixable: List of rule codes to treat as ineligible for autofix. Only applicable when autofix itself is enabled (e.g., via `--fix`).
+            exclude: List of paths, used to omit files and/or directories from analysis.
+            extend_exclude: Like --exclude, but adds additional files and directories on top of those already excluded.
+            respect_gitignore: Respect file exclusions via `.gitignore` and other standard ignore files.
+            force_exclude: Enforce exclusions, even for paths passed to Ruff directly on the command-line.
+            no_cache: Disable cache reads.
+            isolated: Ignore all configuration files.
+            cache_dir: Path to the cache directory (env: RUFF_CACHE_DIR=).
+            stdin_filename: The name of the file when passing it through stdin.
+            exit_zero: Exit with status code "0", even upon detecting lint violations.
+            exit_non_zero_on_fix: Exit with a non-zero status code if any files were modified via autofix, even if no lint violations remain.
             verbose: Enable verbose logging.
             quiet: Print lint violations, but nothing else.
             silent: Disable all logging (but still exit with status code "1" upon detecting lint violations).
@@ -390,7 +390,7 @@ class ruff(Tool):  # noqa: N801
         """List all supported upstream linters.
 
         Parameters:
-            output_format: Output format [default: pretty] [possible values: text, json, pretty].
+            output_format: Output format (default: pretty) (possible values: text, json, pretty).
             verbose: Enable verbose logging.
             quiet: Print lint violations, but nothing else.
             silent: Disable all logging (but still exit with status code "1" upon detecting lint violations).

{duty-1.4.1 → duty-1.4.3}/src/duty/tools/_safety.py

@@ -5,10 +5,13 @@ from __future__ import annotations
 import importlib
 import sys
 from io import StringIO
-from typing import Literal, Sequence, cast
+from typing import TYPE_CHECKING, Literal, cast
 
 from duty.tools._base import Tool
 
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
 
 class safety(Tool):  # noqa: N801
     """Call [Safety](https://github.com/pyupio/safety)."""

{duty-1.4.1 → duty-1.4.3}/src/duty/validation.py

@@ -12,9 +12,12 @@ import textwrap
 from contextlib import suppress
 from functools import cached_property, partial
 from inspect import Parameter, Signature, signature
-from typing import Any, Callable, ForwardRef, Sequence, Union, get_args, get_origin
+from typing import TYPE_CHECKING, Any, Callable, ForwardRef, Union, get_args, get_origin
 
-# TODO: Update once support for Python 3.9 is dropped.
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
+# YORE: EOL 3.9: Replace block with lines 6-13.
 if sys.version_info < (3, 10):
     from eval_type_backport import eval_type_backport as eval_type
 

{duty-1.4.1 → duty-1.4.3}/tests/test_collection.py

@@ -8,7 +8,7 @@ from duty.collection import Collection, Duty
 from duty.decorator import duty as decorate
 
 
-def none(*args, **kwargs) -> None:  # noqa: ANN002, ANN003, ARG001, D103
+def none(*args, **kwargs) -> None:  # noqa: ANN002, ANN003, D103
     ...  # pragma: no cover
 
 

{duty-1.4.1 → duty-1.4.3}/tests/test_context.py

@@ -96,4 +96,8 @@ def test_workdir_as_context_manager(monkeypatch: pytest.MonkeyPatch) -> None:
     records.append(failure.value.code)
 
     base = records[0]
-    assert records == [base, base - 1, base - 2, base - 3]
+
+    # If the repository is checked out near the root of the filesystem, the working directory will
+    # eventually be the root, so cap the lowest depth at 1.
+    expected_depths = [max(1, base - offset) for offset in range(len(records))]
+    assert records == expected_depths

{duty-1.4.1 → duty-1.4.3}/tests/test_validation.py

@@ -139,7 +139,7 @@ def test_params_caster(func: Callable, args: tuple, kwargs: dict, expected_args:
 def test_casting_based_on_default_value_type() -> None:
     """Test that we cast according to the default value type when there is no annotation."""
 
-    def func(ctx, a=0):  # noqa: ANN202,ARG001,ANN001
+    def func(ctx, a=0):  # noqa: ANN202, ANN001
         ...
 
     caster = _get_params_caster(func, a="1")
@@ -150,7 +150,7 @@ def test_casting_based_on_default_value_type() -> None:
 def test_validating_modern_annotations() -> None:
     """Test modern type annotations in function signatures."""
 
-    def func(ctx, a: int | None = None):  # noqa: ANN202,ARG001,ANN001
+    def func(ctx, a: int | None = None):  # noqa: ANN202, ANN001
         ...
 
     caster = _get_params_caster(func, a=1)

duty-1.4.1/devdeps.txt

@@ -1,32 +0,0 @@
-# dev
-editables>=0.5
-
-# maintenance
-build>=1.2
-git-changelog>=2.5
-twine>=5.0; python_version < '3.13'
-
-# ci
-duty>=1.4
-ruff>=0.4
-pytest>=8.2
-pytest-cov>=5.0
-pytest-randomly>=3.15
-pytest-xdist>=3.6
-mypy>=1.10
-types-markdown>=3.6
-types-pyyaml>=6.0
-
-# docs
-black>=24.4
-markdown-callouts>=0.4
-markdown-exec>=1.8
-mkdocs>=1.6
-mkdocs-coverage>=1.0
-mkdocs-gen-files>=0.5
-mkdocs-git-committers-plugin-2>=2.3
-mkdocs-literate-nav>=0.6
-mkdocs-material>=9.5
-mkdocs-minify-plugin>=0.8
-mkdocstrings[python]>=0.25
-tomli>=2.0; python_version < '3.11'