archunitpython 1.1.1__tar.gz → 1.2.0__tar.gz

archunitpython-1.2.0/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @LukasNiessen

archunitpython-1.2.0/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [LukasNiessen]

{archunitpython-1.1.1 → archunitpython-1.2.0}/.github/workflows/integrate.yaml

@@ -26,12 +26,16 @@ jobs:
                       pip-${{ runner.os }}-${{ matrix.python-version }}-
             - name: Install dependencies
               run: pip install -e ".[dev]"
+            - name: Check release metadata
+              run: python scripts/check_release_metadata.py
             - name: Lint
-              run: ruff check src/
+              run: ruff check src/ scripts/
             - name: Type check
               run: mypy src/archunitpython/ --ignore-missing-imports
             - name: Test
               run: pytest --tb=short -q
+            - name: Build package
+              run: python -m build
 
     publish:
         if: github.ref == 'refs/heads/main' && github.event_name == 'push'

{archunitpython-1.1.1 → archunitpython-1.2.0}/.releaserc.json

@@ -12,7 +12,7 @@
 		[
 			"@semantic-release/exec",
 			{
-				"prepareCmd": "python -c \"import re, pathlib; files=[('pyproject.toml', r'(?m)^version = \\\"[^\\\"]+\\\"$', 'version = \\\"${nextRelease.version}\\\"'), ('src/archunitpython/__init__.py', r'(?m)^__version__ = \\\"[^\\\"]+\\\"$', '__version__ = \\\"${nextRelease.version}\\\"')]; [pathlib.Path(path).write_text(re.sub(pattern, replacement, pathlib.Path(path).read_text())) for path, pattern, replacement in files]\""
+				"prepareCmd": "python scripts/bump_release_version.py ${nextRelease.version}"
 			}
 		],
 		[

{archunitpython-1.1.1 → archunitpython-1.2.0}/BACKLOG.md

@@ -4,10 +4,10 @@ This backlog collects product and maintenance ideas from project research.
 
 ## P0 - Maintenance And Correctness
 
-- Keep package metadata synchronized across `pyproject.toml`, `CHANGELOG.md`, and `src/archunitpython/__init__.py`.
-- Keep tool configuration valid for the supported Python range, especially mypy and Ruff target versions.
-- Add a release metadata check that fails when the exported `__version__` differs from the project version.
-- Add CI jobs that run tests, Ruff, mypy, and a package build from a clean checkout.
+- [x] Keep package metadata synchronized across `pyproject.toml`, `CHANGELOG.md`, and `src/archunitpython/__init__.py`.
+- [x] Keep tool configuration valid for the supported Python range, especially mypy and Ruff target versions.
+- [x] Add a release metadata check that fails when the exported `__version__` differs from the project version.
+- [x] Add CI jobs that run tests, Ruff, mypy, and a package build from a clean checkout.
 
 ## P1 - Adoption Workflow
 

{archunitpython-1.1.1 → archunitpython-1.2.0}/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [1.2.0](https://github.com/LukasNiessen/ArchUnitPython/compare/v1.1.2...v1.2.0) (2026-06-27)
+
+
+### Features
+
+* add graph reporting and sponsorship links ([6d5eabc](https://github.com/LukasNiessen/ArchUnitPython/commit/6d5eabc1c1395c5bb4cf18e222ac472d33c02eb4))
+
+## [1.1.2](https://github.com/LukasNiessen/ArchUnitPython/compare/v1.1.1...v1.1.2) (2026-06-23)
+
+
+### Bug Fixes
+
+* fixed the duplicate key issue ([283e8e3](https://github.com/LukasNiessen/ArchUnitPython/commit/283e8e3aa959d235f331912e33a72bdbd62f3d31))
+* wrap long line in extract_graph to pass ruff E501 ([f291181](https://github.com/LukasNiessen/ArchUnitPython/commit/f291181336bacdd7a913187d2d26f1125f1b2a11))
+
 ## [1.1.1](https://github.com/LukasNiessen/ArchUnitPython/compare/v1.1.0...v1.1.1) (2026-05-24)
 
 

{archunitpython-1.1.1 → archunitpython-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: archunitpython
-Version: 1.1.1
+Version: 1.2.0
 Summary: Architecture testing library for Python projects. Enforce dependency rules, detect cycles, validate metrics.
 Project-URL: Homepage, https://github.com/LukasNiessen/ArchUnitPython
 Project-URL: Repository, https://github.com/LukasNiessen/ArchUnitPython.git
@@ -24,6 +24,7 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
 Requires-Dist: mypy>=1.0; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0; extra == 'dev'
 Requires-Dist: pytest>=7.0; extra == 'dev'
@@ -40,16 +41,19 @@ Description-Content-Type: text/markdown
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PyPI version](https://img.shields.io/pypi/v/archunitpython.svg)](https://pypi.org/project/archunitpython/)
-[![Python versions](https://img.shields.io/pypi/pyversions/archunitpython.svg)](https://pypi.org/project/archunitpython/)
+[![Downloads](https://static.pepy.tech/badge/archunitpython)](https://pepy.tech/project/archunitpython)
+[![Monthly downloads](https://static.pepy.tech/badge/archunitpython/month)](https://pepy.tech/project/archunitpython)
 [![GitHub stars](https://img.shields.io/github/stars/LukasNiessen/ArchUnitPython.svg)](https://github.com/LukasNiessen/ArchUnitPython)
 
 </div>
 
 Enforce architecture rules in Python projects. Check for dependency directions, detect circular dependencies, enforce coding standards and much more. Integrates with pytest and any other testing framework. Very simple setup and pipeline integration. Zero runtime dependencies.
 
+The #1 ArchUnit-style architecture testing library for Python, measured by GitHub stars.
+
 _Inspired by the amazing ArchUnit library but we are not affiliated with ArchUnit._
 
-[Setup](#-setup) • [Use Cases](#-use-cases) • [Features](#-features) • [Contributing](CONTRIBUTING.md)
+[Setup](#-setup) • [Use Cases](#-use-cases) • [Features](#-features) • [Why ArchUnitPython?](#-library-comparison) • [Contributing](CONTRIBUTING.md)
 
 ## ⚡ 5 min Quickstart
 
@@ -120,6 +124,22 @@ These tests run automatically in your testing setup, for example in your CI pipe
   run: pytest tests/test_architecture.py -v
 ```
 
+You can also export dependency graph reports as CI artifacts:
+
+```python
+from archunitpython import project_graph
+
+def test_generate_dependency_graph_reports():
+    graph = project_graph("src/").titled("Application Architecture")
+
+    graph.collapse_to_folder_depth(2).export_as_html(
+        "reports/dependency-graph.html"
+    )
+    graph.export_as_mermaid("reports/dependency-graph.mmd")
+
+    assert graph.snapshot().summary.node_count >= 0
+```
+
 ## 🚐 Setup
 
 Installation:
@@ -164,6 +184,7 @@ from archunitpython import CheckOptions
 options = CheckOptions(
     allow_empty_tests=True,  # Don't fail when no files match
     clear_cache=True,        # Clear the graph cache
+    ignore_type_checking_imports=True,  # Ignore imports inside if TYPE_CHECKING
 )
 
 violations = rule.check(options)
@@ -227,6 +248,65 @@ def test_business_not_depend_on_presentation():
     assert_passes(rule)
 ```
 
+### Named Layer Rules
+
+```python
+from archunitpython import project_layers
+
+def test_clean_architecture_layers():
+    rule = (
+        project_layers("src/")
+        .layer("presentation").defined_by_folder("**/presentation/**")
+        .layer("business").defined_by_folder("**/business/**")
+        .layer("database").defined_by_folder("**/database/**")
+        .where_layer("presentation")
+        .may_only_depend_on_layers("business")
+        .where_layer("business")
+        .may_only_depend_on_layers()
+        .where_layer("database")
+        .may_only_depend_on_layers()
+    )
+    assert_passes(rule)
+```
+
+### External Dependencies
+
+```python
+def test_domain_does_not_import_requests():
+    rule = (
+        project_files("src/")
+        .in_folder("**/domain/**")
+        .should_not()
+        .depend_on_external_modules()
+        .matching("requests")
+    )
+    assert_passes(rule)
+```
+
+### TYPE_CHECKING-aware Analysis
+
+```python
+from archunitpython import CheckOptions
+
+def test_type_only_dependencies_do_not_count_as_runtime_coupling():
+    rule = (
+        project_files("src/")
+        .in_folder("**/api/**")
+        .should_not()
+        .depend_on_files()
+        .in_folder("**/infrastructure/**")
+    )
+    assert_passes(rule, CheckOptions(ignore_type_checking_imports=True))
+```
+
+### Dynamic Imports and Ignore Directives
+
+ArchUnitPython detects string-based dynamic imports such as `importlib.import_module("my_app.adapters.sql")` and `__import__("my_app.adapters.sql")`. For known migration shims, you can suppress one import edge locally:
+
+```python
+from my_app.adapters.sql import Repository  # archunit: ignore
+```
+
 ### Naming Conventions
 
 ```python
@@ -349,6 +429,48 @@ def test_no_forbidden_dependency():
     assert_passes(rule)
 ```
 
+### Dependency Graph Reports
+
+Generate dependency graph reports in multiple formats and narrow them to the part of the codebase you want to inspect.
+
+```python
+from archunitpython import project_graph
+
+def test_export_dependency_graph_reports():
+    graph = project_graph("src/").titled("Application Architecture")
+
+    graph.collapse_to_folder_depth(2).export_as_mermaid(
+        "reports/dependencies.mmd"
+    )
+
+    graph.focus_on("**/domain/**", 1).export_as_html(
+        "reports/domain-dependencies.html"
+    )
+
+    assert graph.snapshot().summary.node_count >= 0
+```
+
+Supported formats:
+
+- DOT (`export_as_dot`, `to_dot`)
+- Mermaid (`export_as_mermaid`, `to_mermaid`)
+- D2 (`export_as_d2`, `to_d2`)
+- CSV (`export_as_csv`, `to_csv`)
+- JSON (`export_as_json`, `to_json`)
+- HTML (`export_as_html`, `to_html`)
+
+Graph exploration options:
+
+- `focus_on(pattern, depth)` keeps matching files and their neighbors.
+- `reachable_from(pattern)` keeps matching files and their transitive dependencies.
+- `dependents_of(pattern)` keeps files that transitively depend on the matching files.
+- `collapse_to_folder_depth(depth)` aggregates files to folder-level graph nodes.
+- `collapse_by_pattern(pattern, replacement)` maps files to custom graph nodes.
+- `include_external_dependencies()` includes imports to external modules such as `requests` or `sqlalchemy`.
+- `include_self_dependencies()` keeps self edges that are normally hidden in reports.
+
+When you create reports through `project_graph("src/")`, internal file paths are displayed relative to that project root so the output stays readable.
+
 ### Reports
 
 Generate HTML reports for your metrics. _Note that this feature is in beta._
@@ -528,6 +650,40 @@ def test_from_file():
     assert_passes(rule)
 ```
 
+## 📊 Library Comparison
+
+Here's how ArchUnitPython compares to other Python architecture-enforcement libraries.
+
+ArchUnitPython is optimized for **architecture rules as tests**: rules live next to your normal unit tests, run in pytest/unittest/CI, and fail with test-style violation messages. Broader CLI-first tools such as [Tach](https://github.com/tach-org/tach) and [Import Linter](https://github.com/seddonym/import-linter) are excellent adjacent tools, but they solve the problem through separate configuration and commands rather than a test-native ArchUnit-style API.
+
+| Feature | **ArchUnitPython** | **Tach** | **Import Linter** | **PyTestArch** |
+| ------- | ------------------ | -------- | ----------------- | -------------- |
+| **Primary workflow** | ✅ Architecture rules as unit tests | ⚠️ CLI + `tach.toml` | ⚠️ CLI + contracts config | ⚠️ pytest-oriented evaluable architecture |
+| **ArchUnit-style fluent API** | ✅ Yes | ❌ No | ❌ No | ⚠️ Partial |
+| **Testing framework integration** | ✅ pytest, unittest, any runner | ⚠️ CI/pre-commit CLI | ⚠️ CI/pre-commit CLI | ⚠️ pytest-focused |
+| **Zero runtime dependencies** | ✅ Standard library only | ⚠️ No app runtime impact, Rust-backed tool | ❌ Tool dependencies | ❌ Tool dependencies |
+| **Circular dependency detection** | ✅ First-class | ✅ First-class | ⚠️ Contract/graph based | ⚠️ Import-rule based |
+| **File/folder dependency rules** | ✅ Glob + regex | ✅ Module config | ✅ Import contracts | ✅ Module rules |
+| **Named layer rules** | ✅ `project_layers()` | ✅ Supported | ✅ Supported | ✅ Supported |
+| **External dependency rules** | ✅ `depend_on_external_modules()` | ⚠️ Internal module focus | ⚠️ Import contract focus | ⚠️ Internal import focus |
+| **TYPE_CHECKING-aware analysis** | ✅ Configurable | ⚠️ Not the core API | ⚠️ Not the core API | ⚠️ Not the core API |
+| **Dynamic import detection** | ✅ `importlib` + `__import__` string calls | ⚠️ Not the core workflow | ⚠️ Not the core workflow | ⚠️ Import analysis focused |
+| **Inline ignore directives** | ✅ `# archunit: ignore` | ✅ Supported | ⚠️ Config-based ignores | ⚠️ Rule/exclusion based |
+| **Naming convention checks** | ✅ Files and paths | ❌ No | ❌ No | ⚠️ Module-name oriented |
+| **Code metrics** | ✅ Counts, LCOM, distance metrics | ❌ No | ❌ No | ❌ No |
+| **Custom rules and metrics** | ✅ Full support | ❌ No | ⚠️ Custom contracts | ⚠️ Limited custom rule composition |
+| **PlantUML diagram validation** | ✅ Supported | ❌ No | ❌ No | ❌ No |
+| **Empty test protection** | ✅ Fails by default | ⚠️ Config validation | ⚠️ Contract validation | ⚠️ Not the main focus |
+| **Graph/reporting** | ✅ DOT, Mermaid, D2, CSV, JSON, HTML graph reports + metrics HTML | ✅ DOT, JSON, web graph | ✅ Browser UI | ⚠️ Optional graph visualization |
+| **Best fit** | Architecture tests, CI fitness functions, metrics, diagrams | Modular monolith dependency governance | Config-driven import contracts | pytest import-boundary checks |
+
+The most important differences:
+
+- **Test-native by design**: ArchUnitPython rules are just Python tests, so architecture decisions are reviewed, run, and debugged in the same workflow as the rest of your test suite.
+- **Broader rule surface**: dependency direction, cycles, layer policies, external modules, type-only imports, dynamic imports, naming, metrics, custom rules, and PlantUML validation live in one API.
+- **False-positive protection**: empty checks fail by default, which helps catch typos in file and folder patterns before they silently make your architecture tests meaningless.
+- **Quality beyond imports**: ArchUnitPython can enforce code metrics such as LCOM cohesion, field/method counts, abstractness, instability, and distance from the main sequence.
+
 ## 📢 Informative Error Messages
 
 When tests fail, you get helpful output with file paths and violation details:
@@ -589,6 +745,7 @@ The features of ArchUnitPython can very well be used as architectural fitness fu
 | **Files**   | File and folder based rules    | Stable       |
 | **Metrics** | Code quality metrics           | Stable       |
 | **Slices**  | Architecture slicing           | Stable       |
+| **Graph**   | Dependency graph reports       | Experimental |
 | **Testing** | Test framework integration     | Stable       |
 | **Common**  | Shared utilities               | Stable       |
 | **Reports** | Generate HTML reports          | Experimental |
@@ -599,7 +756,12 @@ We use ourselves to ensure the architectural rules for this repository.
 
 ## 🦊 Contributing
 
-We highly appreciate contributions. We use GitHub Flow, meaning that we use feature branches. As soon as something is merged or pushed to `main` it gets deployed. Versioning is automated via [Conventional Commits](https://www.conventionalcommits.org/). See more in [Contributing](CONTRIBUTING.md).
+We highly appreciate contributions. See [Contributing](CONTRIBUTING.md) for the full workflow.
+
+- Use feature branches and open pull requests against `main`.
+- Use [Conventional Commits](https://www.conventionalcommits.org/) so releases can be versioned automatically.
+- Do not bump versions manually for normal feature or fix work; semantic-release updates `pyproject.toml`, `src/archunitpython/__init__.py`, and `CHANGELOG.md`.
+- CI checks linting, typing, tests, package builds, and release metadata sync.
 
 ## ℹ️ FAQ
 
@@ -653,6 +815,7 @@ Found a bug? Want to discuss features?
 If ArchUnitPython helps your project, please consider:
 
 - Starring the repository 💚
+- Sponsoring development via [GitHub Sponsors](https://github.com/sponsors/LukasNiessen)
 - Suggesting new features 💭
 - Contributing code or documentation ⌨️
 

{archunitpython-1.1.1 → archunitpython-1.2.0}/README.md

@@ -8,16 +8,19 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PyPI version](https://img.shields.io/pypi/v/archunitpython.svg)](https://pypi.org/project/archunitpython/)
-[![Python versions](https://img.shields.io/pypi/pyversions/archunitpython.svg)](https://pypi.org/project/archunitpython/)
+[![Downloads](https://static.pepy.tech/badge/archunitpython)](https://pepy.tech/project/archunitpython)
+[![Monthly downloads](https://static.pepy.tech/badge/archunitpython/month)](https://pepy.tech/project/archunitpython)
 [![GitHub stars](https://img.shields.io/github/stars/LukasNiessen/ArchUnitPython.svg)](https://github.com/LukasNiessen/ArchUnitPython)
 
 </div>
 
 Enforce architecture rules in Python projects. Check for dependency directions, detect circular dependencies, enforce coding standards and much more. Integrates with pytest and any other testing framework. Very simple setup and pipeline integration. Zero runtime dependencies.
 
+The #1 ArchUnit-style architecture testing library for Python, measured by GitHub stars.
+
 _Inspired by the amazing ArchUnit library but we are not affiliated with ArchUnit._
 
-[Setup](#-setup) • [Use Cases](#-use-cases) • [Features](#-features) • [Contributing](CONTRIBUTING.md)
+[Setup](#-setup) • [Use Cases](#-use-cases) • [Features](#-features) • [Why ArchUnitPython?](#-library-comparison) • [Contributing](CONTRIBUTING.md)
 
 ## ⚡ 5 min Quickstart
 
@@ -88,6 +91,22 @@ These tests run automatically in your testing setup, for example in your CI pipe
   run: pytest tests/test_architecture.py -v
 ```
 
+You can also export dependency graph reports as CI artifacts:
+
+```python
+from archunitpython import project_graph
+
+def test_generate_dependency_graph_reports():
+    graph = project_graph("src/").titled("Application Architecture")
+
+    graph.collapse_to_folder_depth(2).export_as_html(
+        "reports/dependency-graph.html"
+    )
+    graph.export_as_mermaid("reports/dependency-graph.mmd")
+
+    assert graph.snapshot().summary.node_count >= 0
+```
+
 ## 🚐 Setup
 
 Installation:
@@ -132,6 +151,7 @@ from archunitpython import CheckOptions
 options = CheckOptions(
     allow_empty_tests=True,  # Don't fail when no files match
     clear_cache=True,        # Clear the graph cache
+    ignore_type_checking_imports=True,  # Ignore imports inside if TYPE_CHECKING
 )
 
 violations = rule.check(options)
@@ -195,6 +215,65 @@ def test_business_not_depend_on_presentation():
     assert_passes(rule)
 ```
 
+### Named Layer Rules
+
+```python
+from archunitpython import project_layers
+
+def test_clean_architecture_layers():
+    rule = (
+        project_layers("src/")
+        .layer("presentation").defined_by_folder("**/presentation/**")
+        .layer("business").defined_by_folder("**/business/**")
+        .layer("database").defined_by_folder("**/database/**")
+        .where_layer("presentation")
+        .may_only_depend_on_layers("business")
+        .where_layer("business")
+        .may_only_depend_on_layers()
+        .where_layer("database")
+        .may_only_depend_on_layers()
+    )
+    assert_passes(rule)
+```
+
+### External Dependencies
+
+```python
+def test_domain_does_not_import_requests():
+    rule = (
+        project_files("src/")
+        .in_folder("**/domain/**")
+        .should_not()
+        .depend_on_external_modules()
+        .matching("requests")
+    )
+    assert_passes(rule)
+```
+
+### TYPE_CHECKING-aware Analysis
+
+```python
+from archunitpython import CheckOptions
+
+def test_type_only_dependencies_do_not_count_as_runtime_coupling():
+    rule = (
+        project_files("src/")
+        .in_folder("**/api/**")
+        .should_not()
+        .depend_on_files()
+        .in_folder("**/infrastructure/**")
+    )
+    assert_passes(rule, CheckOptions(ignore_type_checking_imports=True))
+```
+
+### Dynamic Imports and Ignore Directives
+
+ArchUnitPython detects string-based dynamic imports such as `importlib.import_module("my_app.adapters.sql")` and `__import__("my_app.adapters.sql")`. For known migration shims, you can suppress one import edge locally:
+
+```python
+from my_app.adapters.sql import Repository  # archunit: ignore
+```
+
 ### Naming Conventions
 
 ```python
@@ -317,6 +396,48 @@ def test_no_forbidden_dependency():
     assert_passes(rule)
 ```
 
+### Dependency Graph Reports
+
+Generate dependency graph reports in multiple formats and narrow them to the part of the codebase you want to inspect.
+
+```python
+from archunitpython import project_graph
+
+def test_export_dependency_graph_reports():
+    graph = project_graph("src/").titled("Application Architecture")
+
+    graph.collapse_to_folder_depth(2).export_as_mermaid(
+        "reports/dependencies.mmd"
+    )
+
+    graph.focus_on("**/domain/**", 1).export_as_html(
+        "reports/domain-dependencies.html"
+    )
+
+    assert graph.snapshot().summary.node_count >= 0
+```
+
+Supported formats:
+
+- DOT (`export_as_dot`, `to_dot`)
+- Mermaid (`export_as_mermaid`, `to_mermaid`)
+- D2 (`export_as_d2`, `to_d2`)
+- CSV (`export_as_csv`, `to_csv`)
+- JSON (`export_as_json`, `to_json`)
+- HTML (`export_as_html`, `to_html`)
+
+Graph exploration options:
+
+- `focus_on(pattern, depth)` keeps matching files and their neighbors.
+- `reachable_from(pattern)` keeps matching files and their transitive dependencies.
+- `dependents_of(pattern)` keeps files that transitively depend on the matching files.
+- `collapse_to_folder_depth(depth)` aggregates files to folder-level graph nodes.
+- `collapse_by_pattern(pattern, replacement)` maps files to custom graph nodes.
+- `include_external_dependencies()` includes imports to external modules such as `requests` or `sqlalchemy`.
+- `include_self_dependencies()` keeps self edges that are normally hidden in reports.
+
+When you create reports through `project_graph("src/")`, internal file paths are displayed relative to that project root so the output stays readable.
+
 ### Reports
 
 Generate HTML reports for your metrics. _Note that this feature is in beta._
@@ -496,6 +617,40 @@ def test_from_file():
     assert_passes(rule)
 ```
 
+## 📊 Library Comparison
+
+Here's how ArchUnitPython compares to other Python architecture-enforcement libraries.
+
+ArchUnitPython is optimized for **architecture rules as tests**: rules live next to your normal unit tests, run in pytest/unittest/CI, and fail with test-style violation messages. Broader CLI-first tools such as [Tach](https://github.com/tach-org/tach) and [Import Linter](https://github.com/seddonym/import-linter) are excellent adjacent tools, but they solve the problem through separate configuration and commands rather than a test-native ArchUnit-style API.
+
+| Feature | **ArchUnitPython** | **Tach** | **Import Linter** | **PyTestArch** |
+| ------- | ------------------ | -------- | ----------------- | -------------- |
+| **Primary workflow** | ✅ Architecture rules as unit tests | ⚠️ CLI + `tach.toml` | ⚠️ CLI + contracts config | ⚠️ pytest-oriented evaluable architecture |
+| **ArchUnit-style fluent API** | ✅ Yes | ❌ No | ❌ No | ⚠️ Partial |
+| **Testing framework integration** | ✅ pytest, unittest, any runner | ⚠️ CI/pre-commit CLI | ⚠️ CI/pre-commit CLI | ⚠️ pytest-focused |
+| **Zero runtime dependencies** | ✅ Standard library only | ⚠️ No app runtime impact, Rust-backed tool | ❌ Tool dependencies | ❌ Tool dependencies |
+| **Circular dependency detection** | ✅ First-class | ✅ First-class | ⚠️ Contract/graph based | ⚠️ Import-rule based |
+| **File/folder dependency rules** | ✅ Glob + regex | ✅ Module config | ✅ Import contracts | ✅ Module rules |
+| **Named layer rules** | ✅ `project_layers()` | ✅ Supported | ✅ Supported | ✅ Supported |
+| **External dependency rules** | ✅ `depend_on_external_modules()` | ⚠️ Internal module focus | ⚠️ Import contract focus | ⚠️ Internal import focus |
+| **TYPE_CHECKING-aware analysis** | ✅ Configurable | ⚠️ Not the core API | ⚠️ Not the core API | ⚠️ Not the core API |
+| **Dynamic import detection** | ✅ `importlib` + `__import__` string calls | ⚠️ Not the core workflow | ⚠️ Not the core workflow | ⚠️ Import analysis focused |
+| **Inline ignore directives** | ✅ `# archunit: ignore` | ✅ Supported | ⚠️ Config-based ignores | ⚠️ Rule/exclusion based |
+| **Naming convention checks** | ✅ Files and paths | ❌ No | ❌ No | ⚠️ Module-name oriented |
+| **Code metrics** | ✅ Counts, LCOM, distance metrics | ❌ No | ❌ No | ❌ No |
+| **Custom rules and metrics** | ✅ Full support | ❌ No | ⚠️ Custom contracts | ⚠️ Limited custom rule composition |
+| **PlantUML diagram validation** | ✅ Supported | ❌ No | ❌ No | ❌ No |
+| **Empty test protection** | ✅ Fails by default | ⚠️ Config validation | ⚠️ Contract validation | ⚠️ Not the main focus |
+| **Graph/reporting** | ✅ DOT, Mermaid, D2, CSV, JSON, HTML graph reports + metrics HTML | ✅ DOT, JSON, web graph | ✅ Browser UI | ⚠️ Optional graph visualization |
+| **Best fit** | Architecture tests, CI fitness functions, metrics, diagrams | Modular monolith dependency governance | Config-driven import contracts | pytest import-boundary checks |
+
+The most important differences:
+
+- **Test-native by design**: ArchUnitPython rules are just Python tests, so architecture decisions are reviewed, run, and debugged in the same workflow as the rest of your test suite.
+- **Broader rule surface**: dependency direction, cycles, layer policies, external modules, type-only imports, dynamic imports, naming, metrics, custom rules, and PlantUML validation live in one API.
+- **False-positive protection**: empty checks fail by default, which helps catch typos in file and folder patterns before they silently make your architecture tests meaningless.
+- **Quality beyond imports**: ArchUnitPython can enforce code metrics such as LCOM cohesion, field/method counts, abstractness, instability, and distance from the main sequence.
+
 ## 📢 Informative Error Messages
 
 When tests fail, you get helpful output with file paths and violation details:
@@ -557,6 +712,7 @@ The features of ArchUnitPython can very well be used as architectural fitness fu
 | **Files**   | File and folder based rules    | Stable       |
 | **Metrics** | Code quality metrics           | Stable       |
 | **Slices**  | Architecture slicing           | Stable       |
+| **Graph**   | Dependency graph reports       | Experimental |
 | **Testing** | Test framework integration     | Stable       |
 | **Common**  | Shared utilities               | Stable       |
 | **Reports** | Generate HTML reports          | Experimental |
@@ -567,7 +723,12 @@ We use ourselves to ensure the architectural rules for this repository.
 
 ## 🦊 Contributing
 
-We highly appreciate contributions. We use GitHub Flow, meaning that we use feature branches. As soon as something is merged or pushed to `main` it gets deployed. Versioning is automated via [Conventional Commits](https://www.conventionalcommits.org/). See more in [Contributing](CONTRIBUTING.md).
+We highly appreciate contributions. See [Contributing](CONTRIBUTING.md) for the full workflow.
+
+- Use feature branches and open pull requests against `main`.
+- Use [Conventional Commits](https://www.conventionalcommits.org/) so releases can be versioned automatically.
+- Do not bump versions manually for normal feature or fix work; semantic-release updates `pyproject.toml`, `src/archunitpython/__init__.py`, and `CHANGELOG.md`.
+- CI checks linting, typing, tests, package builds, and release metadata sync.
 
 ## ℹ️ FAQ
 
@@ -621,6 +782,7 @@ Found a bug? Want to discuss features?
 If ArchUnitPython helps your project, please consider:
 
 - Starring the repository 💚
+- Sponsoring development via [GitHub Sponsors](https://github.com/sponsors/LukasNiessen)
 - Suggesting new features 💭
 - Contributing code or documentation ⌨️
 

{archunitpython-1.1.1 → archunitpython-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "archunitpython"
-version = "1.1.1"
+version = "1.2.0"
 description = "Architecture testing library for Python projects. Enforce dependency rules, detect cycles, validate metrics."
 readme = "README.md"
 license = "MIT"
@@ -54,6 +54,7 @@ Changelog = "https://github.com/LukasNiessen/ArchUnitPython/blob/main/CHANGELOG.
 
 [project.optional-dependencies]
 dev = [
+    "build>=1.0",
     "pytest>=7.0",
     "pytest-cov>=4.0",
     "mypy>=1.0",

archunitpython-1.2.0/scripts/bump_release_version.py

@@ -0,0 +1,50 @@
+"""Synchronize release version metadata for semantic-release."""
+
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+PYPROJECT = ROOT / "pyproject.toml"
+PACKAGE_INIT = ROOT / "src" / "archunitpython" / "__init__.py"
+
+
+def replace_once(pattern: str, replacement: str, content: str, path: Path) -> str:
+    updated, count = re.subn(pattern, replacement, content, count=1, flags=re.MULTILINE)
+    if count != 1:
+        raise RuntimeError(f"Could not update version in {path}")
+    return updated
+
+
+def bump_version(version: str) -> None:
+    pyproject = PYPROJECT.read_text(encoding="utf-8")
+    PYPROJECT.write_text(
+        replace_once(r'^version = "[^"]+"$', f'version = "{version}"', pyproject, PYPROJECT),
+        encoding="utf-8",
+    )
+
+    package_init = PACKAGE_INIT.read_text(encoding="utf-8")
+    PACKAGE_INIT.write_text(
+        replace_once(
+            r'^__version__ = "[^"]+"$',
+            f'__version__ = "{version}"',
+            package_init,
+            PACKAGE_INIT,
+        ),
+        encoding="utf-8",
+    )
+
+
+def main() -> int:
+    if len(sys.argv) != 2:
+        print("Usage: python scripts/bump_release_version.py <version>", file=sys.stderr)
+        return 2
+
+    bump_version(sys.argv[1])
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())