modwire-cli 1.0.0__py3-none-any.whl

modwire_cli/__init__.py

@@ -0,0 +1,6 @@
+"""Command-line runtime for the Modwire ecosystem."""
+
+from ._version import __version__
+from .main import cli
+
+__all__ = ["__version__", "cli"]

modwire_cli/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '1.0.0'
+__version_tuple__ = version_tuple = (1, 0, 0)
+
+__commit_id__ = commit_id = None

modwire_cli/main.py

@@ -0,0 +1,65 @@
+from pathlib import Path
+
+import click
+
+from modwire import Modwire
+from modwire.shared.config import ArchitectureConfig, BoundariesConfig, ShapeConfig
+from modwire_extraction import ModwireExtraction
+
+
+CONTEXT_SETTINGS = {"help_option_names": ["-h", "--help"]}
+
+
+def load_config(config_dir: Path | None) -> ArchitectureConfig:
+    if config_dir is None:
+        return ArchitectureConfig()
+    try:
+        boundaries = BoundariesConfig.from_yaml(
+            (config_dir / "boundaries.yaml").read_text(encoding="utf-8")
+        )
+        shape = ShapeConfig.from_yaml(
+            (config_dir / "shape.yaml").read_text(encoding="utf-8")
+        )
+    except Exception as error:
+        raise click.ClickException(f"Unable to load configuration: {error}") from error
+    return ArchitectureConfig(boundaries=boundaries, shape=shape)
+
+
+@click.group(context_settings=CONTEXT_SETTINGS)
+@click.option(
+    "--config-dir",
+    "-d",
+    type=click.Path(exists=True, file_okay=False, path_type=Path),
+    help="Directory containing boundaries.yaml and shape.yaml.",
+)
+@click.version_option(package_name="modwire-cli", prog_name="modwire")
+@click.pass_context
+def cli(context: click.Context, config_dir: Path | None) -> None:
+    """Print Modwire architecture reports."""
+
+    context.obj = load_config(config_dir)
+
+
+@cli.group()
+def architecture() -> None:
+    """Print architecture catalog and health reports."""
+
+
+@architecture.command()
+@click.pass_obj
+def reports(config: ArchitectureConfig) -> None:
+    click.echo(Modwire().architecture(config).reports().to_json())
+
+
+@architecture.command()
+@click.argument("root", type=click.Path(exists=True, file_okay=False, path_type=Path))
+@click.argument("language")
+@click.pass_obj
+def health(config: ArchitectureConfig, root: Path, language: str) -> None:
+    try:
+        code_map = ModwireExtraction(root).generate_queryable_map(language)
+        report_nodes = Modwire().architecture(config).report(code_map)
+    except Exception as error:
+        raise click.ClickException(f"Unable to produce reports: {error}") from error
+    for report in report_nodes:
+        click.echo(report.to_json())

modwire_cli/py.typed

@@ -0,0 +1 @@
+

modwire_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: modwire-cli
+Version: 1.0.0
+Summary: Command-line runtime for the Modwire ecosystem.
+Author: Tomasz Szpak
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/modwire/modwire-cli
+Project-URL: Repository, https://github.com/modwire/modwire-cli
+Project-URL: Issues, https://github.com/modwire/modwire-cli/issues
+Project-URL: Changelog, https://github.com/modwire/modwire-cli/blob/main/CHANGELOG.md
+Keywords: architecture,cli,code-analysis,modwire,static-analysis
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: modwire<6,>=5
+Requires-Dist: modwire-extraction<3,>=2
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.8; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Dynamic: license-file
+
+# modwire-cli
+
+The thin command-line reporter for the Modwire ecosystem. It extracts a source
+map, calls Modwire, and prints Modwire's reports.
+
+## Installation
+
+```bash
+python -m pip install modwire-cli
+```
+
+Python 3.12 or newer is required.
+
+## Usage
+
+```bash
+modwire architecture reports
+modwire --config-dir .modwire architecture health src python
+```
+
+For development:
+
+```bash
+uv sync --all-groups
+uv run pytest
+uv build
+```
+
+Run the same checks used by CI with `make verify`.
+
+## Release
+
+Releases use strict `vX.Y.Z` tags. Before creating the first release, configure
+the `pypi` environment and a Trusted Publisher for the `modwire/modwire-cli`
+GitHub repository on PyPI. Then publish a GitHub release:
+
+```bash
+gh release create v1.0.0 --target main --generate-notes --title v1.0.0
+```
+
+The release workflow verifies the tag and distribution metadata, publishes to
+PyPI without a long-lived token, and attaches the distributions to the release.

