duty 1.2.0__tar.gz → 1.3.0__tar.gz

{duty-1.2.0 → duty-1.3.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.1
 Name: duty
-Version: 1.2.0
+Version: 1.3.0
 Summary: A simple task runner.
-Keywords: task-runner task runner cross-platform
-Author-Email: Timothée Mazzucotelli <pawamoy@pm.me>
+Keywords: task-runner,task,runner,cross-platform
+Author-Email: =?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>
 License: ISC
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -15,6 +15,7 @@ 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: Topic :: Documentation
 Classifier: Topic :: Software Development
 Classifier: Topic :: Utilities
@@ -28,15 +29,16 @@ 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-Dist: eval-type-backport; python_version < "3.10"
 Requires-Dist: failprint!=1.0.0,>=0.11
 Description-Content-Type: text/markdown
 
 # duty
 
 [![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%20material-blue.svg?style=flat)](https://pawamoy.github.io/duty/)
+[![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-blue.svg?style=flat)](https://gitpod.io/#https://github.com/pawamoy/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.

{duty-1.2.0 → duty-1.3.0}/README.md

@@ -1,9 +1,9 @@
 # duty
 
 [![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%20material-blue.svg?style=flat)](https://pawamoy.github.io/duty/)
+[![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-blue.svg?style=flat)](https://gitpod.io/#https://github.com/pawamoy/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.

{duty-1.2.0 → duty-1.3.0}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "pdm.backend"
 name = "duty"
 description = "A simple task runner."
 authors = [
-    { name = "Timothée Mazzucotelli", email = "pawamoy@pm.me" },
+    { name = "Timothée Mazzucotelli", email = "dev@pawamoy.fr" },
 ]
 readme = "README.md"
 requires-python = ">=3.8"
@@ -30,15 +30,17 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Documentation",
     "Topic :: Software Development",
     "Topic :: Utilities",
     "Typing :: Typed",
 ]
 dependencies = [
+    "eval-type-backport; python_version < '3.10'",
     "failprint>=0.11,!=1.0.0",
 ]
-version = "1.2.0"
+version = "1.3.0"
 
 [project.license]
 text = "ISC"
@@ -56,58 +58,17 @@ Funding = "https://github.com/sponsors/pawamoy"
 [project.scripts]
 duty = "duty.cli:main"
 
-[tool.pdm]
-plugins = [
-    "pdm-multirun",
-]
-
 [tool.pdm.version]
 source = "scm"
 
 [tool.pdm.build]
 package-dir = "src"
 editable-backend = "editables"
-
-[tool.pdm.dev-dependencies]
-ci-quality = [
-    "duty[docs,quality,typing,security]",
-]
-ci-tests = [
-    "duty[tests]",
-]
-docs = [
-    "black>=23.9",
-    "markdown-callouts>=0.3",
-    "markdown-exec>=1.7",
-    "mkdocs>=1.5",
-    "mkdocs-coverage>=1.0",
-    "mkdocs-gen-files>=0.5",
-    "mkdocs-git-committers-plugin-2>=1.2",
-    "mkdocs-literate-nav>=0.6",
-    "mkdocs-material>=9.4",
-    "mkdocs-minify-plugin>=0.7",
-    "mkdocstrings[python]>=0.23",
-    "tomli>=2.0; python_version < '3.11'",
+source-includes = [
+    "share",
 ]
-maintain = [
-    "black>=23.9",
-    "blacken-docs>=1.16",
-    "git-changelog>=2.3",
-]
-quality = [
-    "ruff>=0.0",
-]
-tests = [
-    "pytest>=7.4",
-    "pytest-cov>=4.1",
-    "pytest-randomly>=3.15",
-    "pytest-xdist>=3.3",
-]
-typing = [
-    "mypy>=1.5",
-    "types-markdown>=3.5",
-    "types-pyyaml>=6.0",
-]
-security = [
-    "safety>=2.3",
+
+[tool.pdm.build.wheel-data]
+data = [
+    { path = "share/**/*", relative-to = "." },
 ]

{duty-1.2.0 → duty-1.3.0}/src/duty/debug.py

@@ -37,6 +37,8 @@ class Environment:
     """Python interpreter name."""
     interpreter_version: str
     """Python interpreter version."""
+    interpreter_path: str
+    """Path to Python executable."""
     platform: str
     """Operating System."""
     packages: list[Package]
@@ -83,6 +85,7 @@ def get_debug_info() -> Environment:
     return Environment(
         interpreter_name=py_name,
         interpreter_version=py_version,
+        interpreter_path=sys.executable,
         platform=platform.platform(),
         variables=[Variable(var, val) for var in variables if (val := os.getenv(var))],
         packages=[Package(pkg, get_version(pkg)) for pkg in packages],
@@ -93,7 +96,7 @@ def print_debug_info() -> None:
     """Print debug/environment information."""
     info = get_debug_info()
     print(f"- __System__: {info.platform}")
-    print(f"- __Python__: {info.interpreter_name} {info.interpreter_version}")
+    print(f"- __Python__: {info.interpreter_name} {info.interpreter_version} ({info.interpreter_path})")
     print("- __Environment variables__:")
     for var in info.variables:
         print(f"  - `{var.name}`: `{var.value}`")

{duty-1.2.0 → duty-1.3.0}/src/duty/validation.py

@@ -9,9 +9,21 @@ from __future__ import annotations
 
 import sys
 import textwrap
+from contextlib import suppress
 from functools import cached_property
 from inspect import Parameter, Signature, signature
-from typing import Any, Callable, Sequence
+from typing import Any, Callable, ForwardRef, Sequence, Union, get_args, get_origin
+
+# TODO: Update once support for Python 3.9 is dropped.
+if sys.version_info < (3, 10):
+    from eval_type_backport import eval_type_backport as eval_type
+
+    union_types = (Union,)
+else:
+    from types import UnionType
+    from typing import _eval_type as eval_type  # type: ignore[attr-defined]
+
+    union_types = (Union, UnionType)
 
 
 def to_bool(value: str) -> bool:
@@ -40,6 +52,12 @@ def cast_arg(arg: Any, annotation: Any) -> Any:
         return arg
     if annotation is bool:
         annotation = to_bool
+    if get_origin(annotation) in union_types:
+        for sub_annotation in get_args(annotation):
+            if sub_annotation is type(None):
+                continue
+            with suppress(Exception):
+                return cast_arg(arg, sub_annotation)
     try:
         return annotation(arg)
     except Exception:  # noqa: BLE001
@@ -65,11 +83,9 @@ class ParamsCaster:
         Returns:
             The position of the variable positional parameter.
         """
-        pos = 0
-        for param in self.params_list:
+        for pos, param in enumerate(self.params_list):
             if param.kind is Parameter.VAR_POSITIONAL:
                 return pos
-            pos += 1
         return -1
 
     @cached_property
@@ -175,6 +191,7 @@ def _get_params_caster(func: Callable, *args: Any, **kwargs: Any) -> ParamsCaste
         if exec_globals[name] is annotations:
             eval_str = True
             del exec_globals[name]
+            break
     exec_globals["__context_above"] = {}
 
     # Don't keep first parameter: context.
@@ -188,9 +205,10 @@ def _get_params_caster(func: Callable, *args: Any, **kwargs: Any) -> ParamsCaste
                 param.kind,
                 default=param.default,
                 annotation=(
-                    eval(  # noqa: PGH001,S307
-                        param.annotation,
+                    eval_type(
+                        ForwardRef(param.annotation) if isinstance(param.annotation, str) else param.annotation,
                         exec_globals,
+                        {},
                     )
                     if param.annotation is not Parameter.empty
                     else type(param.default)

duty-1.2.0/tests/__init__.py

@@ -1,7 +0,0 @@
-"""Tests suite for `duty`."""
-
-from pathlib import Path
-
-TESTS_DIR = Path(__file__).parent
-TMP_DIR = TESTS_DIR / "tmp"
-FIXTURES_DIR = TESTS_DIR / "fixtures"

duty-1.2.0/tests/conftest.py

@@ -1 +0,0 @@
-"""Configuration for the pytest test suite."""

duty-1.2.0/tests/fixtures/arguments.py

@@ -1,6 +0,0 @@
-from duty import duty
-
-
-@duty
-def say_hello(ctx, cat, dog="dog"):
-    ctx.run(lambda: 0, title=f"Hello cat {cat} and dog {dog}!")

duty-1.2.0/tests/fixtures/basic.py

@@ -1,6 +0,0 @@
-from duty import duty
-
-
-@duty
-def hello(ctx):
-    pass

duty-1.2.0/tests/fixtures/booleans.py

@@ -1,6 +0,0 @@
-from duty import duty
-
-
-@duty
-def boolean(ctx, zero: bool = True):
-    ctx.run(lambda: 0 if zero else 1)

duty-1.2.0/tests/fixtures/code.py

@@ -1,6 +0,0 @@
-from duty import duty
-
-
-@duty
-def exit_with(ctx, code):
-    ctx.run(lambda: code)

duty-1.2.0/tests/fixtures/list.py

@@ -1,11 +0,0 @@
-from duty import duty
-
-
-@duty
-def tong(ctx):
-    """Tong..."""
-
-
-@duty
-def deum(ctx):
-    """DEUM!"""

duty-1.2.0/tests/fixtures/multiple.py

@@ -1,11 +0,0 @@
-from duty import duty
-
-
-@duty
-def first_duty(ctx):
-    ctx.run(lambda: 0, fmt="tap", title="first")
-
-
-@duty
-def second_duty(ctx):
-    ctx.run(lambda: 0, fmt="tap", title="second")

duty-1.2.0/tests/fixtures/precedence.py

@@ -1,6 +0,0 @@
-from duty import duty
-
-
-@duty(nofail=True)
-def precedence(ctx):
-    ctx.run(lambda: 1, title="Precedence", nofail=False)

duty-1.2.0/tests/fixtures/validation.py

@@ -1,46 +0,0 @@
-def no_params(ctx):
-    pass  # pragma: no cover
-
-
-def pos_or_kw_param(ctx, a: int):
-    pass  # pragma: no cover
-
-
-def pos_or_kw_params(ctx, a: int, b: int):
-    pass  # pragma: no cover
-
-
-def varpos_param(ctx, *a: int):
-    pass  # pragma: no cover
-
-
-def pos_and_varpos_param(ctx, a: int, *b: int):
-    pass  # pragma: no cover
-
-
-def kwonly_param(ctx, *a: int, b: int):
-    pass  # pragma: no cover
-
-
-def varkw_param(ctx, a: int, **b: int):
-    pass  # pragma: no cover
-
-
-def varkw_no_annotation(ctx, **a):
-    pass  # pragma: no cover
-
-
-def posonly_marker(ctx, a: int, /, b: int):
-    pass  # pragma: no cover
-
-
-def kwonly_marker(ctx, a: int, *, b: int):
-    pass  # pragma: no cover
-
-
-def only_markers(ctx, a: int, /, b: int, *, c: int):
-    pass  # pragma: no cover
-
-
-def full(ctx, a: int, /, b: int, *c: int, d: int, e: int = 0, **f: int):
-    pass  # pragma: no cover

duty-1.2.0/tests/test_cli.py

@@ -1,247 +0,0 @@
-"""Tests for the `cli` module."""
-
-from __future__ import annotations
-
-import pytest
-
-from duty import cli, debug
-
-
-def test_no_duty(capsys: pytest.CaptureFixture) -> None:
-    """Run no duties.
-
-    Parameters:
-        capsys: Pytest fixture to capture output.
-    """
-    assert cli.main([]) == 1
-    captured = capsys.readouterr()
-    assert "Available duties" in captured.out
-
-
-def test_show_help(capsys: pytest.CaptureFixture) -> None:
-    """Show help.
-
-    Parameters:
-        capsys: Pytest fixture to capture output.
-    """
-    assert cli.main(["-h"]) == 0
-    captured = capsys.readouterr()
-    assert "duty" in captured.out
-
-
-def test_show_help_for_given_duties(capsys: pytest.CaptureFixture) -> None:
-    """Show help for given duties.
-
-    Parameters:
-        capsys: Pytest fixture to capture output.
-    """
-    assert cli.main(["-d", "tests/fixtures/basic.py", "-h", "hello"]) == 0
-    captured = capsys.readouterr()
-    assert "hello" in captured.out
-
-
-def test_show_help_unknown_duty(capsys: pytest.CaptureFixture) -> None:
-    """Show help for an unknown duty.
-
-    Parameters:
-        capsys: Pytest fixture to capture output.
-    """
-    assert cli.main(["-d", "tests/fixtures/basic.py", "-h", "not-here"]) == 0
-    captured = capsys.readouterr()
-    assert "Unknown duty" in captured.out
-
-
-def test_select_duties() -> None:
-    """Run a duty."""
-    assert cli.main(["-d", "tests/fixtures/basic.py", "hello"]) == 0
-
-
-def test_unknown_duty() -> None:
-    """Don't run an unknown duty."""
-    assert cli.main(["-d", "tests/fixtures/basic.py", "byebye"]) == 1
-
-
-def test_incorrect_arguments() -> None:
-    """Use incorrect arguments."""
-    assert cli.main(["-d", "tests/fixtures/basic.py", "hello=1"]) == 1
-
-
-# we use 300 because it's slightly above the valid maximum 255
-@pytest.mark.parametrize("code", range(-100, 300, 7))
-def test_duty_failure(code: int) -> None:
-    """Check exit code.
-
-    Parameters:
-        code: Code to match.
-    """
-    assert cli.main(["-d", "tests/fixtures/code.py", "exit_with", f"code={code}"]) == code
-
-
-def test_multiple_duties(capfd: pytest.CaptureFixture) -> None:
-    """Run multiple duties.
-
-    Parameters:
-        capfd: Pytest fixture to capture output.
-    """
-    assert cli.main(["-d", "tests/fixtures/multiple.py", "first_duty", "second_duty"]) == 0
-    captured = capfd.readouterr()
-    assert "first" in captured.out
-    assert "second" in captured.out
-
-
-def test_duty_arguments(capfd: pytest.CaptureFixture) -> None:
-    """Run duty with arguments.
-
-    Parameters:
-        capfd: Pytest fixture to capture output.
-    """
-    assert cli.main(["-d", "tests/fixtures/arguments.py", "say_hello", "cat=fabric"]) == 0
-    captured = capfd.readouterr()
-    assert "cat fabric" in captured.out
-    assert "dog dog" in captured.out
-
-    assert cli.main(["-d", "tests/fixtures/arguments.py", "say_hello", "dog=paramiko", "cat=invoke"]) == 0
-    captured = capfd.readouterr()
-    assert "cat invoke" in captured.out
-    assert "dog paramiko" in captured.out
-
-
-def test_list_duties(capsys: pytest.CaptureFixture) -> None:
-    """List duties.
-
-    Parameters:
-        capsys: Pytest fixture to capture output.
-    """
-    assert cli.main(["-d", "tests/fixtures/list.py", "-l"]) == 0
-    captured = capsys.readouterr()
-    assert "Tong..." in captured.out
-    assert "DEUM!" in captured.out
-
-
-def test_global_options() -> None:
-    """Test global options."""
-    assert cli.main(["-d", "tests/fixtures/code.py", "-z", "exit_with", "1"]) == 0
-
-
-def test_global_and_local_options() -> None:
-    """Test global and local options."""
-    assert cli.main(["-d", "tests/fixtures/code.py", "-z", "exit_with", "-Z", "1"]) == 1
-
-
-def test_options_precedence() -> None:
-    """Test options precedence."""
-    # @duty(nofail=True) is overridden by ctx.run(nofail=False)
-    assert cli.main(["-d", "tests/fixtures/precedence.py", "precedence"]) == 1
-
-    # ctx.run(nofail=False) is overridden by local option -z
-    assert cli.main(["-d", "tests/fixtures/precedence.py", "precedence", "-z"]) == 0
-
-    # ctx.run(nofail=False) is overridden by global option -z
-    assert cli.main(["-d", "tests/fixtures/precedence.py", "-z", "precedence"]) == 0
-
-    # global option -z is overridden by local option -z
-    assert cli.main(["-d", "tests/fixtures/precedence.py", "-z", "precedence", "-Z"]) == 1
-
-
-# test options precedence (CLI option, env var, ctx.run, @duty
-# test positional arguments
-# test extra keyword arguments
-# test complete (global options + local options + multi duties + positional args + keyword args + extra keyword args)
-
-
-@pytest.mark.parametrize(
-    ("param", "expected"),
-    [
-        ("", 1),
-        ("n", 1),
-        ("N", 1),
-        ("no", 1),
-        ("NO", 1),
-        ("false", 1),
-        ("FALSE", 1),
-        ("off", 1),
-        ("OFF", 1),
-        ("zero=", 1),
-        ("zero=0", 1),
-        ("zero=n", 1),
-        ("zero=N", 1),
-        ("zero=no", 1),
-        ("zero=NO", 1),
-        ("zero=false", 1),
-        ("zero=FALSE", 1),
-        ("zero=off", 1),
-        ("zero=OFF", 1),
-        ("y", 0),
-        ("Y", 0),
-        ("yes", 0),
-        ("YES", 0),
-        ("on", 0),
-        ("ON", 0),
-        ("true", 0),
-        ("TRUE", 0),
-        ("anything else", 0),
-        ("-1", 0),
-        ("1", 0),
-        ("zero=y", 0),
-        ("zero=Y", 0),
-        ("zero=yes", 0),
-        ("zero=YES", 0),
-        ("zero=on", 0),
-        ("zero=ON", 0),
-        ("zero=true", 0),
-        ("zero=TRUE", 0),
-        ("zero=anything else", 0),
-        ("zero=-1", 0),
-        ("zero=1", 0),
-    ],
-)
-def test_cast_bool_parameter(param: str, expected: int) -> None:
-    """Test parameters casting as boolean.
-
-    Parameters:
-        param: Pytest parametrization fixture.
-        expected: Pytest parametrization fixture.
-    """
-    assert cli.main(["-d", "tests/fixtures/booleans.py", "boolean", param]) == expected
-
-
-def test_invalid_params(capsys: pytest.CaptureFixture) -> None:
-    """Check that invalid parameters are early and correctly detected.
-
-    Parameters:
-        capsys: Pytest fixture to capture output.
-    """
-    assert cli.main(["-d", "tests/fixtures/booleans.py", "boolean", "zore=off"]) == 1
-    captured = capsys.readouterr()
-    assert "unexpected keyword argument 'zore'" in captured.err
-
-    assert cli.main(["-d", "tests/fixtures/code.py", "exit_with"]) == 1
-    captured = capsys.readouterr()
-    assert "missing 1 required positional argument: 'code'" in captured.err
-
-
-def test_show_version(capsys: pytest.CaptureFixture) -> None:
-    """Show version.
-
-    Parameters:
-        capsys: Pytest fixture to capture output.
-    """
-    with pytest.raises(SystemExit):
-        cli.main(["-V"])
-    captured = capsys.readouterr()
-    assert debug.get_version() in captured.out
-
-
-def test_show_debug_info(capsys: pytest.CaptureFixture) -> None:
-    """Show debug information.
-
-    Parameters:
-        capsys: Pytest fixture to capture output.
-    """
-    with pytest.raises(SystemExit):
-        cli.main(["--debug-info"])
-    captured = capsys.readouterr().out.lower()
-    assert "python" in captured
-    assert "system" in captured
-    assert "environment" in captured
-    assert "packages" in captured

duty-1.2.0/tests/test_collection.py

@@ -1,70 +0,0 @@
-"""Tests for the `collection` module."""
-
-from __future__ import annotations
-
-import pytest
-
-from duty.collection import Collection, Duty
-from duty.decorator import duty as decorate
-
-
-def none(*args, **kwargs) -> None:  # noqa: ANN002, ANN003, ARG001, D103
-    ...  # pragma: no cover
-
-
-def test_instantiate_duty() -> None:
-    """Instantiate a duty."""
-    assert Duty("name", "description", none)
-    assert Duty("name", "description", none, pre=["0", "1"], post=["2"])
-
-
-def test_dont_get_duty() -> None:
-    """Don't find a duty."""
-    collection = Collection()
-    with pytest.raises(KeyError):
-        collection.get("hello")
-
-
-def test_register_aliases() -> None:
-    """Register a duty and its aliases."""
-    duty = decorate(none, name="hello", aliases=["HELLO", "_hello_", ".hello."])  # type: ignore[call-overload]
-    collection = Collection()
-    collection.add(duty)
-    assert collection.get("hello")
-    assert collection.get("HELLO")
-    assert collection.get("_hello_")
-    assert collection.get(".hello.")
-
-
-def test_replace_name_and_set_alias() -> None:
-    """Replace underscores by dashes in duties names."""
-    collection = Collection()
-    collection.add(decorate(none, name="snake_case"))  # type: ignore[call-overload]
-    assert collection.get("snake_case") is collection.get("snake-case")
-
-
-def test_clear_collection() -> None:
-    """Check that duties and their aliases are correctly cleared from a collection."""
-    collection = Collection()
-    collection.add(decorate(none, name="duty_1"))  # type: ignore[call-overload]
-    collection.clear()
-    with pytest.raises(KeyError):
-        collection.get("duty-1")
-
-
-def test_add_duty_to_multiple_collections() -> None:
-    """Check what happens when adding the same duty to multiple collections."""
-    collection1 = Collection()
-    collection2 = Collection()
-
-    duty = decorate(none, name="duty")  # type: ignore[call-overload]
-
-    collection1.add(duty)
-    collection2.add(duty)
-
-    duty1 = collection1.get("duty")
-    duty2 = collection2.get("duty")
-
-    assert duty1 is not duty2
-    assert duty1.collection is collection1
-    assert duty2.collection is collection2

duty-1.2.0/tests/test_context.py

@@ -1,99 +0,0 @@
-"""Tests for the `context` module."""
-
-from __future__ import annotations
-
-from collections import namedtuple
-from pathlib import Path
-
-import pytest
-
-from duty import context
-from duty.exceptions import DutyFailure
-
-RunResult = namedtuple("RunResult", "code output")  # noqa: PYI024
-
-
-def test_allow_overrides(monkeypatch: pytest.MonkeyPatch) -> None:
-    """Test the `allow_overrides` option.
-
-    Parameters:
-        monkeypatch: A Pytest fixture to monkeypatch objects.
-    """
-    ctx = context.Context({"a": 1}, {"a": 2})
-    records = []
-    monkeypatch.setattr(context, "failprint_run", lambda _, **opts: RunResult(records.append(opts), ""))  # type: ignore[func-returns-value]
-    ctx.run("")
-    ctx.run("", allow_overrides=False)
-    ctx.run("", allow_overrides=True)
-    ctx.run("", allow_overrides=False, a=3)
-    assert records[0]["a"] == 2
-    assert records[1]["a"] == 1
-    assert records[2]["a"] == 2
-    assert records[3]["a"] == 3
-
-
-def test_options_context_manager(monkeypatch: pytest.MonkeyPatch) -> None:
-    """Test changing options using the context manager.
-
-    Parameters:
-        monkeypatch: A Pytest fixture to monkeypatch objects.
-    """
-    ctx = context.Context({"a": 1}, {"a": 2})
-    records = []
-    monkeypatch.setattr(context, "failprint_run", lambda _, **opts: RunResult(records.append(opts), ""))  # type: ignore[func-returns-value]
-
-    with ctx.options(a=3):
-        ctx.run("")  # should be overridden by 2
-        with ctx.options(a=4, allow_overrides=False):
-            ctx.run("")  # should be 4
-            ctx.run("", allow_overrides=True)  # should be 2
-        ctx.run("", allow_overrides=False)  # should be 3
-
-    assert records[0]["a"] == 2
-    assert records[1]["a"] == 4
-    assert records[2]["a"] == 2
-    assert records[3]["a"] == 3
-
-
-def test_workdir(monkeypatch: pytest.MonkeyPatch) -> None:
-    """Test the `workdir` option.
-
-    Parameters:
-        monkeypatch: A Pytest fixture to monkeypatch objects.
-    """
-    ctx = context.Context({})
-    monkeypatch.setattr(context, "failprint_run", lambda _: RunResult(len(Path.cwd().parts), ""))
-    records = []
-    with pytest.raises(DutyFailure) as failure:
-        ctx.run("")
-    records.append(failure.value.code)
-    with pytest.raises(DutyFailure) as failure:
-        ctx.run("", workdir="..")
-    records.append(failure.value.code)
-    assert records[0] == records[1] + 1
-
-
-def test_workdir_as_context_manager(monkeypatch: pytest.MonkeyPatch) -> None:
-    """Test the `workdir` option as a context manager, and the `cd` context manager.
-
-    Parameters:
-        monkeypatch: A Pytest fixture to monkeypatch objects.
-    """
-    ctx = context.Context({})
-    monkeypatch.setattr(context, "failprint_run", lambda _: RunResult(len(Path.cwd().parts), ""))
-    records = []
-    with pytest.raises(DutyFailure) as failure, ctx.options(workdir=".."):
-        ctx.run("")
-    records.append(failure.value.code)
-    with pytest.raises(DutyFailure) as failure, ctx.cd("../.."):
-        ctx.run("")
-    records.append(failure.value.code)
-    with pytest.raises(DutyFailure) as failure, ctx.cd(".."), ctx.options(workdir="../.."):
-        ctx.run("")
-    records.append(failure.value.code)
-    with pytest.raises(DutyFailure) as failure, ctx.cd("../../.."):
-        ctx.run("", workdir="..")
-    records.append(failure.value.code)
-
-    base = records[0]
-    assert records == [base, base - 1, base - 2, base - 3]

duty-1.2.0/tests/test_decorator.py

@@ -1,26 +0,0 @@
-"""Tests for the `decorator` module."""
-
-from __future__ import annotations
-
-import inspect
-
-import pytest
-
-from duty.context import Context
-from duty.decorator import duty as decorate
-from duty.exceptions import DutyFailure
-
-
-def test_accept_one_posarg_when_decorating() -> None:
-    """Accept only one positional argument when decorating."""
-    with pytest.raises(ValueError, match="accepts only one positional argument"):
-        decorate(0, 1)  # type: ignore[call-overload]
-
-
-def test_skipping() -> None:
-    """Wrap function that must be skipped."""
-    duty = decorate(lambda ctx: ctx.run("false"), skip_if=True)  # type: ignore[call-overload]
-    # no DutyFailure raised
-    assert duty.run() is None
-    with pytest.raises(DutyFailure):
-        assert inspect.unwrap(duty)(Context({}))

duty-1.2.0/tests/test_running.py

@@ -1,114 +0,0 @@
-"""Tests about running duties."""
-
-from __future__ import annotations
-
-from typing import NoReturn
-from unittest.mock import NonCallableMock
-
-import pytest
-
-from duty.collection import Collection, Duty
-from duty.decorator import duty as decorate
-from duty.exceptions import DutyFailure
-
-INTERRUPT_CODE = 130
-
-
-def test_run_duty() -> None:
-    """Run a duty."""
-    duty = Duty("name", "description", lambda ctx: 1)
-    assert duty.run() is None  # type: ignore[func-returns-value]
-    assert duty(duty.context) is None  # type: ignore[func-returns-value]
-
-
-def test_run_pre_post_duties_lambdas() -> None:
-    """Run pre- and post- duties as lambdas."""
-    pre_calls = []
-    post_calls = []
-
-    duty = Duty(
-        "name",
-        "description",
-        lambda ctx: None,
-        pre=[lambda ctx: pre_calls.append(True)],
-        post=[lambda ctx: post_calls.append(True)],
-    )
-
-    duty.run()
-
-    assert pre_calls[0] is True
-    assert post_calls[0] is True
-
-
-def test_run_pre_post_duties_instances() -> None:
-    """Run pre- and post- duties as duties."""
-    pre_calls = []
-    post_calls = []
-
-    pre_duty = Duty("pre", "", lambda ctx: pre_calls.append(True))
-    post_duty = Duty("post", "", lambda ctx: post_calls.append(True))
-
-    duty = Duty(
-        name="name",
-        description="description",
-        function=lambda ctx: None,
-        pre=[pre_duty],
-        post=[post_duty],
-    )
-
-    duty.run()
-
-    assert pre_calls[0] is True
-    assert post_calls[0] is True
-
-
-def test_run_pre_post_duties_refs() -> None:
-    """Run pre- and post- duties as duties references."""
-    pre_calls = []
-    post_calls = []
-
-    collection = Collection()
-    collection.add(decorate(lambda ctx: pre_calls.append(True), name="pre"))  # type: ignore[call-overload]
-    collection.add(decorate(lambda ctx: post_calls.append(True), name="post"))  # type: ignore[call-overload]
-
-    duty = Duty("name", "description", lambda ctx: None, collection=collection, pre=["pre"], post=["post"])
-    duty.run()
-
-    assert pre_calls[0] is True
-    assert post_calls[0] is True
-
-
-def test_dont_run_other_pre_post_duties() -> None:
-    """Don't run other types of pre- and post- duties."""
-    pre_duty = NonCallableMock()
-    post_duty = NonCallableMock()
-
-    duty = Duty("name", "description", lambda ctx: 0, pre=[pre_duty], post=[post_duty])
-    duty.run()
-
-    assert not pre_duty.called
-    assert not post_duty.called
-
-
-def test_code_when_keyboard_interrupt() -> None:
-    """Return a code 130 on keyboard interruption."""
-
-    def interrupt() -> NoReturn:
-        raise KeyboardInterrupt
-
-    with pytest.raises(DutyFailure) as excinfo:
-        Duty("name", "description", lambda ctx: ctx.run(interrupt)).run()
-    assert excinfo.value.code == INTERRUPT_CODE
-
-
-def test_dont_raise_duty_failure() -> None:
-    """Don't raise a duty failure on success."""
-    duty = Duty("n", "d", lambda ctx: ctx.run(lambda: 0))
-    assert not duty.run()  # type: ignore[func-returns-value]
-
-
-def test_cant_find_duty_without_collection() -> None:
-    """Check that we can't find a duty with its name without a collection."""
-    duty = decorate(lambda ctx: None, name="duty1", post=["duty2"])  # type: ignore[call-overload]
-    with pytest.raises(RuntimeError):
-        duty.run()

duty-1.2.0/tests/test_validation.py

@@ -1,147 +0,0 @@
-"""Tests for the `validation` module."""
-
-from __future__ import annotations
-
-from inspect import Parameter
-from typing import Any, Callable
-
-import pytest
-
-from duty.validation import _get_params_caster, cast_arg, to_bool
-from tests.fixtures import validation as valfix
-
-
-@pytest.mark.parametrize(
-    ("value", "expected"),
-    [
-        ("y", True),
-        ("Y", True),
-        ("yes", True),
-        ("YES", True),
-        ("on", True),
-        ("ON", True),
-        ("true", True),
-        ("TRUE", True),
-        ("anything else", True),
-        ("-1", True),
-        ("1", True),
-        ("", False),
-        ("n", False),
-        ("N", False),
-        ("no", False),
-        ("NO", False),
-        ("false", False),
-        ("FALSE", False),
-        ("off", False),
-        ("OFF", False),
-    ],
-)
-def test_bool_casting(value: str, expected: bool) -> None:
-    """Check that we correctly cast string values to booleans.
-
-    Parameters:
-        value: The value to cast.
-        expected: The expected result.
-    """
-    assert to_bool(value) == expected
-
-
-class CustomType1:
-    """Dummy type to test type-casting."""
-
-    def __init__(self, value: str):  # noqa: D107
-        self.value = value
-
-    def __eq__(self, other: object):
-        return self.value == other.value  # type: ignore[attr-defined]
-
-
-class CustomType2:
-    """Dummy type to test type-casting."""
-
-    def __init__(self, value, extra):  # noqa: ANN001,D107
-        ...  # pragma: no cover
-
-
-@pytest.mark.parametrize(
-    ("arg", "annotation", "expected"),
-    [
-        ("hello", Parameter.empty, "hello"),
-        ("off", bool, False),
-        ("on", bool, True),
-        ("1", int, 1),
-        ("1", float, 1.0),
-        ("fie", str, "fie"),
-        ("fih", CustomType1, CustomType1("fih")),
-        ("foh", CustomType2, "foh"),
-    ],
-)
-def test_cast_arg(arg: str, annotation: Any, expected: Any) -> None:
-    """Check that arguments are properly casted given an annotation.
-
-    Parameters:
-        arg: The argument value to cast.
-        annotation: The annotation to use.
-        expected: The expected result.
-    """
-    assert cast_arg(arg, annotation) == expected
-
-
-_parametrization = [
-    (valfix.no_params, (), {}, (), {}),
-    (valfix.pos_or_kw_param, ("1",), {}, (1,), {}),
-    (valfix.pos_or_kw_param, (), {"a": "1"}, (), {"a": 1}),
-    (valfix.pos_or_kw_params, ("1", "2"), {}, (1, 2), {}),
-    (valfix.pos_or_kw_params, ("1",), {"b": "2"}, (1,), {"b": 2}),
-    (valfix.pos_or_kw_params, (), {"a": "1", "b": "2"}, (), {"a": 1, "b": 2}),
-    (valfix.varpos_param, (), {}, (), {}),
-    (valfix.varpos_param, ("1", "2"), {}, (1, 2), {}),
-    (valfix.pos_and_varpos_param, ("1",), {}, (1,), {}),
-    (valfix.pos_and_varpos_param, ("1", "2"), {}, (1, 2), {}),
-    (valfix.pos_and_varpos_param, ("1", "2", "3"), {}, (1, 2, 3), {}),
-    (valfix.kwonly_param, (), {"b": "1"}, (), {"b": 1}),
-    (valfix.kwonly_param, ("2",), {"b": "1"}, (2,), {"b": 1}),
-    (valfix.kwonly_param, ("2", "3"), {"b": "1"}, (2, 3), {"b": 1}),
-    (valfix.varkw_param, ("1",), {}, (1,), {}),
-    (valfix.varkw_param, ("1",), {"b": "2"}, (1,), {"b": 2}),
-    (valfix.varkw_param, ("1",), {"b": "2", "c": "3"}, (1,), {"b": 2, "c": 3}),
-    (valfix.varkw_no_annotation, (), {"a": "1"}, (), {"a": "1"}),
-    (valfix.posonly_marker, ("1", "2"), {}, (1, 2), {}),
-    (valfix.posonly_marker, ("1",), {"b": "2"}, (1,), {"b": 2}),
-    (valfix.kwonly_marker, ("1",), {"b": "2"}, (1,), {"b": 2}),
-    (valfix.kwonly_marker, (), {"a": "1", "b": "2"}, (), {"a": 1, "b": 2}),
-    (valfix.only_markers, ("1",), {"b": "2", "c": "3"}, (1,), {"b": 2, "c": 3}),
-    (valfix.only_markers, ("1", "2"), {"c": "3"}, (1, 2), {"c": 3}),
-    (valfix.full, ("1", "2", "3", "4"), {"d": "5", "e": "6", "f": "7"}, (1, 2, 3, 4), {"d": 5, "e": 6, "f": 7}),
-]
-
-
-@pytest.mark.parametrize(
-    ("func", "args", "kwargs", "expected_args", "expected_kwargs"),
-    _parametrization,
-)
-def test_params_caster(func: Callable, args: tuple, kwargs: dict, expected_args: tuple, expected_kwargs: dict) -> None:
-    """Test the whole parameters casting helper class.
-
-    Parameters:
-        func: The function to work with.
-        args: The positional arguments to cast.
-        kwargs: The keyword arguments to cast.
-        expected_args: The expected positional arguments result.
-        expected_kwargs: The expected keyword arguments result.
-    """
-    caster = _get_params_caster(func, *args, **kwargs)
-    new_args, new_kwargs = caster.cast(*args, **kwargs)
-    assert new_args == expected_args
-    assert new_kwargs == expected_kwargs
-
-
-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
-        ...
-
-    caster = _get_params_caster(func, a="1")
-    _, kwargs = caster.cast(a="1")
-    assert kwargs == {"a": 1}