archunitpython 1.2.0__py3-none-any.whl → 1.3.0__py3-none-any.whl

archunitpython/__init__.py

@@ -1,6 +1,6 @@
 """ArchUnitPython - Architecture testing library for Python projects."""
 
-__version__ = "1.2.0"
+__version__ = "1.3.0"
 
 # Files API
 # Common

archunitpython/common/__init__.py

@@ -1,6 +1,10 @@
 from archunitpython.common.assertion.violation import EmptyTestViolation, Violation
 from archunitpython.common.error.errors import TechnicalError, UserError
-from archunitpython.common.fluentapi.checkable import Checkable, CheckOptions
+from archunitpython.common.fluentapi.checkable import (
+    Checkable,
+    CheckOptions,
+    RuleRationaleMixin,
+)
 from archunitpython.common.logging.types import LoggingOptions
 from archunitpython.common.types import Filter, Pattern, PatternMatchingOptions
 
@@ -11,6 +15,7 @@ __all__ = [
     "UserError",
     "Checkable",
     "CheckOptions",
+    "RuleRationaleMixin",
     "LoggingOptions",
     "Pattern",
     "Filter",

archunitpython/common/extraction/extract_graph.py

@@ -91,12 +91,8 @@ def extract_graph(
     excludes = (
         list(set(exclude_patterns)) if exclude_patterns is not None else list(_DEFAULT_EXCLUDE)
     )
-    ignore_type_checking_imports = bool(
-        options and options.ignore_type_checking_imports
-    )
-    cache_key = _build_cache_key(
-        project_path, excludes, ignore_type_checking_imports
-    )
+    ignore_type_checking_imports = bool(options and options.ignore_type_checking_imports)
+    cache_key = _build_cache_key(project_path, excludes, ignore_type_checking_imports)
 
     if options and options.clear_cache:
         _graph_cache.pop(cache_key, None)
@@ -137,6 +133,7 @@ def _extract_graph_uncached(
 
     edges: list[Edge] = []
     py_files_set = set(py_files)
+    normalized_py_file_set = {_normalize(f) for f in py_files_set}
 
     for file_path in py_files:
         # Add self-referencing edge (ensures the file appears as a node)
@@ -148,7 +145,6 @@ def _extract_graph_uncached(
             )
         )
 
-        # Extract and resolve imports
         imports = _extract_located_imports(file_path)
         for located_import in imports:
             module_name = located_import.module_name
@@ -163,9 +159,7 @@ def _extract_graph_uncached(
             )
             if resolved and resolved != _normalize(file_path):
                 # Check if the resolved path is in our project
-                if not is_external and resolved not in {
-                    _normalize(f) for f in py_files_set
-                }:
+                if not is_external and resolved not in normalized_py_file_set:
                     is_external = True
 
                 edges.append(
@@ -190,11 +184,7 @@ def _find_python_files(root: str, exclude: list[str]) -> list[str]:
     py_files: list[str] = []
     for dirpath, dirnames, filenames in os.walk(root):
         # Filter out excluded directories in-place
-        dirnames[:] = [
-            d
-            for d in dirnames
-            if not _should_exclude(d, exclude)
-        ]
+        dirnames[:] = [d for d in dirnames if not _should_exclude(d, exclude)]
 
         for filename in filenames:
             if filename.endswith(".py") and not _should_exclude(filename, exclude):
@@ -349,18 +339,14 @@ def _find_type_checking_ranges(tree: ast.Module) -> list[tuple[int, int]]:
             if is_type_checking and node.body:
                 start = node.body[0].lineno
                 end = max(
-                    getattr(n, "end_lineno", n.lineno)
-                    for n in node.body
-                    if hasattr(n, "lineno")
+                    getattr(n, "end_lineno", n.lineno) for n in node.body if hasattr(n, "lineno")
                 )
                 ranges.append((start, end))
 
-    return ranges
+    return sorted(ranges, key=lambda ele: ele[0])
 
 
-def _in_type_checking(
-    node: ast.AST, ranges: list[tuple[int, int]]
-) -> bool:
+def _in_type_checking(node: ast.AST, ranges: list[tuple[int, int]]) -> bool:
     """Check if a node is inside a TYPE_CHECKING block."""
     if not hasattr(node, "lineno"):
         return False

archunitpython/common/fluentapi/__init__.py

@@ -1,3 +1,7 @@
-from archunitpython.common.fluentapi.checkable import Checkable, CheckOptions
+from archunitpython.common.fluentapi.checkable import (
+    Checkable,
+    CheckOptions,
+    RuleRationaleMixin,
+)
 
-__all__ = ["Checkable", "CheckOptions"]
+__all__ = ["Checkable", "CheckOptions", "RuleRationaleMixin"]

archunitpython/common/fluentapi/checkable.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing import Protocol
+from typing import Protocol, TypeVar
 
 from archunitpython.common.assertion.violation import Violation
 from archunitpython.common.logging.types import LoggingOptions
@@ -19,6 +19,28 @@ class CheckOptions:
     ignore_type_checking_imports: bool = False
 
 
+T = TypeVar("T", bound="RuleRationaleMixin")
+
+
+class RuleRationaleMixin:
+    """Mixin for checkable rules that can carry a human-readable rationale."""
+
+    _because_reason: str | None = None
+
+    def because(self: T, reason: str) -> T:
+        """Attach a rationale explaining why the rule exists."""
+        reason = reason.strip()
+        if not reason:
+            raise ValueError("Rule rationale must not be empty.")
+        self._because_reason = reason
+        return self
+
+    @property
+    def because_reason(self) -> str | None:
+        """Return the rationale attached with because(), if any."""
+        return self._because_reason
+
+
 class Checkable(Protocol):
     """Protocol for any architecture rule that can be checked.
 

archunitpython/common/pattern_matching.py

@@ -50,9 +50,7 @@ def matches_pattern(file_path: str, filter_: Filter) -> bool:
     return bool(filter_.regexp.search(target_string))
 
 
-def matches_pattern_classname(
-    class_name: str, file_path: str, filter_: Filter
-) -> bool:
+def matches_pattern_classname(class_name: str, file_path: str, filter_: Filter) -> bool:
     """Check if a class/file matches a filter, supporting classname target."""
     target = filter_.options.target
 

archunitpython/common/projection/cycles/johnsons_apsp.py

@@ -53,13 +53,9 @@ class JohnsonsAPSP:
         if self._is_part_of_current_start_cycle(current_node):
             self._unblock(current_node)
         else:
-            for neighbour in CycleUtils.get_outgoing_neighbours(
-                current_node, self._graph
-            ):
+            for neighbour in CycleUtils.get_outgoing_neighbours(current_node, self._graph):
                 if self._is_blocked(neighbour):
-                    self._blocked_map.append(
-                        _BlockedBy(blocked=current_node, by=neighbour)
-                    )
+                    self._blocked_map.append(_BlockedBy(blocked=current_node, by=neighbour))
 
     def _unblock(self, node: NumberNode) -> None:
         self._blocked = [n for n in self._blocked if n is not node]
@@ -74,9 +70,8 @@ class JohnsonsAPSP:
         if self._start is None:
             return False
         for cycle in self._cycles:
-            if (
-                cycle[0].from_node == self._start.node
-                and any(e.from_node == current_node.node for e in cycle)
+            if cycle[0].from_node == self._start.node and any(
+                e.from_node == current_node.node for e in cycle
             ):
                 return True
         return False

archunitpython/common/projection/cycles/tarjan_scc.py

@@ -18,9 +18,7 @@ class _Vertex:
 class TarjanSCC:
     """Tarjan's algorithm for finding strongly connected components."""
 
-    def find_strongly_connected_components(
-        self, edges: list[NumberEdge]
-    ) -> list[list[NumberEdge]]:
+    def find_strongly_connected_components(self, edges: list[NumberEdge]) -> list[list[NumberEdge]]:
         """Find all strongly connected components in the graph.
 
         Returns a list of edge lists, where each inner list contains
@@ -78,9 +76,7 @@ class TarjanSCC:
             if scc_vertices:
                 scc_ids = {v.id for v in scc_vertices}
                 scc_edges = [
-                    e
-                    for e in self._edges
-                    if e.from_node in scc_ids and e.to_node in scc_ids
+                    e for e in self._edges if e.from_node in scc_ids and e.to_node in scc_ids
                 ]
                 if scc_edges:
                     self._sccs.append(scc_edges)

archunitpython/common/projection/project_cycles.py

@@ -72,8 +72,7 @@ class _CycleProcessor:
                     (
                         se
                         for se in self._source_edges
-                        if se.source_label == source_label
-                        and se.target_label == target_label
+                        if se.source_label == source_label and se.target_label == target_label
                     ),
                     None,
                 )

archunitpython/common/util/logger.py

@@ -44,9 +44,7 @@ class CheckLogger:
 
         mode = "a" if options.append_to_log_file else "w"
         self._file_handler = logging.FileHandler(str(log_path), mode=mode)
-        self._file_handler.setFormatter(
-            logging.Formatter("[%(levelname)s] %(message)s")
-        )
+        self._file_handler.setFormatter(logging.Formatter("[%(levelname)s] %(message)s"))
         self._logger.addHandler(self._file_handler)
 
     def _log(self, level: str, options: LoggingOptions | None, message: str) -> None:

archunitpython/files/assertion/custom_file_logic.py

@@ -83,9 +83,7 @@ def gather_custom_file_violations(
 
     for node in nodes:
         # Check if node matches all pre-filters
-        if pre_filters and not all(
-            matches_pattern(node.label, f) for f in pre_filters
-        ):
+        if pre_filters and not all(matches_pattern(node.label, f) for f in pre_filters):
             continue
 
         file_info = _build_file_info(node.label)
@@ -94,14 +92,10 @@ def gather_custom_file_violations(
         if is_negated:
             # shouldNot: violation if condition IS True
             if result:
-                violations.append(
-                    CustomFileViolation(message=message, file_info=file_info)
-                )
+                violations.append(CustomFileViolation(message=message, file_info=file_info))
         else:
             # should: violation if condition is NOT True
             if not result:
-                violations.append(
-                    CustomFileViolation(message=message, file_info=file_info)
-                )
+                violations.append(CustomFileViolation(message=message, file_info=file_info))
 
     return violations

archunitpython/files/assertion/depend_on_external_modules.py

@@ -34,8 +34,7 @@ def gather_depend_on_external_module_violations(
 
     for edge in edges:
         source_matches = all(
-            matches_pattern(edge.source_label, filter_)
-            for filter_ in subject_filters
+            matches_pattern(edge.source_label, filter_) for filter_ in subject_filters
         )
         if not source_matches:
             continue
@@ -49,16 +48,12 @@ def gather_depend_on_external_module_violations(
         if is_negated:
             if target_matches:
                 violations.append(
-                    ViolatingExternalModuleDependency(
-                        dependency=edge, is_negated=True
-                    )
+                    ViolatingExternalModuleDependency(dependency=edge, is_negated=True)
                 )
         else:
             if not target_matches:
                 violations.append(
-                    ViolatingExternalModuleDependency(
-                        dependency=edge, is_negated=False
-                    )
+                    ViolatingExternalModuleDependency(dependency=edge, is_negated=False)
                 )
 
     return violations

archunitpython/files/assertion/depend_on_files.py

@@ -41,27 +41,19 @@ def gather_depend_on_file_violations(
     violations: list[Violation] = []
 
     for edge in edges:
-        source_matches = all(
-            matches_pattern(edge.source_label, f) for f in subject_filters
-        )
+        source_matches = all(matches_pattern(edge.source_label, f) for f in subject_filters)
         if not source_matches:
             continue
 
-        target_matches = all(
-            matches_pattern(edge.target_label, f) for f in object_filters
-        )
+        target_matches = all(matches_pattern(edge.target_label, f) for f in object_filters)
 
         if is_negated:
             # shouldNot: violation if dependency EXISTS
             if target_matches:
-                violations.append(
-                    ViolatingFileDependency(dependency=edge, is_negated=True)
-                )
+                violations.append(ViolatingFileDependency(dependency=edge, is_negated=True))
         else:
             # should: violation if dependency does NOT match
             if not target_matches:
-                violations.append(
-                    ViolatingFileDependency(dependency=edge, is_negated=False)
-                )
+                violations.append(ViolatingFileDependency(dependency=edge, is_negated=False))
 
     return violations

archunitpython/files/fluentapi/files.py

@@ -14,7 +14,7 @@ from collections.abc import Sequence
 
 from archunitpython.common.assertion.violation import EmptyTestViolation, Violation
 from archunitpython.common.extraction.extract_graph import extract_graph
-from archunitpython.common.fluentapi.checkable import CheckOptions
+from archunitpython.common.fluentapi.checkable import CheckOptions, RuleRationaleMixin
 from archunitpython.common.pattern_matching import matches_all_patterns
 from archunitpython.common.projection.edge_projections import (
     per_external_edge,
@@ -76,15 +76,11 @@ class FileConditionBuilder:
 
     def should(self) -> "PositiveMatchPatternFileConditionBuilder":
         """Begin positive assertion (files SHOULD ...)."""
-        return PositiveMatchPatternFileConditionBuilder(
-            self._project_path, list(self._filters)
-        )
+        return PositiveMatchPatternFileConditionBuilder(self._project_path, list(self._filters))
 
     def should_not(self) -> "NegatedMatchPatternFileConditionBuilder":
         """Begin negative assertion (files SHOULD NOT ...)."""
-        return NegatedMatchPatternFileConditionBuilder(
-            self._project_path, list(self._filters)
-        )
+        return NegatedMatchPatternFileConditionBuilder(self._project_path, list(self._filters))
 
 
 class FilesShouldCondition:
@@ -111,15 +107,11 @@ class FilesShouldCondition:
 
     def should(self) -> "PositiveMatchPatternFileConditionBuilder":
         """Begin positive assertion (files SHOULD ...)."""
-        return PositiveMatchPatternFileConditionBuilder(
-            self._project_path, list(self._filters)
-        )
+        return PositiveMatchPatternFileConditionBuilder(self._project_path, list(self._filters))
 
     def should_not(self) -> "NegatedMatchPatternFileConditionBuilder":
         """Begin negative assertion (files SHOULD NOT ...)."""
-        return NegatedMatchPatternFileConditionBuilder(
-            self._project_path, list(self._filters)
-        )
+        return NegatedMatchPatternFileConditionBuilder(self._project_path, list(self._filters))
 
 
 class PositiveMatchPatternFileConditionBuilder:
@@ -135,9 +127,7 @@ class PositiveMatchPatternFileConditionBuilder:
 
     def depend_on_files(self) -> "DependOnFileConditionBuilder":
         """Begin dependency assertion - files SHOULD depend on ..."""
-        return DependOnFileConditionBuilder(
-            self._project_path, self._filters, is_negated=False
-        )
+        return DependOnFileConditionBuilder(self._project_path, self._filters, is_negated=False)
 
     def depend_on_external_modules(
         self,
@@ -192,9 +182,7 @@ class NegatedMatchPatternFileConditionBuilder:
 
     def depend_on_files(self) -> "DependOnFileConditionBuilder":
         """Begin dependency assertion - files SHOULD NOT depend on ..."""
-        return DependOnFileConditionBuilder(
-            self._project_path, self._filters, is_negated=True
-        )
+        return DependOnFileConditionBuilder(self._project_path, self._filters, is_negated=True)
 
     def depend_on_external_modules(
         self,
@@ -243,9 +231,7 @@ class NegatedMatchPatternFileConditionBuilder:
 class DependOnFileConditionBuilder:
     """Configure dependency target patterns."""
 
-    def __init__(
-        self, project_path: str | None, filters: list[Filter], is_negated: bool
-    ) -> None:
+    def __init__(self, project_path: str | None, filters: list[Filter], is_negated: bool) -> None:
         self._project_path = project_path
         self._filters = filters
         self._is_negated = is_negated
@@ -285,9 +271,7 @@ class DependOnFileConditionBuilder:
 class DependOnExternalModuleConditionBuilder:
     """Configure external module dependency target patterns."""
 
-    def __init__(
-        self, project_path: str | None, filters: list[Filter], is_negated: bool
-    ) -> None:
+    def __init__(self, project_path: str | None, filters: list[Filter], is_negated: bool) -> None:
         self._project_path = project_path
         self._filters = filters
         self._is_negated = is_negated
@@ -338,7 +322,7 @@ def _check_empty_test(
     return None
 
 
-class CycleFreeFileCondition:
+class CycleFreeFileCondition(RuleRationaleMixin):
     """Checkable that verifies no cycles exist among filtered files."""
 
     def __init__(self, project_path: str | None, filters: list[Filter]) -> None:
@@ -366,7 +350,7 @@ class CycleFreeFileCondition:
         return gather_cycle_violations(cycles)
 
 
-class DependOnFileCondition:
+class DependOnFileCondition(RuleRationaleMixin):
     """Checkable that verifies file dependency rules."""
 
     def __init__(
@@ -393,7 +377,7 @@ class DependOnFileCondition:
         )
 
 
-class DependOnExternalModuleCondition:
+class DependOnExternalModuleCondition(RuleRationaleMixin):
     """Checkable that verifies external module dependency rules."""
 
     def __init__(
@@ -425,7 +409,7 @@ class DependOnExternalModuleCondition:
         )
 
 
-class MatchPatternFileCondition:
+class MatchPatternFileCondition(RuleRationaleMixin):
     """Checkable that verifies files match/don't match patterns."""
 
     def __init__(
@@ -447,12 +431,10 @@ class MatchPatternFileCondition:
         if empty is not None:
             return empty
 
-        return gather_regex_matching_violations(
-            nodes, self._check_filters, self._is_negated
-        )
+        return gather_regex_matching_violations(nodes, self._check_filters, self._is_negated)
 
 
-class CustomFileCheckableCondition:
+class CustomFileCheckableCondition(RuleRationaleMixin):
     """Checkable that evaluates a custom condition on files."""
 
     def __init__(

archunitpython/metrics/assertion/metric_thresholds.py

@@ -31,9 +31,7 @@ class FileCountViolation(Violation):
     comparison: MetricComparison
 
 
-def check_threshold(
-    value: float, threshold: float, comparison: MetricComparison
-) -> bool:
+def check_threshold(value: float, threshold: float, comparison: MetricComparison) -> bool:
     """Check if a value violates a threshold.
 
     Returns True if the value is a VIOLATION.

archunitpython/metrics/calculation/distance.py

@@ -103,8 +103,6 @@ def calculate_distance_metrics_for_project(
         average_instability=sum(m.instability for m in metrics) / len(metrics),
         average_distance=sum(m.distance for m in metrics) / len(metrics),
         files_in_zone_of_pain=sum(1 for m in metrics if m.in_zone_of_pain),
-        files_in_zone_of_uselessness=sum(
-            1 for m in metrics if m.in_zone_of_uselessness
-        ),
+        files_in_zone_of_uselessness=sum(1 for m in metrics if m.in_zone_of_uselessness),
         total_files=len(files),
     )

archunitpython/metrics/extraction/extract_class_info.py

@@ -129,9 +129,7 @@ def _extract_class(node: ast.ClassDef, file_path: str) -> ClassInfo:
     for item in ast.walk(node):
         if isinstance(item, ast.Assign):
             for target in item.targets:
-                if isinstance(target, ast.Attribute) and isinstance(
-                    target.value, ast.Name
-                ):
+                if isinstance(target, ast.Attribute) and isinstance(target.value, ast.Name):
                     if target.value.id == "self":
                         field_name = target.attr
                         if field_name not in fields:
@@ -142,9 +140,7 @@ def _extract_class(node: ast.ClassDef, file_path: str) -> ClassInfo:
         if isinstance(item, (ast.FunctionDef, ast.AsyncFunctionDef)):
             method_name = item.name
             accessed = _find_field_accesses(item, set(fields.keys()))
-            methods.append(
-                MethodInfo(name=method_name, accessed_fields=accessed)
-            )
+            methods.append(MethodInfo(name=method_name, accessed_fields=accessed))
             # Update field access tracking
             for field_name in accessed:
                 if field_name in fields:
@@ -159,9 +155,7 @@ def _extract_class(node: ast.ClassDef, file_path: str) -> ClassInfo:
     )
 
 
-def _extract_enhanced_class(
-    node: ast.ClassDef, file_path: str
-) -> EnhancedClassInfo:
+def _extract_enhanced_class(node: ast.ClassDef, file_path: str) -> EnhancedClassInfo:
     """Extract EnhancedClassInfo from a ClassDef AST node."""
     base = _extract_class(node, file_path)
 

archunitpython/metrics/fluentapi/export_utils.py

@@ -35,11 +35,7 @@ class MetricsExporter:
             HTML content as a string. Also writes to file if output_path specified.
         """
         opts = options or ExportOptions()
-        timestamp = (
-            datetime.now().strftime("%Y-%m-%d %H:%M:%S")
-            if opts.include_timestamp
-            else ""
-        )
+        timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S") if opts.include_timestamp else ""
 
         css = opts.custom_css or _DEFAULT_CSS
 
@@ -55,7 +51,7 @@ class MetricsExporter:
 </head>
 <body>
   <h1>{opts.title}</h1>
-  {f'<p class="timestamp">Generated: {timestamp}</p>' if timestamp else ''}
+  {f'<p class="timestamp">Generated: {timestamp}</p>' if timestamp else ""}
   <table>
     <thead>
       <tr><th>Metric</th><th>Value</th></tr>

archunitpython/metrics/fluentapi/metrics.py

@@ -11,7 +11,7 @@ from __future__ import annotations
 from typing import Any, Callable
 
 from archunitpython.common.assertion.violation import Violation
-from archunitpython.common.fluentapi.checkable import CheckOptions
+from archunitpython.common.fluentapi.checkable import CheckOptions, RuleRationaleMixin
 from archunitpython.common.pattern_matching import matches_pattern_classname
 from archunitpython.common.regex_factory import RegexFactory
 from archunitpython.common.types import Filter, Pattern
@@ -97,9 +97,7 @@ class MetricsBuilder:
         )
 
 
-def _get_filtered_classes(
-    project_path: str | None, filters: list[Filter]
-) -> list[ClassInfo]:
+def _get_filtered_classes(project_path: str | None, filters: list[Filter]) -> list[ClassInfo]:
     classes = extract_class_info(project_path)
     if not filters:
         return classes
@@ -119,39 +117,25 @@ class CountMetricsBuilder:
         self._filters = filters
 
     def method_count(self) -> "ClassMetricThresholdBuilder":
-        return ClassMetricThresholdBuilder(
-            self._project_path, self._filters, MethodCountMetric()
-        )
+        return ClassMetricThresholdBuilder(self._project_path, self._filters, MethodCountMetric())
 
     def field_count(self) -> "ClassMetricThresholdBuilder":
-        return ClassMetricThresholdBuilder(
-            self._project_path, self._filters, FieldCountMetric()
-        )
+        return ClassMetricThresholdBuilder(self._project_path, self._filters, FieldCountMetric())
 
     def lines_of_code(self) -> "FileMetricThresholdBuilder":
-        return FileMetricThresholdBuilder(
-            self._project_path, self._filters, LinesOfCodeMetric()
-        )
+        return FileMetricThresholdBuilder(self._project_path, self._filters, LinesOfCodeMetric())
 
     def statements(self) -> "FileMetricThresholdBuilder":
-        return FileMetricThresholdBuilder(
-            self._project_path, self._filters, StatementCountMetric()
-        )
+        return FileMetricThresholdBuilder(self._project_path, self._filters, StatementCountMetric())
 
     def imports(self) -> "FileMetricThresholdBuilder":
-        return FileMetricThresholdBuilder(
-            self._project_path, self._filters, ImportCountMetric()
-        )
+        return FileMetricThresholdBuilder(self._project_path, self._filters, ImportCountMetric())
 
     def classes(self) -> "FileMetricThresholdBuilder":
-        return FileMetricThresholdBuilder(
-            self._project_path, self._filters, ClassCountMetric()
-        )
+        return FileMetricThresholdBuilder(self._project_path, self._filters, ClassCountMetric())
 
     def functions(self) -> "FileMetricThresholdBuilder":
-        return FileMetricThresholdBuilder(
-            self._project_path, self._filters, FunctionCountMetric()
-        )
+        return FileMetricThresholdBuilder(self._project_path, self._filters, FunctionCountMetric())
 
 
 class ClassMetricThresholdBuilder:
@@ -186,7 +170,7 @@ class ClassMetricThresholdBuilder:
         )
 
 
-class ClassMetricCondition:
+class ClassMetricCondition(RuleRationaleMixin):
     """Checkable that verifies a class-level metric threshold."""
 
     def __init__(
@@ -246,7 +230,7 @@ class FileMetricThresholdBuilder:
         )
 
 
-class FileMetricCondition:
+class FileMetricCondition(RuleRationaleMixin):
     """Checkable that verifies a file-level metric threshold."""
 
     def __init__(
@@ -340,19 +324,13 @@ class DistanceMetricsBuilder:
         self._filters = filters
 
     def abstractness(self) -> "DistanceThresholdBuilder":
-        return DistanceThresholdBuilder(
-            self._project_path, self._filters, "abstractness"
-        )
+        return DistanceThresholdBuilder(self._project_path, self._filters, "abstractness")
 
     def instability(self) -> "DistanceThresholdBuilder":
-        return DistanceThresholdBuilder(
-            self._project_path, self._filters, "instability"
-        )
+        return DistanceThresholdBuilder(self._project_path, self._filters, "instability")
 
     def distance_from_main_sequence(self) -> "DistanceThresholdBuilder":
-        return DistanceThresholdBuilder(
-            self._project_path, self._filters, "distance"
-        )
+        return DistanceThresholdBuilder(self._project_path, self._filters, "distance")
 
     def not_in_zone_of_pain(self) -> "ZoneCondition":
         return ZoneCondition(self._project_path, self._filters, "pain")
@@ -386,7 +364,7 @@ class DistanceThresholdBuilder:
         )
 
 
-class DistanceCondition:
+class DistanceCondition(RuleRationaleMixin):
     """Checkable for distance metric thresholds."""
 
     def __init__(
@@ -426,7 +404,7 @@ class DistanceCondition:
         return violations
 
 
-class ZoneCondition:
+class ZoneCondition(RuleRationaleMixin):
     """Checkable for zone detection (pain/uselessness)."""
 
     def __init__(self, project_path: str | None, filters: list[Filter], zone_type: str) -> None:
@@ -440,11 +418,7 @@ class ZoneCondition:
 
         for file_result in files:
             dm = calculate_file_distance_metrics(file_result, files)
-            in_zone = (
-                dm.in_zone_of_pain
-                if self._zone_type == "pain"
-                else dm.in_zone_of_uselessness
-            )
+            in_zone = dm.in_zone_of_pain if self._zone_type == "pain" else dm.in_zone_of_uselessness
 
             if in_zone:
                 violations.append(
@@ -511,7 +485,7 @@ class CustomMetricsBuilder:
         )
 
 
-class CustomMetricCondition:
+class CustomMetricCondition(RuleRationaleMixin):
     """Checkable for custom metric thresholds."""
 
     def __init__(
@@ -551,7 +525,7 @@ class CustomMetricCondition:
         return violations
 
 
-class CustomAssertionCondition:
+class CustomAssertionCondition(RuleRationaleMixin):
     """Checkable for custom metric assertions."""
 
     def __init__(

archunitpython/slices/fluentapi/slices.py

@@ -14,7 +14,7 @@ import re
 
 from archunitpython.common.assertion.violation import Violation
 from archunitpython.common.extraction.extract_graph import extract_graph
-from archunitpython.common.fluentapi.checkable import CheckOptions
+from archunitpython.common.fluentapi.checkable import CheckOptions, RuleRationaleMixin
 from archunitpython.common.projection.project_edges import project_edges
 from archunitpython.common.projection.types import MapFunction
 from archunitpython.slices.assertion.admissible_edges import (
@@ -61,15 +61,11 @@ class SliceConditionBuilder:
 
     def should(self) -> "PositiveConditionBuilder":
         """Begin positive assertion (slices SHOULD ...)."""
-        return PositiveConditionBuilder(
-            self._project_path, self._pattern, self._regex
-        )
+        return PositiveConditionBuilder(self._project_path, self._pattern, self._regex)
 
     def should_not(self) -> "NegativeConditionBuilder":
         """Begin negative assertion (slices SHOULD NOT ...)."""
-        return NegativeConditionBuilder(
-            self._project_path, self._pattern, self._regex
-        )
+        return NegativeConditionBuilder(self._project_path, self._pattern, self._regex)
 
 
 class PositiveConditionBuilder:
@@ -133,9 +129,7 @@ class NegativeConditionBuilder:
         self._regex = regex
         self._forbidden_deps: list[tuple[str, str]] = []
 
-    def contain_dependency(
-        self, source: str, target: str
-    ) -> "NegativeSliceCondition":
+    def contain_dependency(self, source: str, target: str) -> "NegativeSliceCondition":
         """Assert that a specific dependency should NOT exist."""
         return NegativeSliceCondition(
             self._project_path,
@@ -146,7 +140,7 @@ class NegativeConditionBuilder:
         )
 
 
-class PositiveSliceCondition:
+class PositiveSliceCondition(RuleRationaleMixin):
     """Checkable that verifies slices adhere to a diagram."""
 
     def __init__(
@@ -170,9 +164,7 @@ class PositiveSliceCondition:
         mapper = self._get_mapper()
         edges = project_edges(graph, mapper)
 
-        return gather_positive_violations(
-            edges, rules, contained_nodes, self._coherence_options
-        )
+        return gather_positive_violations(edges, rules, contained_nodes, self._coherence_options)
 
     def _get_mapper(self) -> MapFunction:
         if self._pattern:
@@ -184,7 +176,7 @@ class PositiveSliceCondition:
         return identity()
 
 
-class NegativeSliceCondition:
+class NegativeSliceCondition(RuleRationaleMixin):
     """Checkable that verifies a specific dependency does NOT exist."""
 
     def __init__(

archunitpython/slices/uml/generate_rules.py

@@ -43,9 +43,7 @@ def generate_rule(puml_content: str) -> tuple[list[Rule], list[str]]:
             continue
 
         # Match component declarations: component [Name] or component [Name] #Color
-        comp_match = re.match(
-            r"component\s+\[([^\]]+)\]", stripped
-        )
+        comp_match = re.match(r"component\s+\[([^\]]+)\]", stripped)
         if comp_match:
             name = comp_match.group(1).strip()
             if name not in contained_nodes:
@@ -53,9 +51,7 @@ def generate_rule(puml_content: str) -> tuple[list[Rule], list[str]]:
             continue
 
         # Match relationships: [Source] --> [Target] or [Source] -> [Target]
-        rel_match = re.match(
-            r"\[([^\]]+)\]\s*-+>\s*\[([^\]]+)\]", stripped
-        )
+        rel_match = re.match(r"\[([^\]]+)\]\s*-+>\s*\[([^\]]+)\]", stripped)
         if rel_match:
             source = rel_match.group(1).strip()
             target = rel_match.group(2).strip()

archunitpython/testing/assertion.py

@@ -7,7 +7,11 @@ from archunitpython.common.fluentapi.checkable import Checkable, CheckOptions
 from archunitpython.testing.common.violation_factory import ViolationFactory
 
 
-def format_violations(violations: list[Violation]) -> str:
+def format_violations(
+    violations: list[Violation],
+    *,
+    because: str | None = None,
+) -> str:
     """Format violations into a human-readable string.
 
     Args:
@@ -19,7 +23,10 @@ def format_violations(violations: list[Violation]) -> str:
     if not violations:
         return "No violations found."
 
-    lines = [f"Found {len(violations)} architecture violation(s):", ""]
+    lines = [f"Found {len(violations)} architecture violation(s):"]
+    if because:
+        lines.extend(["", f"Because: {because}"])
+    lines.append("")
     for i, violation in enumerate(violations, 1):
         tv = ViolationFactory.from_violation(violation)
         lines.append(f"  {i}. {tv.message}")
@@ -44,4 +51,5 @@ def assert_passes(
     """
     violations = checkable.check(options)
     if violations:
-        raise AssertionError(format_violations(violations))
+        because = getattr(checkable, "because_reason", None)
+        raise AssertionError(format_violations(violations, because=because))

archunitpython/testing/common/violation_factory.py

@@ -66,9 +66,7 @@ class ViolationFactory:
             )
 
         if isinstance(violation, ViolatingCycle):
-            cycle_str = " -> ".join(
-                e.source_label for e in violation.cycle
-            )
+            cycle_str = " -> ".join(e.source_label for e in violation.cycle)
             return TestViolation(
                 message="Circular dependency detected",
                 details=f"Cycle: {cycle_str}",

{archunitpython-1.2.0.dist-info → archunitpython-1.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: archunitpython
-Version: 1.2.0
+Version: 1.3.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
@@ -39,11 +39,9 @@ Description-Content-Type: text/markdown
 <!-- spacer -->
 <p></p>
 
-[![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/)
-[![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)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Build & tests](https://img.shields.io/github/actions/workflow/status/LukasNiessen/ArchUnitPython/integrate.yaml?branch=main&label=build%20%26%20tests)](https://github.com/LukasNiessen/ArchUnitPython/actions/workflows/integrate.yaml) [![GitHub stars](https://img.shields.io/github/stars/LukasNiessen/ArchUnitPython.svg)](https://github.com/LukasNiessen/ArchUnitPython)<br>
+[![PyPI downloads](https://static.pepy.tech/badge/archunitpython/month)](https://pepy.tech/project/archunitpython) [![PyPI total downloads](https://img.shields.io/pepy/dt/archunitpython?label=total%20downloads&color=007ec6)](https://pepy.tech/project/archunitpython)
+<!-- [![PyPI version](https://img.shields.io/pypi/v/archunitpython.svg)](https://pypi.org/project/archunitpython/) -->
 
 </div>
 
@@ -53,7 +51,7 @@ The #1 ArchUnit-style architecture testing library for Python, measured by GitHu
 
 _Inspired by the amazing ArchUnit library but we are not affiliated with ArchUnit._
 
-[Setup](#-setup) • [Use Cases](#-use-cases) • [Features](#-features) • [Why ArchUnitPython?](#-library-comparison) • [Contributing](CONTRIBUTING.md)
+[Setup](#-setup) • [Use Cases](#-use-cases) • [Features](#-features) • [Why ArchUnitPython?](#-library-comparison) • [Sponsor](https://github.com/sponsors/LukasNiessen) • [Contributing](CONTRIBUTING.md)
 
 ## ⚡ 5 min Quickstart
 
@@ -190,6 +188,25 @@ options = CheckOptions(
 violations = rule.check(options)
 ```
 
+### Explaining Rules With `.because(...)`
+
+Attach a rationale to a rule so failing assertions explain why the rule exists:
+
+```python
+rule = (
+    project_files("src/")
+    .in_folder("**/controllers/**")
+    .should_not()
+    .depend_on_files()
+    .in_folder("**/database/**")
+    .because("controllers should stay thin and delegate persistence")
+)
+
+assert_passes(rule)
+```
+
+When the rule fails, the rationale is included in the assertion message.
+
 ## 🐹 Use Cases
 
 Here is an overview of common use cases.
@@ -433,21 +450,113 @@ def test_no_forbidden_dependency():
 
 Generate dependency graph reports in multiple formats and narrow them to the part of the codebase you want to inspect.
 
+**Using `requests` library repo for example**
+
 ```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
+    graph = project_graph("src/requests").titled("Application Architecture")
+
+    graph.collapse_to_folder_depth(2).export_as_mermaid("reports/dependencies.md")
+
+if __name__ == "__main__":
+    test_export_dependency_graph_reports()
+```
+**Rendered mermain diagram**
+``` mermaid
+flowchart LR
+  n0["__init__.py"]
+  n1["__version__.py"]
+  n2["_internal_utils.py"]
+  n3["_types.py"]
+  n4["adapters.py"]
+  n5["api.py"]
+  n6["auth.py"]
+  n7["certs.py"]
+  n8["compat.py"]
+  n9["cookies.py"]
+  n10["exceptions.py"]
+  n11["help.py"]
+  n12["hooks.py"]
+  n13["models.py"]
+  n14["packages.py"]
+  n15["sessions.py"]
+  n16["status_codes.py"]
+  n17["structures.py"]
+  n18["utils.py"]
+  n0 --> n1
+  n0 --> n5
+  n0 --> n10
+  n0 --> n13
+  n0 --> n15
+  n0 --> n16
+  n2 --> n8
+  n3 --> n6
+  n3 --> n9
+  n3 --> n13
+  n3 --> n17
+  n4 --> n0
+  n4 --> n3
+  n4 --> n6
+  n4 --> n8
+  n4 --> n9
+  n4 --> n10
+  n4 --> n13
+  n4 --> n17
+  n4 --> n18
+  n5 --> n0
+  n5 --> n13
+  n6 --> n2
+  n6 --> n8
+  n6 --> n9
+  n6 --> n13
+  n6 --> n18
+  n9 --> n2
+  n9 --> n3
+  n9 --> n8
+  n9 --> n13
+  n10 --> n8
+  n10 --> n13
+  n11 --> n0
+  n12 --> n0
+  n12 --> n13
+  n13 --> n0
+  n13 --> n2
+  n13 --> n4
+  n13 --> n6
+  n13 --> n8
+  n13 --> n9
+  n13 --> n10
+  n13 --> n12
+  n13 --> n16
+  n13 --> n17
+  n13 --> n18
+  n14 --> n8
+  n15 --> n0
+  n15 --> n2
+  n15 --> n3
+  n15 --> n4
+  n15 --> n6
+  n15 --> n8
+  n15 --> n9
+  n15 --> n10
+  n15 --> n12
+  n15 --> n13
+  n15 --> n16
+  n15 --> n17
+  n15 --> n18
+  n16 --> n17
+  n17 --> n8
+  n18 --> n0
+  n18 --> n1
+  n18 --> n2
+  n18 --> n3
+  n18 --> n8
+  n18 --> n9
+  n18 --> n10
+  n18 --> n13
+  n18 --> n17
 ```
 
 Supported formats:

{archunitpython-1.2.0.dist-info → archunitpython-1.3.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
-archunitpython/__init__.py,sha256=_YNTDiIuDgxiMhgS94vtZaqAVkum5-S0FViXN9p_Aqg,1154
+archunitpython/__init__.py,sha256=alLY-bGp-tUtdb8BRV0r8K-qIZKkWYnJ5K-mTDnFOrQ,1154
 archunitpython/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-archunitpython/common/__init__.py,sha256=u8jwbfALwIT_5ZqTrRchpZqkFHG5tTwM21LX5hR9ZSc,593
-archunitpython/common/pattern_matching.py,sha256=zhfglETSJfe5XPzueVflM14EKfllXuazqzd2XH5fuxw,2675
+archunitpython/common/__init__.py,sha256=TKL39Z0kBpWqMH99jU4LsDSUZ5lQ_rcAJfLnmUTDTOI,656
+archunitpython/common/pattern_matching.py,sha256=HMAfo8GsooHvA4d2IxCi3btrYTdwfOQXw4bDNr117P0,2669
 archunitpython/common/regex_factory.py,sha256=UtlElM0Uty3SuD7tPZeoDnpbFipFUuYDpWfuV-Xq4c4,2459
 archunitpython/common/types.py,sha256=aA6hxCvmOy7_q74pE0sDRILNB8KxmHx9G4j5ql87mWs,755
 archunitpython/common/assertion/__init__.py,sha256=qpFkUrRoJWbwL7KPWaVTqlx70fhUJtwjyY0elsm8tv0,131
@@ -9,36 +9,36 @@ archunitpython/common/assertion/violation.py,sha256=TnMOykN3kPoGrSf1KcxBXYRfaxfX
 archunitpython/common/error/__init__.py,sha256=UWcdIKpGAJvo4WEGOVSaUjQQnKoPi8R496uDGXBWKsE,116
 archunitpython/common/error/errors.py,sha256=y7mcXoZPyK7uD2dMMO1qBt1y7KcIeGlRYiVeI6bjms4,249
 archunitpython/common/extraction/__init__.py,sha256=RkJOcxJoLYQxEagh3uWhjsUCprK3Nr3Bn3o7nmzk4_Q,284
-archunitpython/common/extraction/extract_graph.py,sha256=cXKPDQ2GEAA3pJ_2LzoeMzizWZjDdokc7QYm6k9EsCU,15366
+archunitpython/common/extraction/extract_graph.py,sha256=HIfAZLZiv4Zbi1Nm8jmNnnu8ggn0wQXunBlZP_QK1x8,15254
 archunitpython/common/extraction/graph.py,sha256=Rk-0eDDOLoHvScO27J2JzXjyMq3e5eKtrHnFBh5B6SU,1052
-archunitpython/common/fluentapi/__init__.py,sha256=J7PDgqBXQOpXqCMCGRyFNil0dCulufmhfirzvYvh-gk,119
-archunitpython/common/fluentapi/checkable.py,sha256=6Tsxtycc27-LaeE6cTtQF6NfepFzhgmCrFJAosN_chs,892
+archunitpython/common/fluentapi/__init__.py,sha256=LeS7qS2p9-FqqBhDL8xRPex__W5Qk0UWfcpl7nVVLfI,178
+archunitpython/common/fluentapi/checkable.py,sha256=BJFYibVhHLMFlnWdISPCIL3DYI1_3JN2-1jEQOaVaGE,1547
 archunitpython/common/logging/__init__.py,sha256=u3-2_jYmiyoQ-C534SmQXvR1L9h3lbJqA9Yt1Nmv9HA,115
 archunitpython/common/logging/types.py,sha256=wUriZeaUawA3JoBfJVLC6lIMglbLG955nXWdJGwxW4I,425
 archunitpython/common/projection/__init__.py,sha256=-Sx-b80b2N3ap3ahAcLUCXqYYK3ccgTDpV-K1jSOSYQ,797
 archunitpython/common/projection/edge_projections.py,sha256=Mud8DL6Y8H66CObqyikKYAxdXMRENuAFRtwhCxpwxoU,1524
-archunitpython/common/projection/project_cycles.py,sha256=SA6eXzy599dJMvAOA6K1ONkOaFLiEXw8qixpgybtW-I,3105
+archunitpython/common/projection/project_cycles.py,sha256=TQ4Ok1hT4T_znqFbwV4VTj-BXmlFr1O7TtZdVOd5oPg,3081
 archunitpython/common/projection/project_edges.py,sha256=v7hDMSeghiLz0xHbG4BNF7jNQphcWobU7rgoiuw3fh4,1268
 archunitpython/common/projection/project_nodes.py,sha256=U6sLYvJd6NBgg39V0Ry7r_-57gdXaaXsbH-D12nipCg,1497
 archunitpython/common/projection/types.py,sha256=EP5yJd-uXYdACFdFzeID8bUVsg_vdhgiOzshrC-CC8Y,937
 archunitpython/common/projection/cycles/__init__.py,sha256=giGUcwpEMr91XST-biyCmLUjP5okhwTA4CcCaxjZdmg,217
 archunitpython/common/projection/cycles/cycle_utils.py,sha256=eoVyZAapTWwpELGV9rY8e4ug2khmsGiEUz-3fD-JKBM,1746
 archunitpython/common/projection/cycles/cycles.py,sha256=lHocmN7xnlfbrz6ZqKwuECHynnJNBe8Zb2nVcFVyOhA,906
-archunitpython/common/projection/cycles/johnsons_apsp.py,sha256=vbAmR8QqGmM7hRgphngJvQ5yU8Og4RxYkGUQmKOWT2U,4087
+archunitpython/common/projection/cycles/johnsons_apsp.py,sha256=lfnTMIvv3mTeIlh0D9QzwJUGPgz9spcDvwSgPJhz69s,3993
 archunitpython/common/projection/cycles/model.py,sha256=sgpb0HpYzQND0KPb56BWlnrv683UkE3MZ3NfAJ9ePK0,483
-archunitpython/common/projection/cycles/tarjan_scc.py,sha256=49LnVrcFIRQr2yPi034YIdIBjmrFotrXsoS000Qz9Mc,2843
+archunitpython/common/projection/cycles/tarjan_scc.py,sha256=pIj1ub8XgcqVLj8skdZdOvXqwX10U8kOmlnUIIHYCME,2789
 archunitpython/common/util/__init__.py,sha256=g-W8kWiVqwdohxm74J3yUonPkb_yDUJrp73S5s4jpgI,117
 archunitpython/common/util/declaration_detector.py,sha256=XgrpgaUIQa9MNFlnhVQz2X_uW7zCO9nrMbGa3tVFyPM,3407
-archunitpython/common/util/logger.py,sha256=QT6ir8caMXu4VQombe0NjaT2NUm58kFdlnps4T5ECCE,3348
+archunitpython/common/util/logger.py,sha256=2did2mRAlkrElH9SYgv9xYiSzr4A-jXHg3cp6TodhoA,3326
 archunitpython/files/__init__.py,sha256=wgl8IOqTeQGpNISu-Q8b_j6rTn8aEgoz6t1S5j8z13g,108
 archunitpython/files/assertion/__init__.py,sha256=K2qiEFfmo6SCgxfOKNrPzYgT5ScKUaw2W2CrDa3jBTw,1068
-archunitpython/files/assertion/custom_file_logic.py,sha256=ygpc2NZghHBD-GTGrQW_dWzGZr_9DSvi0denC-cdwuo,3054
+archunitpython/files/assertion/custom_file_logic.py,sha256=1v5D80QX_NnAKBwKwyhetY4rA8rrXyxN2BsHlvnLgq8,2956
 archunitpython/files/assertion/cycle_free.py,sha256=Ib3tmVVErmTpORmRn_rZqOqY0gk54crN_d_IapeWqdI,738
-archunitpython/files/assertion/depend_on_external_modules.py,sha256=d16mK6lpr5MhxndigSZsGEOPF51UY0Gl5HddqP_MdXs,1949
-archunitpython/files/assertion/depend_on_files.py,sha256=B-zyFyXCt2ywCzO0BIH1lRGsre6PkAItv2ZfpM_u2Js,2132
+archunitpython/files/assertion/depend_on_external_modules.py,sha256=BXGpN-301YOcB446e3U0i2rNNliQuaSJCfdZwKVzs0U,1845
+archunitpython/files/assertion/depend_on_files.py,sha256=EGMtDD8KT09BJQwOEMoKj-yTQfY3KLLYWN5SM1BCmpY,2012
 archunitpython/files/assertion/matching_files.py,sha256=qNbvU2o_MM6rzM-YUdJZzkltVbenWGC0u5kLH7su6CA,2003
 archunitpython/files/fluentapi/__init__.py,sha256=wgl8IOqTeQGpNISu-Q8b_j6rTn8aEgoz6t1S5j8z13g,108
-archunitpython/files/fluentapi/files.py,sha256=uX__VDed_TLNiibK2pTMaPQ8RaCyyFf2ZClqdymvs98,17214
+archunitpython/files/fluentapi/files.py,sha256=oZG0lWV6p0AiGANdoZfYd51H8zY-J4eTSPRTRPBYhs0,17152
 archunitpython/graph/__init__.py,sha256=vm1jMOoN35IIU7YDs59qPtf_F82YV-QrEGfXhozAOek,756
 archunitpython/graph/graph_reporter.py,sha256=D_KH01CM7TzeMFB6o5NIQfLVJq0rvKZn9l7WumXV6lo,25598
 archunitpython/layers/__init__.py,sha256=DCRxqLhluTxTaT9ZM2MbfAdJVgqcOO9jtkZHzBbeLOw,164
@@ -48,36 +48,36 @@ archunitpython/layers/fluentapi/__init__.py,sha256=psKFB-5IXS1SJ8g62HthExKYJio3b
 archunitpython/layers/fluentapi/layers.py,sha256=Wl926_aWpNrlbWatDi3QDR-8geDflbYFEivWJv-X9dI,4438
 archunitpython/metrics/__init__.py,sha256=HD72MWF0hCh2LzKfyk3mMJp2tf7TJebpwTtZ_kppjso,84
 archunitpython/metrics/assertion/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-archunitpython/metrics/assertion/metric_thresholds.py,sha256=dijCzOr5-dhkdK-QAE3DAkfiSBgknZlxtp-ZrBj_Dmk,1268
+archunitpython/metrics/assertion/metric_thresholds.py,sha256=kwX1iRFnF7oLaLMlQsYrDsNRrivDE8pI6nrrZYAafvg,1262
 archunitpython/metrics/calculation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 archunitpython/metrics/calculation/count.py,sha256=tMbAi51hkrViW7dM8SM1Qhh09kuwI3UeWmytAWNLEq0,3997
-archunitpython/metrics/calculation/distance.py,sha256=zXwNrXxmgwBaexvjbODZ1VOSxJx_fZjy5jU0FbNjQcM,3611
+archunitpython/metrics/calculation/distance.py,sha256=W2agAQVmGJftPbHDUToKy66Fp8-h7WZspg15skyYWnc,3589
 archunitpython/metrics/calculation/lcom.py,sha256=LK_kNT-BM6yuR5TUOLWQLkVvMpqR6q207p7RR9Rb35o,5040
 archunitpython/metrics/common/__init__.py,sha256=xtEyAhS4X0UbJXHxnpdiXljVZmKIKKekZAZ1zflSPFE,335
 archunitpython/metrics/common/types.py,sha256=w1BUlw6p_3K8qZDoQXv50P_CcKixGYiyS_YBGYILySA,1601
 archunitpython/metrics/extraction/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-archunitpython/metrics/extraction/extract_class_info.py,sha256=eCNoHvOdQGenGDQcd9iucO9PqNv1hYhW9HTOUaZMFio,7825
+archunitpython/metrics/extraction/extract_class_info.py,sha256=IFokUFwNaExmPtKnHW5hgnYWodRtBM3cWhXBGb7lcjs,7751
 archunitpython/metrics/fluentapi/__init__.py,sha256=HD72MWF0hCh2LzKfyk3mMJp2tf7TJebpwTtZ_kppjso,84
-archunitpython/metrics/fluentapi/export_utils.py,sha256=qpv01BeoARhciyN7J05JIn-xMxbmxnoXGKBLwMYtlhM,2381
-archunitpython/metrics/fluentapi/metrics.py,sha256=0oo2EUEV8YWBiV1-v84LzPXX9sBBPOmmzgA34ZP0uQQ,19488
+archunitpython/metrics/fluentapi/export_utils.py,sha256=1r-zTQAUqn_agp4_lhbcffdzfdASNY3LebYvKAG9kcQ,2333
+archunitpython/metrics/fluentapi/metrics.py,sha256=EaH1seQKppXyx7DiPz1D-S1YYRt48OBWqdKn47BQhoA,19338
 archunitpython/metrics/projection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 archunitpython/slices/__init__.py,sha256=tb8MoZiEqIdmWy7uyhmEtMNm5Fxjuw6atSvDsD131DE,96
 archunitpython/slices/assertion/__init__.py,sha256=MRwV3d69ljAJ7hFYdxI6UDNC8U4Dm1ImeuLUVKEC9To,280
 archunitpython/slices/assertion/admissible_edges.py,sha256=-3o5mGtl81i5I_572x3Z4ZDfqPCyFqjGd7Dg8GRSKhY,3119
 archunitpython/slices/fluentapi/__init__.py,sha256=tb8MoZiEqIdmWy7uyhmEtMNm5Fxjuw6atSvDsD131DE,96
-archunitpython/slices/fluentapi/slices.py,sha256=KpkIKV9RDLwTFe05cmksIVEAgoYGoJwlHd35KmN2EOc,7183
+archunitpython/slices/fluentapi/slices.py,sha256=vNoyqmleTDTjnf2i35i2nte-Ycjm-oapfgaf3AhN0QI,7163
 archunitpython/slices/projection/__init__.py,sha256=tVgcK4gw-bqhUq98vU7_iPE0NEhOPUr7vr1-p7JI1A4,237
 archunitpython/slices/projection/slicing_projections.py,sha256=BHBkuVG80mqzT7N4FlCCfY5U_NvlXmAgTmHf_SPTXVM,4215
 archunitpython/slices/uml/__init__.py,sha256=GQFA5WBKfi_YElWiNWNm9c9IM-VaW83_Cg6kpwkzxkw,196
 archunitpython/slices/uml/export_diagram.py,sha256=FeBRV8Vt8LuhLqEbg5JzZOmEk2i49JPkozMcI5r335g,818
-archunitpython/slices/uml/generate_rules.py,sha256=zxiRW4PjVZHXdkQcXAycosbZ1do96SwpuqUoB2h0vDc,2180
+archunitpython/slices/uml/generate_rules.py,sha256=D9vvqDzHAM0F80z4u5yBalEqIiNfJJ5HGXP0fVlSzHw,2136
 archunitpython/testing/__init__.py,sha256=MJm6CHGhBGFg1um2L20-GD2DEHKqg8SiUoI-sRsoXQk,128
-archunitpython/testing/assertion.py,sha256=YTiNWHIQu4xlSqmlvqj1L-Z2Oo1Z-wOvN0VyZQB-CZE,1430
+archunitpython/testing/assertion.py,sha256=7cXlNwBklIGAyUJlPGFGAw97xZ9UgpkZvoO_QBdqm1c,1637
 archunitpython/testing/common/__init__.py,sha256=Wc4bC-N4t6giChKjj6wuTGKkb39thcYS_xKWG9paYeY,220
 archunitpython/testing/common/color_utils.py,sha256=2I8Z1SZfWhhgudMgmXY6PPydGxGl35cK_To-GXnSyJg,1226
-archunitpython/testing/common/violation_factory.py,sha256=mdtUGGAv_U6hrmucA32Y9aVQ_GXkirGJ_6W_YcnLfmY,4707
+archunitpython/testing/common/violation_factory.py,sha256=yWlvv2U7u-7KoTMfp1QCeJXxTLpPEagKqDHZmPSyrlk,4677
 archunitpython/testing/pytest_plugin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-archunitpython-1.2.0.dist-info/METADATA,sha256=GMRyeAEmJa3HMZRgDNPywINiQq8GTKdSMJGpK6MrVmA,28148
-archunitpython-1.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-archunitpython-1.2.0.dist-info/licenses/LICENSE,sha256=kaQWfzfHk45CNIx4sIW7Uf1sNW5rmo6BpZ-R8GruuK0,1102
-archunitpython-1.2.0.dist-info/RECORD,,
+archunitpython-1.3.0.dist-info/METADATA,sha256=79jbCuDyAMQr3aY3A_fesygIwS8hF8ceYaPRzJvUmrU,30275
+archunitpython-1.3.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+archunitpython-1.3.0.dist-info/licenses/LICENSE,sha256=kaQWfzfHk45CNIx4sIW7Uf1sNW5rmo6BpZ-R8GruuK0,1102
+archunitpython-1.3.0.dist-info/RECORD,,