chisel-checker 0.1.1__tar.gz

chisel_checker-0.1.1/.gitignore

@@ -0,0 +1,220 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+*.lcov
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi/*
+!.pixi/config.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule*
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml

chisel_checker-0.1.1/.grimp_cache/.gitignore

@@ -0,0 +1,2 @@
+# Automatically created by Grimp.
+*

chisel_checker-0.1.1/.grimp_cache/84239c1bc60433074e3d05309a9d0d09848ffd65.data.json

@@ -0,0 +1 @@
+{"myapp":[]}

chisel_checker-0.1.1/.grimp_cache/CACHEDIR.TAG

@@ -0,0 +1,3 @@
+Signature: 8a477f597d28d172789f06886806bc55
+# This file is a cache directory tag automatically created by Grimp.
+# For information about cache directory tags see https://bford.info/cachedir/

chisel_checker-0.1.1/.grimp_cache/af276a573254b22776d0a8d1fe8e976b0694e680.data.json

@@ -0,0 +1 @@
+{"chisel.checker.models.file_info":[["pathlib",4,"from pathlib import Path"],["ast",2,"import ast"],["chisel.checker.models.layer",6,"from chisel.checker.models.layer import Layer"],["dataclasses",3,"from dataclasses import dataclass, field"]],"chisel.checker.models.exemption":[["dataclasses",1,"from dataclasses import dataclass, field"]],"chisel.checker.models":[["chisel.checker.models.import_edge",4,"from chisel.checker.models.import_edge import ImportEdge"],["chisel.checker.models.violation",9,"from chisel.checker.models.violation import Violation"],["chisel.checker.models.exemption",2,"from chisel.checker.models.exemption import Exemption"],["chisel.checker.models.project_info",6,"from chisel.checker.models.project_info import ProjectInfo"],["chisel.checker.models.file_info",3,"from chisel.checker.models.file_info import FileInfo"],["chisel.checker.models.layer",5,"from chisel.checker.models.layer import Layer"],["chisel.checker.models.severity",8,"from chisel.checker.models.severity import Severity"],["chisel.checker.models.result",7,"from chisel.checker.models.result import CheckResult"]],"chisel.checker":[["chisel.checker.reporter",3,"from chisel.checker.reporter import Reporter"],["chisel.checker.factory",2,"from chisel.checker.factory import CheckerFactory"]],"chisel.checker.models.project_info":[["dataclasses",2,"from dataclasses import dataclass, field"],["chisel.checker.models.file_info",5,"from chisel.checker.models.file_info import FileInfo"],["pathlib",3,"from pathlib import Path"]],"chisel.checker.errors":[],"chisel.checker.models.import_edge":[["dataclasses",2,"from dataclasses import dataclass"]],"chisel.checker.models.severity":[["enum",2,"from enum import Enum"]],"chisel.checker.config":[["pathlib",3,"from pathlib import Path"],["dataclasses",2,"from dataclasses import dataclass, field"]],"chisel.checker.reporter":[["chisel.checker.models.violation",10,"from chisel.checker.models.violation import Violation"],["json",2,"import json"],["chisel.checker.models.result",8,"from chisel.checker.models.result import CheckResult"],["chisel.checker.models.severity",9,"from chisel.checker.models.severity import Severity"],["dataclasses",3,"from dataclasses import dataclass"],["rich",5,"from rich.console import Console"],["rich",6,"from rich.table import Table"]],"chisel.checker.models.violation":[["dataclasses",2,"from dataclasses import dataclass"],["chisel.checker.models.severity",4,"from chisel.checker.models.severity import Severity"]],"chisel.checker.models.result":[["dataclasses",2,"from dataclasses import dataclass, field"],["chisel.checker.models.violation",4,"from chisel.checker.models.violation import Violation"]],"chisel.checker.models.layer":[["enum",2,"from enum import Enum"]],"chisel.checker.factory":[["chisel",7,"from chisel.checker.services.app_file import AppFileService"],["chisel",6,"from chisel.checker.repositories.protocols import IImportGraph"],["chisel",16,"from chisel.checker.services.structural import StructuralService"],["chisel",14,"from chisel.checker.services.protocols import ICheckerService"],["chisel",5,"from chisel.checker.repositories.import_graph import ImportGraph"],["dataclasses",2,"from dataclasses import dataclass, field"],["chisel",11,"from chisel.checker.services.error_flow import ErrorFlowService"],["chisel",8,"from chisel.checker.services.complexity import ComplexityService"],["chisel",17,"from chisel.checker.services.suppression import SuppressionService"],["chisel",13,"from chisel.checker.services.project_structure import ProjectStructureService"],["chisel",4,"from chisel.checker.controllers.check_controller import CheckController"],["chisel",18,"from chisel.checker.services.check_test_structure import CheckTestStructureService"],["chisel",12,"from chisel.checker.services.import_boundary import ImportBoundaryService"],["chisel",9,"from chisel.checker.services.concurrency import ConcurrencyService"],["chisel",15,"from chisel.checker.services.session import SessionService"],["chisel",10,"from chisel.checker.services.config_startup import ConfigStartupService"]],"chisel":[["chisel.checker",2,"from chisel.checker import check_project"]]}

chisel_checker-0.1.1/.grimp_cache/chisel.meta.json

@@ -0,0 +1 @@
+{"chisel.checker.models": 1780432167.138717, "chisel.checker.config": 1780432167.138717, "chisel.checker.models.result": 1780432167.1388886, "chisel.checker.models.project_info": 1780432167.1388886, "chisel.checker.reporter": 1780432167.1388886, "chisel.checker": 1780432167.138681, "chisel.checker.models.file_info": 1780432167.1388886, "chisel.checker.factory": 1780432167.138717, "chisel.checker.models.violation": 1780432167.1388886, "chisel": 1780432167.1386375, "chisel.checker.models.import_edge": 1780432167.1388886, "chisel.checker.errors": 1780432167.138717, "chisel.checker.models.exemption": 1780432167.1388886, "chisel.checker.models.severity": 1780432167.1388886, "chisel.checker.models.layer": 1780432167.1388886}

chisel_checker-0.1.1/.grimp_cache/myapp.meta.json

@@ -0,0 +1 @@
+{"myapp": 1780432174.5208745}

chisel_checker-0.1.1/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: chisel_checker
+Version: 0.1.1
+Summary: Opinionated architecture constraint checker
+Author-email: ChidiRNweke <chidi125@gmail.com>
+Requires-Python: >=3.11
+Requires-Dist: grimp>=3.0
+Requires-Dist: radon>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: tomli>=2.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# chisel
+
+Opinionated architecture constraint checker for FastAPI backends. Designed to catch the patterns agents get wrong — use it as a pre-commit hook to block violations, or run it interactively to steer an agent while it's working.
+
+It pairs with [agent skills](https://github.com/ChidiRnweke/chisel/tree/master/skills): the skill teaches the agent the right pattern, the checker enforces it deterministically. Run `chisel explain <rule-id>` to get fix guidance the agent can consume directly.
+
+## Installation
+
+```bash
+pip install chisel
+```
+
+## Quick start
+
+```bash
+chisel check ./backend              # check a project
+chisel rules                        # list all ~55 rules grouped by category
+chisel explain structural:print-banned  # detailed fix guidance
+chisel check . --json               # machine-readable output for agents
+chisel check . --no-strict          # skip src-layout enforcement
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `chisel check [path]` | Scan a project for architectural violations |
+| `chisel check . --json` | Output violations as structured JSON |
+| `chisel check . --strict/--no-strict` | Toggle src-layout and build-config enforcement |
+| `chisel rules` | List all rules, grouped by category |
+| `chisel rules --json` | Machine-readable rule listing |
+| `chisel explain <rule-id>` | Detailed description + fix guidance for a rule |
+| `chisel explain <category>` | All rules in a category (e.g. `structural`) |
+
+## What gets checked
+
+| Category | What it enforces |
+|---|---|
+| **Import Boundaries** | Layer-based import restrictions — services can't import SQLAlchemy, routes can't import services, `HTTPException` only in `error_handlers.py`, concrete services only in `factory.py` |
+| **Structural Invariants** | No `getattr`/`setattr`, no `%` string formatting, no f-strings in logger calls, no `print()` in `src/`, `@dataclass` uses `slots=True`, `AppFactory` has zero logic, `match/case` only in error handlers |
+| **Complexity** | Controller method ≤30 LoC, route handler ≤20 LoC, factory cyclomatic complexity = 1, `app.py` ≤50 LoC |
+| **Concurrency** | `asyncio.gather` banned unconditionally — use `asyncio.TaskGroup` |
+| **Error Flow** | `AppError` subclasses never contain HTTP status codes; status codes decided only in `error_handlers.py` |
+| **Project Structure** | `pyproject.toml` only (no `setup.py`), env vars read at startup only via `AppConfig`, no `.py` files at project root |
+| **Test Structure** | Test files only under `tests/unit/`, `tests/integration/`, `tests/e2e/`; one `assert` per test; no mocking libraries; test names describe invariants; `pytest.mark.skip` needs a reason; no `TestClient` outside e2e |
+
+## Exceptions
+
+Create a `chisel-exceptions.toml` at your project root:
+
+```toml
+[[exceptions]]
+files = ["src/legacy/*.py", "src/cli/main.py"]
+rules = ["structural:print-banned"]
+reason = "CLI requires stdout output"
+```
+
+`*` matches all rules. A category prefix like `structural` matches all rules in that category.
+
+Inline suppression per line: `# noqa: rule-id — reason`.
+
+## Severity tiers
+
+| Tier | Behaviour |
+|---|---|
+| **ERROR** | Blocks commit, no override. Import boundary violations, `asyncio.gather`, `getattr`/`setattr`, f-string in logger, `print()` in `src/`. |
+| **WARNING** | Blocks commit, suppressible with a reason comment. Controller/route LoC thresholds, test coverage gaps. |
+| **INFO** | Logged, non-blocking. |
+
+## How it works
+
+```
+models/         Pure data — Violation, Severity, FileInfo, ProjectInfo
+services/       One service per rule category, self-describing via describe_rules()
+repositories/   File discovery, import graph analysis (grimp)
+controllers/    Orchestrates all services, filters exceptions, suppresses via noqa
+factory.py      Zero-logic DI — wires all services into the controller
+cli/main.py     Typer-based CLI — check, rules, explain
+reporter.py     Coloured terminal output via rich
+```
+
+Adding a rule requires one new check method in a service + one `describe_rules()` entry. The CLI discovers it automatically.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -q
+```
+
+The checker is self-validating: `chisel check . --strict` produces zero violations on its own source.
+

chisel_checker-0.1.1/README.md

@@ -0,0 +1,92 @@
+# chisel
+
+Opinionated architecture constraint checker for FastAPI backends. Designed to catch the patterns agents get wrong — use it as a pre-commit hook to block violations, or run it interactively to steer an agent while it's working.
+
+It pairs with [agent skills](https://github.com/ChidiRnweke/chisel/tree/master/skills): the skill teaches the agent the right pattern, the checker enforces it deterministically. Run `chisel explain <rule-id>` to get fix guidance the agent can consume directly.
+
+## Installation
+
+```bash
+pip install chisel
+```
+
+## Quick start
+
+```bash
+chisel check ./backend              # check a project
+chisel rules                        # list all ~55 rules grouped by category
+chisel explain structural:print-banned  # detailed fix guidance
+chisel check . --json               # machine-readable output for agents
+chisel check . --no-strict          # skip src-layout enforcement
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `chisel check [path]` | Scan a project for architectural violations |
+| `chisel check . --json` | Output violations as structured JSON |
+| `chisel check . --strict/--no-strict` | Toggle src-layout and build-config enforcement |
+| `chisel rules` | List all rules, grouped by category |
+| `chisel rules --json` | Machine-readable rule listing |
+| `chisel explain <rule-id>` | Detailed description + fix guidance for a rule |
+| `chisel explain <category>` | All rules in a category (e.g. `structural`) |
+
+## What gets checked
+
+| Category | What it enforces |
+|---|---|
+| **Import Boundaries** | Layer-based import restrictions — services can't import SQLAlchemy, routes can't import services, `HTTPException` only in `error_handlers.py`, concrete services only in `factory.py` |
+| **Structural Invariants** | No `getattr`/`setattr`, no `%` string formatting, no f-strings in logger calls, no `print()` in `src/`, `@dataclass` uses `slots=True`, `AppFactory` has zero logic, `match/case` only in error handlers |
+| **Complexity** | Controller method ≤30 LoC, route handler ≤20 LoC, factory cyclomatic complexity = 1, `app.py` ≤50 LoC |
+| **Concurrency** | `asyncio.gather` banned unconditionally — use `asyncio.TaskGroup` |
+| **Error Flow** | `AppError` subclasses never contain HTTP status codes; status codes decided only in `error_handlers.py` |
+| **Project Structure** | `pyproject.toml` only (no `setup.py`), env vars read at startup only via `AppConfig`, no `.py` files at project root |
+| **Test Structure** | Test files only under `tests/unit/`, `tests/integration/`, `tests/e2e/`; one `assert` per test; no mocking libraries; test names describe invariants; `pytest.mark.skip` needs a reason; no `TestClient` outside e2e |
+
+## Exceptions
+
+Create a `chisel-exceptions.toml` at your project root:
+
+```toml
+[[exceptions]]
+files = ["src/legacy/*.py", "src/cli/main.py"]
+rules = ["structural:print-banned"]
+reason = "CLI requires stdout output"
+```
+
+`*` matches all rules. A category prefix like `structural` matches all rules in that category.
+
+Inline suppression per line: `# noqa: rule-id — reason`.
+
+## Severity tiers
+
+| Tier | Behaviour |
+|---|---|
+| **ERROR** | Blocks commit, no override. Import boundary violations, `asyncio.gather`, `getattr`/`setattr`, f-string in logger, `print()` in `src/`. |
+| **WARNING** | Blocks commit, suppressible with a reason comment. Controller/route LoC thresholds, test coverage gaps. |
+| **INFO** | Logged, non-blocking. |
+
+## How it works
+
+```
+models/         Pure data — Violation, Severity, FileInfo, ProjectInfo
+services/       One service per rule category, self-describing via describe_rules()
+repositories/   File discovery, import graph analysis (grimp)
+controllers/    Orchestrates all services, filters exceptions, suppresses via noqa
+factory.py      Zero-logic DI — wires all services into the controller
+cli/main.py     Typer-based CLI — check, rules, explain
+reporter.py     Coloured terminal output via rich
+```
+
+Adding a rule requires one new check method in a service + one `describe_rules()` entry. The CLI discovers it automatically.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -q
+```
+
+The checker is self-validating: `chisel check . --strict` produces zero violations on its own source.
+

chisel_checker-0.1.1/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "chisel_checker"
+version = "0.1.1"
+description = "Opinionated architecture constraint checker"
+readme = {file = "README.md", content-type = "text/markdown"}
+authors = [
+    { name = "ChidiRNweke", email = "chidi125@gmail.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "grimp>=3.0",
+    "radon>=6.0",
+    "typer>=0.12",
+    "rich>=13.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "tomli>=2.0",
+]
+
+[project.scripts]
+chisel = "chisel.cli.main:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/chisel"]

chisel_checker-0.1.1/src/chisel/__init__.py

@@ -0,0 +1,4 @@
+
+from chisel.checker import check_project
+
+__all__ = ["check_project"]

chisel_checker-0.1.1/src/chisel/checker/__init__.py

@@ -0,0 +1,11 @@
+
+from chisel.checker.factory import CheckerFactory
+from chisel.checker.reporter import Reporter
+
+
+def check_project(project_path: str) -> None:
+    factory = CheckerFactory()
+    controller = factory.create_controller()
+    result = controller.check(project_path)
+    reporter = Reporter()
+    reporter.report(result)

chisel_checker-0.1.1/src/chisel/checker/config.py

@@ -0,0 +1,9 @@
+
+from dataclasses import dataclass, field
+from pathlib import Path
+
+
+@dataclass(slots=True)
+class CheckerConfig:
+    target_path: Path = field(default_factory=Path.cwd)
+    strict: bool = True

chisel_checker-0.1.1/src/chisel/checker/controllers/check_controller.py

@@ -0,0 +1,124 @@
+
+import ast
+import sys
+from dataclasses import dataclass, field
+from pathlib import Path
+
+from chisel.checker.errors import ImportGraphError
+from chisel.checker.models.project_info import ProjectInfo
+from chisel.checker.models.result import CheckResult
+from chisel.checker.models.severity import Severity
+from chisel.checker.models.violation import Violation
+from chisel.checker.repositories.file_discovery import FileDiscovery
+from chisel.checker.repositories.file_reader import FileReader
+from chisel.checker.repositories.import_graph import ImportGraph
+from chisel.checker.repositories.protocols import IImportGraph
+from chisel.checker.services.protocols import ICheckerService, ISuppressionService
+
+
+from chisel.checker.repositories.exception_registry import ExceptionRegistry
+
+
+@dataclass(slots=True)
+class CheckController:
+    _suppression: ISuppressionService
+    _services: list[ICheckerService] = field(default_factory=list)
+    _import_graph: IImportGraph = field(default_factory=ImportGraph)  # noqa
+
+    def check(self, project_path: str) -> CheckResult:
+        root = Path(project_path).resolve()
+        project = self._prepare_project(root)
+        violations: list[Violation] = []
+
+        if project.package_name:
+            try:
+                self._build_import_graph(root, project.package_name)
+            except ImportGraphError as exc:
+                violations.append(
+                    Violation(
+                        file="<import-graph>",
+                        line=0,
+                        severity=Severity.WARNING,
+                        rule_id="import-graph:build-failed",
+                        message=str(exc),
+                    )
+                )
+
+        violations.extend(self._run_services(project))
+        violations = self._apply_exceptions(root, violations)
+        sources = self._collect_sources(project)
+        active = self._suppression.check(violations, sources)
+        return self._summarize(active, len(project.files))
+
+    def _prepare_project(self, root: Path) -> ProjectInfo:
+        discovery = FileDiscovery()
+        project = discovery.discover(root)
+        reader = FileReader()
+        populated = [
+            self._load_file(f, root, reader) for f in project.files
+        ]
+        return ProjectInfo(
+            root_path=project.root_path,
+            files=populated,
+            package_name=project.package_name,
+        )
+
+    def _load_file(
+        self, file_info, root: Path, reader: FileReader
+    ):
+        try:
+            source = reader.read(root / file_info.path)
+            return type(file_info)(
+                path=file_info.path,
+                layer=file_info.layer,
+                source=source,
+                ast_tree=ast.parse(source),
+            )
+        except Exception:
+            return file_info
+
+    def _build_import_graph(self, root: Path, package_name: str) -> None:
+        src = root / "src"
+        src_path = str(src) if src.is_dir() else str(root)
+        original_path = list(sys.path)
+        try:
+            if src_path not in sys.path:
+                sys.path.insert(0, src_path)
+            self._import_graph.build(root, package_name)
+        except Exception as exc:
+            raise ImportGraphError(
+                f"Failed to build import graph for "
+                f"'{package_name}': {exc}"
+            ) from exc
+        finally:
+            sys.path = original_path
+
+    def _run_services(self, project: ProjectInfo) -> list[Violation]:
+        violations: list[Violation] = []
+        for service in self._services:
+            violations.extend(service.check(project))
+        return violations
+
+    def _collect_sources(self, project: ProjectInfo) -> dict[str, str]:
+        return {str(f.path): f.source for f in project.files}
+
+    def _apply_exceptions(
+        self, root: Path, violations: list[Violation]
+    ) -> list[Violation]:
+        registry = ExceptionRegistry()
+        registry.load(root)
+        return registry.filter(violations)
+
+    def _summarize(
+        self, violations: list[Violation], files_checked: int
+    ) -> CheckResult:
+        errors = sum(1 for v in violations if v.severity == Severity.ERROR)
+        warnings = sum(1 for v in violations if v.severity == Severity.WARNING)
+        info = sum(1 for v in violations if v.severity == Severity.INFO)
+        return CheckResult(
+            violations=violations,
+            errors=errors,
+            warnings=warnings,
+            info=info,
+            files_checked=files_checked,
+        )

chisel_checker-0.1.1/src/chisel/checker/errors.py

@@ -0,0 +1,16 @@
+
+
+class CheckerError(Exception):
+    pass
+
+
+class FileNotFoundError(CheckerError):
+    pass
+
+
+class ImportGraphError(CheckerError):
+    pass
+
+
+class ConfigError(CheckerError):
+    pass