invoke-tasklib 0.0.3a0__tar.gz → 0.0.7__tar.gz

{invoke_tasklib-0.0.3a0 → invoke_tasklib-0.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: invoke-tasklib
-Version: 0.0.3a0
+Version: 0.0.7
 Summary: Reusable Invoke tasks shared across Python projects.
 Project-URL: Homepage, https://github.com/durandtibo/invoke-tasklib
 Project-URL: Repository, https://github.com/durandtibo/invoke-tasklib
@@ -128,7 +128,7 @@ tasklib:
 
 ```shell
 invoke --list
-invoke format.check-python lint.check-lint
+invoke format.check-python lint.check-python
 invoke test.unit
 ```
 
@@ -152,8 +152,9 @@ Tasks are grouped into namespaces, one per module. Each task either
 | `format`      | `format.fix-docstrings`       | Format docstrings with docformatter                                                      |    ✅    |
 | `format`      | `format.check-shell`          | Check shell scripts with shellcheck                                                      |    ❌    |
 | `format`      | `format.fix-shell`            | Format shell scripts with shfmt                                                          |    ✅    |
-| `lint`        | `lint.check-lint`             | Check linting with ruff                                                                  |    ❌    |
-| `lint`        | `lint.fix`                    | Fix auto-fixable linting issues with ruff                                                |    ✅    |
+| `lint`        | `lint.check-python`           | Check linting with ruff                                                                  |    ❌    |
+| `lint`        | `lint.fix-python`             | Fix auto-fixable linting issues with ruff                                                |    ✅    |
+| `imports`     | `imports.check-cycles`        | Check for cyclic import dependencies                                                     |    ❌    |
 | `types`       | `types.check`                 | Check type hints with pyright                                                            |    ❌    |
 | `test`        | `test.doctest`                | Run doctests on source code and markdown files                                           |    ❌    |
 | `test`        | `test.doctest-src`            | Run doctests on source code                                                              |    ❌    |

{invoke_tasklib-0.0.3a0 → invoke_tasklib-0.0.7}/README.md

@@ -100,7 +100,7 @@ tasklib:
 
 ```shell
 invoke --list
-invoke format.check-python lint.check-lint
+invoke format.check-python lint.check-python
 invoke test.unit
 ```
 
@@ -124,8 +124,9 @@ Tasks are grouped into namespaces, one per module. Each task either
 | `format`      | `format.fix-docstrings`       | Format docstrings with docformatter                                                      |    ✅    |
 | `format`      | `format.check-shell`          | Check shell scripts with shellcheck                                                      |    ❌    |
 | `format`      | `format.fix-shell`            | Format shell scripts with shfmt                                                          |    ✅    |
-| `lint`        | `lint.check-lint`             | Check linting with ruff                                                                  |    ❌    |
-| `lint`        | `lint.fix`                    | Fix auto-fixable linting issues with ruff                                                |    ✅    |
+| `lint`        | `lint.check-python`           | Check linting with ruff                                                                  |    ❌    |
+| `lint`        | `lint.fix-python`             | Fix auto-fixable linting issues with ruff                                                |    ✅    |
+| `imports`     | `imports.check-cycles`        | Check for cyclic import dependencies                                                     |    ❌    |
 | `types`       | `types.check`                 | Check type hints with pyright                                                            |    ❌    |
 | `test`        | `test.doctest`                | Run doctests on source code and markdown files                                           |    ❌    |
 | `test`        | `test.doctest-src`            | Run doctests on source code                                                              |    ❌    |

{invoke_tasklib-0.0.3a0 → invoke_tasklib-0.0.7}/invoke_tasklib/__init__.py

@@ -28,6 +28,7 @@ from invoke_tasklib import (
     doc,
     env,
     format,  # noqa: A004
+    imports,
     lint,
     release,
     security,
@@ -40,6 +41,7 @@ __all__ = [
     "doc",
     "env",
     "format",
+    "imports",
     "lint",
     "ns",
     "release",
@@ -51,6 +53,7 @@ __all__ = [
 ns: Collection = Collection()
 ns.add_collection(Collection.from_module(format), name="format")
 ns.add_collection(Collection.from_module(lint), name="lint")
+ns.add_collection(Collection.from_module(imports), name="imports")
 ns.add_collection(Collection.from_module(types), name="types")
 ns.add_collection(Collection.from_module(test), name="test")
 ns.add_collection(Collection.from_module(env), name="env")

invoke_tasklib-0.0.7/invoke_tasklib/imports.py

@@ -0,0 +1,47 @@
+r"""Import-graph tasks."""
+
+from __future__ import annotations
+
+import logging
+import shlex
+from typing import TYPE_CHECKING
+
+from invoke.tasks import task
+
+from invoke_tasklib.config import get_config
+
+if TYPE_CHECKING:
+    from invoke.context import Context
+
+logger: logging.Logger = logging.getLogger(__name__)
+
+
+@task
+def check_cycles(c: Context) -> None:
+    r"""Check for cyclic import dependencies by importing each subpackage
+    in isolation.
+
+    Subpackages are discovered dynamically instead of relying on a hand-
+    maintained list, so newly added subpackages are automatically
+    covered.
+    """
+    cfg = get_config(c)
+    name = cfg["package"]["name"]
+    logger.info(f"🔍 Discovering subpackages of {name}...")
+    discover_script = (
+        "import importlib, pkgutil, sys\n"
+        "name = sys.argv[1]\n"
+        "package = importlib.import_module(name)\n"
+        "names = [name] + sorted(\n"
+        "    n for _, n, ispkg in pkgutil.walk_packages(package.__path__, prefix=f'{name}.')\n"
+        "    if ispkg\n"
+        ")\n"
+        "print('\\n'.join(names))\n"
+    )
+    discover = c.run(f"python -c {shlex.quote(discover_script)} {name}", hide=True)
+    modules = [line for line in discover.stdout.splitlines() if line]
+    logger.info(f"🔍 Checking {len(modules)} module(s) for cyclic imports...")
+    for module in modules:
+        logger.info(f"🔍 Checking: {module}")
+        c.run(f"python -c {shlex.quote(f'import {module}')}", pty=True)
+    logger.info(f"✅ All {len(modules)} module(s) imported without cyclic dependency errors")

{invoke_tasklib-0.0.3a0 → invoke_tasklib-0.0.7}/invoke_tasklib/lint.py

@@ -14,7 +14,7 @@ logger: logging.Logger = logging.getLogger(__name__)
 
 
 @task
-def check_lint(c: Context) -> None:
+def check_python(c: Context) -> None:
     r"""Check code linting with ruff."""
     logger.info("🔍 Checking code linting with ruff...")
     c.run("ruff check --output-format=github .", pty=True)
@@ -22,7 +22,7 @@ def check_lint(c: Context) -> None:
 
 
 @task
-def fix(c: Context) -> None:
+def fix_python(c: Context) -> None:
     r"""Fix auto-fixable linting issues in place with ruff.
 
     Note:

{invoke_tasklib-0.0.3a0 → invoke_tasklib-0.0.7}/pyproject.toml

@@ -10,7 +10,7 @@ only-include = ["src"]
 
 [project]
 name = "invoke-tasklib"
-version = "0.0.3a0"
+version = "0.0.7"
 description = "Reusable Invoke tasks shared across Python projects."
 readme = "README.md"
 authors = [