modwire_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+modwire_cli/__init__.py,sha256=fn0qYs4J3CaCZcCUK4oUL6RGH7Ifl3JPA6Eyrj9yx_s,145
+modwire_cli/_version.py,sha256=JAAyU3al4wmBf3BF-Umm1J_GrCIT-yS_yWEGHqKRVHc,520
+modwire_cli/main.py,sha256=MvWGpjmXPrealuT8qyv2K6km8z3KO6NYYvqmhsDbe24,2140
+modwire_cli/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+modwire_cli-1.0.0.dist-info/licenses/LICENSE,sha256=DxXQa2s8pS_YG13iuO5CsomZ7N2BQc8BA41Il8nu5F4,1069
+modwire_cli-1.0.0.dist-info/METADATA,sha256=LKWsxaTSMgAfYBn9f6eSm3VM3xUDdikLHAG8Z37kZdg,2416
+modwire_cli-1.0.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+modwire_cli-1.0.0.dist-info/entry_points.txt,sha256=4b52m8nrabKD6g3wwsxi5D1LOndxPxAG96NqMhrLmJQ,44
+modwire_cli-1.0.0.dist-info/scm_file_list.json,sha256=IJ6W1-nziLwk-yqtnEyRJDi0jlEB8yJ87E4jbIZUPd0,679
+modwire_cli-1.0.0.dist-info/scm_version.json,sha256=a3dOJsC5TN-huuWvYubLbeliUABJu6gXy_JH4XdPABM,160
+modwire_cli-1.0.0.dist-info/top_level.txt,sha256=YPg1MUQZIrur2bqK66KoW1TYkyVHty5C_YQVijq6kCg,12
+modwire_cli-1.0.0.dist-info/RECORD,,

modwire_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

modwire_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+modwire = modwire_cli:cli

modwire_cli-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tomasz Szpak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

modwire_cli-1.0.0.dist-info/scm_file_list.json

@@ -0,0 +1,26 @@
+{
+  "files": [
+    "README.md",
+    "uv.lock",
+    "Makefile",
+    "LICENSE",
+    "pyproject.toml",
+    "CHANGELOG.md",
+    "MANIFEST.in",
+    ".gitignore",
+    "scripts/verify_release.py",
+    "src/modwire_cli/py.typed",
+    "src/modwire_cli/__init__.py",
+    "src/modwire_cli/main.py",
+    "tests/test_release.py",
+    "tests/test_cli.py",
+    ".github/ISSUE_TEMPLATE/bug_report.yml",
+    ".github/ISSUE_TEMPLATE/config.yml",
+    ".github/ISSUE_TEMPLATE/feature_request.yml",
+    ".github/ISSUE_TEMPLATE/task.yml",
+    ".github/workflows/release.yml",
+    ".github/workflows/issue-metadata.yml",
+    ".github/workflows/ci.yml",
+    ".github/workflows/human-approval.yml"
+  ]
+}

modwire_cli-1.0.0.dist-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.0.0",
+  "distance": 0,
+  "node": "ge8788a19e31ac9acfb144e2a8fae312c4797ca9e",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-07-12"
+}

modwire_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+modwire_cli