modwire 1.0.0__tar.gz

modwire-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,59 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  test:
+    name: Test on Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "8.3"
+
+      - name: Clean packaging artifacts
+        run: rm -rf .dev build dist src/*.egg-info
+
+      - name: Install package and packaging tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .[dev]
+
+      - name: Run unit tests
+        run: python -m pytest
+
+      - name: Validate extractor syntax
+        run: |
+          node --check src/modwire/extractors/scripts/typescript_extractor.js
+          php -l src/modwire/extractors/scripts/php_extractor.php
+
+      - name: Build distributions
+        run: python -m build --outdir dist
+
+      - name: Check distribution metadata
+        run: python -m twine check dist/*

modwire-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,215 @@
+name: Release
+
+on:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and verify release artifacts
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check out release tag
+        if: github.event_name == 'release'
+        run: |
+          git fetch --force --tags origin "refs/tags/${{ github.event.release.tag_name }}:refs/tags/${{ github.event.release.tag_name }}"
+          git -c advice.detachedHead=false checkout --force "refs/tags/${{ github.event.release.tag_name }}"
+          git clean -ffdx
+
+      - name: Verify release checkout
+        if: github.event_name == 'release'
+        run: |
+          tag_name="${{ github.event.release.tag_name }}"
+          tag_sha="$(git rev-list -n 1 "$tag_name")"
+          head_sha="$(git rev-parse HEAD)"
+
+          echo "Release tag: $tag_name"
+          echo "Tag commit: $tag_sha"
+          echo "HEAD commit: $head_sha"
+          git describe --tags --dirty --always
+
+          if [ "$head_sha" != "$tag_sha" ]; then
+            echo "Release checkout mismatch: HEAD is not the release tag commit." >&2
+            exit 1
+          fi
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "8.3"
+
+      - name: Clean packaging artifacts
+        run: rm -rf .dev build dist src/*.egg-info
+
+      - name: Install package and release tooling
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .[dev]
+
+      - name: Verify release tag matches derived package version
+        if: github.event_name == 'release'
+        run: |
+          python - <<'PY'
+          import sys
+          from importlib.metadata import version
+
+          package_version = version("modwire")
+          tag_name = "${{ github.event.release.tag_name }}"
+          expected_tag = f"v{package_version}"
+
+          if tag_name != expected_tag:
+              print(
+                  f"Release tag/version mismatch: tag is '{tag_name}' but derived package version is '{package_version}'. Expected tag '{expected_tag}'.",
+                  file=sys.stderr,
+              )
+              raise SystemExit(1)
+
+          print(f"Verified release tag {tag_name} matches package version {package_version}.")
+          PY
+
+      - name: Run tests
+        run: python -m pytest
+
+      - name: Validate extractor syntax
+        run: |
+          node --check src/modwire/extractors/scripts/typescript_extractor.js
+          php -l src/modwire/extractors/scripts/php_extractor.php
+
+      - name: Build distributions
+        run: python -m build --outdir dist
+
+      - name: Verify built artifact version
+        if: github.event_name == 'release'
+        run: |
+          python - <<'PY'
+          import sys
+          import zipfile
+          from email.parser import Parser
+          from pathlib import Path
+
+          expected_version = "${{ github.event.release.tag_name }}".removeprefix("v")
+          wheels = sorted(Path("dist").glob("*.whl"))
+          versions: dict[str, str] = {}
+
+          for wheel in wheels:
+              with zipfile.ZipFile(wheel) as archive:
+                  metadata_name = next(
+                      name for name in archive.namelist()
+                      if name.endswith(".dist-info/METADATA")
+                  )
+                  metadata = Parser().parsestr(
+                      archive.read(metadata_name).decode("utf-8")
+                  )
+              versions[metadata["Name"]] = metadata["Version"]
+
+          package_version = versions.get("modwire")
+          if package_version != expected_version:
+              print(
+                  f"Built artifact version mismatch: modwire is "
+                  f"'{package_version}' but release tag expects "
+                  f"'{expected_version}'.",
+                  file=sys.stderr,
+              )
+              raise SystemExit(1)
+
+          print(f"Verified built artifact matches {expected_version}.")
+          PY
+
+      - name: Check distribution metadata
+        run: python -m twine check dist/*
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+  github-release-assets:
+    name: Attach artifacts to GitHub release
+    if: github.event_name == 'release'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Upload release assets
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    if: github.event_name == 'release' && github.event.release.prerelease
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/modwire/
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to TestPyPI with Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    name: Publish to PyPI
+    if: github.event_name == 'release' && !github.event.release.prerelease
+    needs:
+      - build
+      - github-release-assets
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/modwire/
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI with Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@release/v1

modwire-1.0.0/.gitignore

@@ -0,0 +1,10 @@
+.dev/
+.pytest_cache/
+.ruff_cache/
+.venv/
+build/
+dist/
+src/*.egg-info/
+src/modwire/_version.py
+__pycache__/
+*.py[cod]

modwire-1.0.0/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-1.0.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: modwire
+Version: 1.0.0
+Summary: Extract source-code dependencies and build dependency graphs.
+Author: Tomasz Szpak
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/9orky/codemap
+Project-URL: Repository, https://github.com/9orky/codemap
+Project-URL: Issues, https://github.com/9orky/codemap/issues
+Keywords: architecture,code-analysis,dependency-graph,static-analysis
+Classifier: Development Status :: 3 - Alpha
+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.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.8
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: ruff>=0.8; extra == "dev"
+Requires-Dist: twine>=5.1; extra == "dev"
+Dynamic: license-file
+
+# modwire
+
+`modwire` extracts source-code structure and import dependencies from Python,
+TypeScript/JavaScript, and PHP projects. It returns typed Python objects that
+you can use to build dependency graphs, inspect symbols, and evaluate
+architecture rules.
+
+## Installation
+
+```bash
+python -m pip install modwire
+```
+
+The Python extractor works with Python alone. TypeScript/JavaScript extraction
+requires Node.js at runtime, and PHP extraction requires PHP at runtime.
+
+## Quick Start
+
+```python
+from pathlib import Path
+
+from modwire import extract_code
+
+result = extract_code(
+    "python",
+    Path("src"),
+    exclusions=("**/__pycache__/**",),
+)
+
+print(result.extraction_result.summary.files_checked)
+print(result.graph.node_ids())
+print([(edge.from_id, edge.to_id) for edge in result.graph.edges])
+```
+
+Graph nodes use canonical extensionless source IDs, so equivalent Python,
+TypeScript, and PHP projects can be compared through the same graph shape.
+
+## Supported Languages
+
+```python
+from modwire import supported_languages
+
+print(supported_languages())
+# ("python", "typescript", "php")
+```
+
+Language-specific source IDs can be normalized without running a full
+extraction:
+
+```python
+from modwire import normalize_source_id
+
+print(normalize_source_id("typescript", "src/view.tsx"))
+# "src/view"
+```
+
+## Architecture Policy API
+
+`modwire.architecture` exposes policy evaluation helpers for checking import
+boundaries and common dependency-flow rules.
+
+```python
+from modwire.architecture import ArchitecturePolicyEvaluator, supported_analyzers
+
+print(supported_analyzers())
+# ("backward-flow", "no-reentry", "no-cycles")
+
+evaluator = ArchitecturePolicyEvaluator()
+```
+
+## Development
+
+```bash
+uv run ruff check
+uv run pytest
+uv run python -m build --outdir dist
+uv run twine check dist/*
+```

modwire-1.0.0/README.md

@@ -0,0 +1,78 @@
+# modwire
+
+`modwire` extracts source-code structure and import dependencies from Python,
+TypeScript/JavaScript, and PHP projects. It returns typed Python objects that
+you can use to build dependency graphs, inspect symbols, and evaluate
+architecture rules.
+
+## Installation
+
+```bash
+python -m pip install modwire
+```
+
+The Python extractor works with Python alone. TypeScript/JavaScript extraction
+requires Node.js at runtime, and PHP extraction requires PHP at runtime.
+
+## Quick Start
+
+```python
+from pathlib import Path
+
+from modwire import extract_code
+
+result = extract_code(
+    "python",
+    Path("src"),
+    exclusions=("**/__pycache__/**",),
+)
+
+print(result.extraction_result.summary.files_checked)
+print(result.graph.node_ids())
+print([(edge.from_id, edge.to_id) for edge in result.graph.edges])
+```
+
+Graph nodes use canonical extensionless source IDs, so equivalent Python,
+TypeScript, and PHP projects can be compared through the same graph shape.
+
+## Supported Languages
+
+```python
+from modwire import supported_languages
+
+print(supported_languages())
+# ("python", "typescript", "php")
+```
+
+Language-specific source IDs can be normalized without running a full
+extraction:
+
+```python
+from modwire import normalize_source_id
+
+print(normalize_source_id("typescript", "src/view.tsx"))
+# "src/view"
+```
+
+## Architecture Policy API
+
+`modwire.architecture` exposes policy evaluation helpers for checking import
+boundaries and common dependency-flow rules.
+
+```python
+from modwire.architecture import ArchitecturePolicyEvaluator, supported_analyzers
+
+print(supported_analyzers())
+# ("backward-flow", "no-reentry", "no-cycles")
+
+evaluator = ArchitecturePolicyEvaluator()
+```
+
+## Development
+
+```bash
+uv run ruff check
+uv run pytest
+uv run python -m build --outdir dist
+uv run twine check dist/*
+```

modwire-1.0.0/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["setuptools>=77", "setuptools-scm[toml]>=8", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "modwire"
+description = "Extract source-code dependencies and build dependency graphs."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+dynamic = ["version"]
+authors = [
+    {name = "Tomasz Szpak"},
+]
+keywords = [
+    "architecture",
+    "code-analysis",
+    "dependency-graph",
+    "static-analysis",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "pydantic>=2.8",
+]
+
+[project.urls]
+Homepage = "https://github.com/9orky/codemap"
+Repository = "https://github.com/9orky/codemap"
+Issues = "https://github.com/9orky/codemap/issues"
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.2",
+    "pytest>=8.0",
+    "ruff>=0.8",
+    "twine>=5.1",
+]
+
+[dependency-groups]
+dev = [
+    "build>=1.2",
+    "pytest>=8.0",
+    "ruff>=0.8",
+    "twine>=5.1",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+cache_dir = ".dev/pytest_cache"
+
+[tool.ruff]
+cache-dir = ".dev/ruff_cache"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+modwire = [
+    "extractors/scripts/*",
+]
+
+[tool.setuptools_scm]
+fallback_version = "0.0.0.dev0"
+local_scheme = "no-local-version"
+version_file = "src/modwire/_version.py"

modwire-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

modwire-1.0.0/show_test_source_files.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+
+PACKAGE_ROOT = Path(__file__).parent
+APPS_ROOT = PACKAGE_ROOT / "tests" / "apps"
+
+sys.path.insert(0, str(PACKAGE_ROOT / "src"))
+
+from modwire import extract_code  # noqa: E402
+
+
+def main() -> int:
+    for language in ("python", "typescript", "php"):
+        result = extract_code(language, APPS_ROOT / language, ("ignored/**",))
+        print(f"\n=== {language.upper()} SourceFile JSONs ===")
+        for source_id, source_file in sorted(result.extraction_result.files.items()):
+            print(f"\n--- {source_id} ---")
+            print(json.dumps(source_file.model_dump(), indent=2))
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

modwire-1.0.0/src/modwire/__init__.py

@@ -0,0 +1,15 @@
+from .extraction import CodeMap, extract_code
+from .extractors.loader import normalize_source_id, supported_languages
+from .graph import DependencyGraph, Edge, Node, build_dependency_graph
+
+
+__all__ = [
+    "CodeMap",
+    "DependencyGraph",
+    "Edge",
+    "Node",
+    "build_dependency_graph",
+    "extract_code",
+    "normalize_source_id",
+    "supported_languages",
+]

modwire-1.0.0/src/modwire/_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 = 'gb2874aa61'

modwire-1.0.0/src/modwire/architecture/__init__.py

@@ -0,0 +1,10 @@
+from .analyzers import supported_analyzers
+from .policy import ArchitecturePolicyEvaluator
+from .violations import EdgeRuleViolation, FlowViolation
+
+__all__ = [
+    "ArchitecturePolicyEvaluator",
+    "EdgeRuleViolation",
+    "FlowViolation",
+    "supported_analyzers",
+]