modwire 1.0.0__py3-none-any.whl

modwire/extractors/typescript.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from posixpath import normpath
+from pathlib import PurePosixPath
+
+from ..definitions import SourceImport
+from .base import SourceExtractor
+
+
+@dataclass(frozen=True)
+class TypeScriptExtractor(SourceExtractor):
+    language = "typescript"
+    file_extensions = (".ts", ".tsx", ".js", ".jsx")
+    command = "node"
+    extractor_file = "typescript_extractor.js"
+
+    def normalize_import(
+        self,
+        source_id: str,
+        source_import: SourceImport,
+        known_source_ids: set[str],
+    ) -> SourceImport:
+        normalized_path = source_import.normalized_path
+        if source_import.is_relative:
+            normalized_path = normpath(
+                PurePosixPath(source_id).parent.joinpath(source_import.path).as_posix()
+            )
+            normalized_path = self.normalize_source_id(normalized_path)
+
+        return SourceImport(
+            path=source_import.path,
+            is_relative=source_import.is_relative,
+            normalized_path=normalized_path,
+            imported_name=source_import.imported_name,
+            is_aliased=source_import.is_aliased,
+            crossing_type=source_import.crossing_type,
+            file_barrier_crossed=(
+                source_import.file_barrier_crossed
+                and normalized_path in known_source_ids
+            ),
+            statement_id=source_import.statement_id,
+            join_key=normalized_path if source_import.join_key else "",
+            uses_joined_import=source_import.uses_joined_import,
+        )
+
+
+__all__ = ["TypeScriptExtractor"]

modwire/graph.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from .definitions import SourceFile
+
+
+@dataclass(frozen=True)
+class Node:
+    id: str
+    kind: str = "file"
+
+
+@dataclass(frozen=True)
+class Edge:
+    from_id: str
+    to_id: str
+    kind: str = "import"
+
+
+@dataclass
+class DependencyGraph:
+    nodes: dict[str, Node] = field(default_factory=dict)
+    edges: list[Edge] = field(default_factory=list)
+    _outgoing_by_node: dict[str, list[Edge]] = field(default_factory=dict)
+
+    def add_node(self, node_id: str, *, kind: str = "file") -> None:
+        self.nodes.setdefault(node_id, Node(id=node_id, kind=kind))
+        self._outgoing_by_node.setdefault(node_id, [])
+
+    def add_edge(self, from_id: str, to_id: str, *, kind: str = "import") -> None:
+        self.add_node(from_id)
+        self.add_node(to_id)
+        edge = Edge(from_id=from_id, to_id=to_id, kind=kind)
+        self.edges.append(edge)
+        self._outgoing_by_node[from_id].append(edge)
+
+    def outgoing(self, node_id: str) -> tuple[Edge, ...]:
+        return tuple(self._outgoing_by_node.get(node_id, ()))
+
+    def node_ids(self) -> tuple[str, ...]:
+        return tuple(self.nodes.keys())
+
+
+def build_dependency_graph(extracted_files: dict[str, SourceFile]) -> DependencyGraph:
+    graph = DependencyGraph()
+
+    for file_path, extracted_file in extracted_files.items():
+        graph.add_node(file_path)
+        for imported_reference in extracted_file.imports:
+            graph.add_edge(file_path, imported_reference.normalized_path)
+
+    return graph
+
+
+__all__ = ["DependencyGraph", "build_dependency_graph"]

modwire-1.0.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,25 @@
+modwire/__init__.py,sha256=_oDaQwkrK3-oMb6h51B4gur_xP36HgA5NqTQI_cKBnY,371
+modwire/_version.py,sha256=JAAyU3al4wmBf3BF-Umm1J_GrCIT-yS_yWEGHqKRVHc,520
+modwire/definitions.py,sha256=4YXHhEbL2szHPfeH6ps_Iy0o7yLe28gjAjBeu-kxH-o,2486
+modwire/extraction.py,sha256=pfNxJshpE7Qzfryg5vI7-5b5J8MwEzBBiFwyPbwJ4ak,2154
+modwire/graph.py,sha256=qRTAqd5yPyKIzqQinr0dMAxHdwj2guIJ3iaD76NuDbQ,1614
+modwire/architecture/__init__.py,sha256=qGcakDv6b-CLQe6DGTD_cKlpASom0Gh3cF1A5Ddp-ts,271
+modwire/architecture/analyzers.py,sha256=_3vj7PFwLBgEfLD_XlkvV0X7NbYIoRSlRff3pY7pXoE,4432
+modwire/architecture/matching.py,sha256=ZP-L21kON7WpMlSenP_m5NgFj3GC1fHLYjGphsuj8pI,1951
+modwire/architecture/policy.py,sha256=ut7_UvKfCG-oqGfO2U1tbYXzHEfPgyQiidMzKA-Ewzg,2273
+modwire/architecture/render.py,sha256=Yk7OxBLgNjsc6ZqfhrwlTV293ABQqR0HZbODReM15I8,3145
+modwire/architecture/violations.py,sha256=LQBxvKr4jx4U_6G3J8NpM1-eRJs23IWCzEyHNuayPkM,415
+modwire/extractors/__init__.py,sha256=xI7e031XWEcMVx2e3gQdAQNI7VQa2iBc_GXV6fQ3sZI,118
+modwire/extractors/base.py,sha256=Sp7Hr5QshAr8ByOnaP2juiG4sfNIB-B-car5GmBEU-g,5230
+modwire/extractors/loader.py,sha256=Ag21zdjGWRSiaADDi59GQzlDZ33dhDcvGo-b6h-AwWU,830
+modwire/extractors/php.py,sha256=b1I7qQDPzgSQUZkJUtGfOW_S6aHR9_Jvhs2umLPf6Oc,5650
+modwire/extractors/python.py,sha256=pubG6JlFi7OKueGTw9fLZN89pYF1sJ3dqBlD-FwNP8M,3914
+modwire/extractors/typescript.py,sha256=M6tkD_CbBQfNxk-UJQ8mHlenT5hzYN1xBOLO9v9_rQc,1612
+modwire/extractors/scripts/php_extractor.php,sha256=xwqECd0weYIU5vQpLxFpW6g0jzr64N1FU9vFdffhR6w,28525
+modwire/extractors/scripts/python_extractor.py,sha256=EeI-bqA9DTYH78w-lUpILHuT8bJ2o81TvwwwPRAvvTM,13571
+modwire/extractors/scripts/typescript_extractor.js,sha256=xGxr8U9pdCtqsC0XRugd-6iV6o8KbWIYy7derBcPI4I,34074
+modwire-1.0.0.dist-info/licenses/LICENSE,sha256=DxXQa2s8pS_YG13iuO5CsomZ7N2BQc8BA41Il8nu5F4,1069
+modwire-1.0.0.dist-info/METADATA,sha256=wPH6-9KSWz5UeQ7OasDQfPFqcnyedS4N-Dfz7fK4JI0,3154
+modwire-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+modwire-1.0.0.dist-info/top_level.txt,sha256=zqGajV2p9ic1QbDHG2XjTUsqg0h3YB3bHNyVkBykTHg,8
+modwire-1.0.0.dist-info/RECORD,,

modwire-1.0.0.dist-info/WHEEL

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

modwire-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-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+modwire