py-import-checker 0.2.0__tar.gz

py_import_checker-0.2.0/.gitignore

@@ -0,0 +1,35 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Tools
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+*.prof
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

py_import_checker-0.2.0/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+## [0.1.0] — 2026-06-08
+
+### Added
+- Core `check_directory()` engine using `importlib.util`
+- Zero dependencies — stdlib only
+- CLI (`py-import-checker`) with `--src`, `--glob`, `--verbose` flags
+- src-layout support via `--src` (repeatable)
+- Auto-skip `.venv`, `venv`, `__pycache__`, `dist`, `build`
+- Exit codes: `0` success · `1` broken imports · `2` bad args
+- 9 unit tests (checker + CLI)
+- GitHub Actions CI: Python 3.9–3.12 matrix + self-scan job
+- `pyproject.toml` with Hatchling, ruff, mypy
+
+[Unreleased]: https://github.com/matthieugraziani/py-import-checker/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/matthieugraziani/py-import-checker/releases/tag/v0.1.0

py_import_checker-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 matthieugraziani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

py_import_checker-0.2.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: py-import-checker
+Version: 0.2.0
+Summary: Fast, zero-dependency Python import health scanner
+Project-URL: Homepage, https://github.com/matthieugraziani/py-import-checker
+Project-URL: Repository, https://github.com/matthieugraziani/py-import-checker
+Project-URL: Issues, https://github.com/matthieugraziani/py-import-checker/issues
+Project-URL: Changelog, https://github.com/matthieugraziani/py-import-checker/blob/main/CHANGELOG.md
+Author-email: Matthieu Graziani <matthieu.graziani@proton.me>
+License: MIT
+License-File: LICENSE
+Keywords: cli,debugging,developer-tools,import-checker,imports,linting,static-analysis
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <h1 align="center">py-import-checker</h1>
+  <p align="center">
+    <strong>Fast, zero-dependency Python import health scanner.</strong>
+  </p>
+
+  <p align="center">
+    Recursively scan any Python project and instantly surface every broken or missing import — 
+    <strong>before your tests run, before CI fails, before runtime surprises you.</strong>
+  </p>
+
+  <p align="center">
+    <a href="https://pypi.org/project/py-import-checker/">
+      <img src="https://img.shields.io/pypi/v/py-import-checker.svg" alt="PyPI version">
+    </a>
+    <a href="https://github.com/matthieugraziani/py-import-checker/actions">
+      <img src="https://github.com/matthieugraziani/py-import-checker/actions/workflows/ci.yml/badge.svg" alt="Tests">
+    </a>
+    <a href="https://opensource.org/licenses/MIT">
+      <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT">
+    </a>
+    <img src="https://img.shields.io/badge/Python-3.10%2B-blue" alt="Python 3.10+">
+  </p>
+</p>
+
+```text
+py-import-checker src/ --src src/
+
+  py-import-checker  —  Python import health scanner
+
+  Scanning  /home/user/myproject/src
+
+──────────────────────────────────────────────────
+  ✗  mypackage/broken_module.py
+     ModuleNotFoundError: No module named 'nonexistent_lib'
+
+──────────────────────────────────────────────────
+✗ 1 broken import(s) found in 14 file(s) scanned.
+
+```
+
+## Features
+
+- **Zero dependencies** — uses only the Python standard library (`importlib`, `pathlib`, `sys`)
+- **src-layout aware** — pass `--src` to add extra directories to `sys.path`
+- **Noise-free** — only reports `ImportError` / `ModuleNotFoundError`; ignores runtime exceptions
+- **Auto-skips** virtual environments (`.venv`, `venv`) and build artefacts
+- **CI-friendly** — exits with code `1` on any broken import, `0` on success
+- **Self-checking** — the CI pipeline scans itself with `py-import-checker`
+
+
+## Installation
+
+```bash
+pip install py-import-checker
+```
+
+Or install from source (editable):
+
+```bash
+git clone https://github.com/matthieugraziani/py-import-checker
+cd py-import-checker
+pip install -e .
+```
+
+## Usage
+
+### Command line
+
+```bash
+# Scan the current directory
+py-import-checker
+
+# Scan a specific directory
+py-import-checker path/to/project
+
+# src-layout project (adds src/ to sys.path)
+py-import-checker . --src src/
+
+# Multiple extra paths
+py-import-checker . --src src/ --src lib/
+
+# Custom file glob
+py-import-checker . --glob "app/**/*.py"
+
+# Verbose output (show all files, not just errors)
+py-import-checker . -v
+```
+
+### Python API
+
+```python
+from pathlib import Path
+from py_import_checker.checker import check_directory
+
+result = check_directory(
+    root=Path("src/"),
+    extra_paths=[Path("src/")],
+)
+
+if not result.success:
+    for err in result.errors:
+        print(f"{err.file}: {err.error_type}: {err.message}")
+```
+
+### Pre-commit hook
+Ajoutez ceci à votre fichier .pre-commit-config.yaml :
+```yaml
+# .pre-commit-config.yaml
+repos:
+  - repo: https://github.com/matthieugraziani/py-import-checker
+    rev: v0.1.0
+    hooks:
+      - id: py-import-checker
+        args: [--src, src/]
+```
+
+### GitHub Actions
+
+```yaml
+- name: Check imports
+  run: |
+    pip install py-import-checker
+    py-import-checker . --src src/
+```
+
+
+
+## How it works
+
+py-import-checker utilise importlib.util.spec_from_file_location pour charger chaque fichier .py dans un namespace isolé. Seules les erreurs d’import sont capturées — tout le reste (erreurs runtime, variables manquantes, etc.) est ignoré.
+
+
+## Roadmap (suggestions)
+
+- Mode --fix (suggestions d’imports)
+- Support des packages namespace (__init__.py moins strict)
+- Intégration VS Code / LSP
+- Rapport HTML / JSON
+- Détection de circular imports (optionnel)
+
+---
+
+## Development
+
+```bash
+# Install with dev extras
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check src/ tests/
+
+# Type-check
+mypy src/
+```
+
+---
+
+## License - MIT
+
+Auteur : Matthieu Graziani
+```text
+### Améliorations apportées
+- En-tête centré + badges propres
+- Démo plus visible
+- Sections plus aérées
+- Roadmap ajoutée (pour montrer l’évolution)
+- Meilleure lisibilité
+
+### Actions prioritaires maintenant
+1. **Publier sur PyPI** (version 0.1.0 ou 0.2.0) :
+   ```bash
+   hatch build
+   hatch publish
+```

py_import_checker-0.2.0/README.md

@@ -0,0 +1,178 @@
+<p align="center">
+  <h1 align="center">py-import-checker</h1>
+  <p align="center">
+    <strong>Fast, zero-dependency Python import health scanner.</strong>
+  </p>
+
+  <p align="center">
+    Recursively scan any Python project and instantly surface every broken or missing import — 
+    <strong>before your tests run, before CI fails, before runtime surprises you.</strong>
+  </p>
+
+  <p align="center">
+    <a href="https://pypi.org/project/py-import-checker/">
+      <img src="https://img.shields.io/pypi/v/py-import-checker.svg" alt="PyPI version">
+    </a>
+    <a href="https://github.com/matthieugraziani/py-import-checker/actions">
+      <img src="https://github.com/matthieugraziani/py-import-checker/actions/workflows/ci.yml/badge.svg" alt="Tests">
+    </a>
+    <a href="https://opensource.org/licenses/MIT">
+      <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT">
+    </a>
+    <img src="https://img.shields.io/badge/Python-3.10%2B-blue" alt="Python 3.10+">
+  </p>
+</p>
+
+```text
+py-import-checker src/ --src src/
+
+  py-import-checker  —  Python import health scanner
+
+  Scanning  /home/user/myproject/src
+
+──────────────────────────────────────────────────
+  ✗  mypackage/broken_module.py
+     ModuleNotFoundError: No module named 'nonexistent_lib'
+
+──────────────────────────────────────────────────
+✗ 1 broken import(s) found in 14 file(s) scanned.
+
+```
+
+## Features
+
+- **Zero dependencies** — uses only the Python standard library (`importlib`, `pathlib`, `sys`)
+- **src-layout aware** — pass `--src` to add extra directories to `sys.path`
+- **Noise-free** — only reports `ImportError` / `ModuleNotFoundError`; ignores runtime exceptions
+- **Auto-skips** virtual environments (`.venv`, `venv`) and build artefacts
+- **CI-friendly** — exits with code `1` on any broken import, `0` on success
+- **Self-checking** — the CI pipeline scans itself with `py-import-checker`
+
+
+## Installation
+
+```bash
+pip install py-import-checker
+```
+
+Or install from source (editable):
+
+```bash
+git clone https://github.com/matthieugraziani/py-import-checker
+cd py-import-checker
+pip install -e .
+```
+
+## Usage
+
+### Command line
+
+```bash
+# Scan the current directory
+py-import-checker
+
+# Scan a specific directory
+py-import-checker path/to/project
+
+# src-layout project (adds src/ to sys.path)
+py-import-checker . --src src/
+
+# Multiple extra paths
+py-import-checker . --src src/ --src lib/
+
+# Custom file glob
+py-import-checker . --glob "app/**/*.py"
+
+# Verbose output (show all files, not just errors)
+py-import-checker . -v
+```
+
+### Python API
+
+```python
+from pathlib import Path
+from py_import_checker.checker import check_directory
+
+result = check_directory(
+    root=Path("src/"),
+    extra_paths=[Path("src/")],
+)
+
+if not result.success:
+    for err in result.errors:
+        print(f"{err.file}: {err.error_type}: {err.message}")
+```
+
+### Pre-commit hook
+Ajoutez ceci à votre fichier .pre-commit-config.yaml :
+```yaml
+# .pre-commit-config.yaml
+repos:
+  - repo: https://github.com/matthieugraziani/py-import-checker
+    rev: v0.1.0
+    hooks:
+      - id: py-import-checker
+        args: [--src, src/]
+```
+
+### GitHub Actions
+
+```yaml
+- name: Check imports
+  run: |
+    pip install py-import-checker
+    py-import-checker . --src src/
+```
+
+
+
+## How it works
+
+py-import-checker utilise importlib.util.spec_from_file_location pour charger chaque fichier .py dans un namespace isolé. Seules les erreurs d’import sont capturées — tout le reste (erreurs runtime, variables manquantes, etc.) est ignoré.
+
+
+## Roadmap (suggestions)
+
+- Mode --fix (suggestions d’imports)
+- Support des packages namespace (__init__.py moins strict)
+- Intégration VS Code / LSP
+- Rapport HTML / JSON
+- Détection de circular imports (optionnel)
+
+---
+
+## Development
+
+```bash
+# Install with dev extras
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check src/ tests/
+
+# Type-check
+mypy src/
+```
+
+---
+
+## License - MIT
+
+Auteur : Matthieu Graziani
+```text
+### Améliorations apportées
+- En-tête centré + badges propres
+- Démo plus visible
+- Sections plus aérées
+- Roadmap ajoutée (pour montrer l’évolution)
+- Meilleure lisibilité
+
+### Actions prioritaires maintenant
+1. **Publier sur PyPI** (version 0.1.0 ou 0.2.0) :
+   ```bash
+   hatch build
+   hatch publish
+```

py_import_checker-0.2.0/pyproject.toml

@@ -0,0 +1,109 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "py-import-checker"
+version = "0.2.0"                    # ← mis à jour
+description = "Fast, zero-dependency Python import health scanner"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Matthieu Graziani", email = "matthieu.graziani@proton.me" }]  # ← recommandé
+requires-python = ">=3.9"
+keywords = ["imports", "linting", "static-analysis", "debugging", "developer-tools", "cli", "import-checker"]
+classifiers = [
+    "Development Status :: 4 - Beta",           # ← passé en Beta
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Testing",
+]
+
+[project.scripts]
+py-import-checker = "py_import_checker.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/matthieugraziani/py-import-checker"
+Repository = "https://github.com/matthieugraziani/py-import-checker"
+Issues = "https://github.com/matthieugraziani/py-import-checker/issues"
+Changelog = "https://github.com/matthieugraziani/py-import-checker/blob/main/CHANGELOG.md"
+
+# === Hatch Configuration ===
+[tool.hatch.version]
+path = "src/py_import_checker/__init__.py"   # recommande cette approche (version centralisée)
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/py_import_checker"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/py_import_checker",
+    "tests",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+]
+
+# === Environments ===
+[tool.hatch.envs.default]
+dependencies = [
+    "pytest>=8.0",
+    "pytest-cov>=6.0",
+    "mypy>=1.10",
+    "ruff>=0.9",
+]
+
+[tool.hatch.envs.default.scripts]
+lint = "ruff check src/ tests/"
+format = "ruff format src/ tests/"
+type-check = "mypy src/"
+test = "pytest --cov=py_import_checker --cov-report=term-missing"
+test-all = ["lint", "type-check", "test"]
+all = ["format", "lint", "type-check", "test"]
+
+[tool.hatch.envs.dev]
+dependencies = [
+    "pytest>=8.0",
+    "pytest-cov>=6.0",
+    "mypy>=1.10",
+    "ruff>=0.9",
+]
+
+# === Tooling Config ===
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "PL", "RUF"]
+ignore = ["E501"]
+fixable = ["ALL"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["PLR2004"]   # Magic values are common and acceptable in tests
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+ignore_missing_imports = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --tb=short --cov=py_import_checker --cov-report=term-missing"
+python_files = ["test_*.py", "*_test.py"]
+
+# Optionnel : Coverage
+[tool.coverage.run]
+source = ["py_import_checker"]
+omit = ["tests/*", "src/py_import_checker/__main__.py"]

py_import_checker-0.2.0/src/py_import_checker/__init__.py

@@ -0,0 +1,4 @@
+"""py-import-checker: Fast, zero-dependency Python import health scanner."""
+
+__version__ = "0.1.0"
+__author__ = "matthieugraziani"

py_import_checker-0.2.0/src/py_import_checker/checker.py

@@ -0,0 +1,96 @@
+"""Core import verification engine."""
+
+from __future__ import annotations
+
+import importlib.util
+import sys
+from dataclasses import dataclass, field
+from pathlib import Path
+
+
+@dataclass
+class ImportFailure:
+    """Represents a single import failure."""
+
+    file: Path
+    error_type: str
+    message: str
+
+
+@dataclass
+class CheckResult:
+    """Aggregated result from a full scan."""
+
+    checked: int = 0
+    errors: list[ImportFailure] = field(default_factory=list)
+
+    @property
+    def success(self) -> bool:
+        return len(self.errors) == 0
+
+
+_SKIP_PARTS = {".venv", "venv", "__pycache__", ".git", "node_modules", "dist", "build"}
+
+
+def _should_skip(path: Path, script_path: Path) -> bool:
+    if path.resolve() == script_path.resolve():
+        return True
+    return any(part in _SKIP_PARTS for part in path.parts)
+
+
+def check_directory(
+    root: Path,
+    extra_paths: list[Path] | None = None,
+    glob: str = "**/*.py",
+) -> CheckResult:
+    """
+    Scan all Python files under *root* and attempt to import each one.
+
+    Parameters
+    ----------
+    root:
+        Directory to scan recursively.
+    extra_paths:
+        Additional paths inserted at the front of sys.path before scanning
+        (e.g. the project ``src/`` directory).
+    glob:
+        Glob pattern used to find Python files (default: ``**/*.py``).
+    """
+    root = root.resolve()
+    script_path = Path(__file__).resolve()
+
+    paths_to_add = [root] + (extra_paths or [])
+    for p in reversed(paths_to_add):
+        p_str = str(p)
+        if p_str not in sys.path:
+            sys.path.insert(0, p_str)
+
+    result = CheckResult()
+
+    for file_path in sorted(root.glob(glob)):
+        if _should_skip(file_path, script_path):
+            continue
+
+        result.checked += 1
+        relative = file_path.relative_to(root)
+        module_name = ".".join(relative.with_suffix("").parts)
+
+        try:
+            spec = importlib.util.spec_from_file_location(module_name, file_path)
+            if spec and spec.loader:
+                module = importlib.util.module_from_spec(spec)
+                sys.modules[module_name] = module
+                spec.loader.exec_module(module)
+        except (ModuleNotFoundError, ImportError) as exc:
+            result.errors.append(
+                ImportFailure(
+                    file=relative,
+                    error_type=type(exc).__name__,
+                    message=str(exc),
+                )
+            )
+        except Exception:  # pylint: disable=broad-exception-caught
+            # Ignore pure runtime errors — only structural import issues matter.
+            pass
+
+    return result

py_import_checker-0.2.0/src/py_import_checker/cli.py

@@ -0,0 +1,110 @@
+"""Command-line interface for py-import-checker."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from .checker import CheckResult, check_directory
+
+RESET = "\033[0m"
+BOLD = "\033[1m"
+GREEN = "\033[32m"
+RED = "\033[31m"
+YELLOW = "\033[33m"
+CYAN = "\033[36m"
+DIM = "\033[2m"
+
+
+def _banner() -> None:
+    print(f"\n{BOLD}{CYAN}py-import-checker{RESET}  —  Python import health scanner\n")
+
+
+def _print_result(result: CheckResult, verbose: bool) -> None:
+    if verbose:
+        print(f"{DIM}Verbose mode enabled.{RESET}\n")
+
+    if result.errors:
+        print(f"{YELLOW}{'─' * 50}{RESET}")
+        for err in result.errors:
+            print(f"  {RED}✗{RESET}  {BOLD}{err.file}{RESET}")
+            print(f"     {DIM}{err.error_type}: {err.message}{RESET}\n")
+
+    print(f"{'─' * 50}")
+    total = result.checked
+    n_err = len(result.errors)
+
+    if result.success:
+        print(
+            f"{GREEN}{BOLD}✓ All clear!{RESET}"
+            f"  {total} file(s) checked — no broken imports.\n"
+        )
+    else:
+        print(
+            f"{RED}{BOLD}✗ {n_err} broken import(s){RESET}"
+            f" found in {total} file(s) scanned.\n"
+        )
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="py-import-checker",
+        description="Scan a Python project for broken imports.",
+    )
+    parser.add_argument(
+        "path",
+        nargs="?",
+        default=".",
+        help="Root directory to scan (default: current directory).",
+    )
+    parser.add_argument(
+        "--src",
+        metavar="DIR",
+        action="append",
+        default=[],
+        help=(
+            "Extra directory to prepend to sys.path (repeatable). "
+            "Useful for src-layout projects."
+        ),
+    )
+    parser.add_argument(
+        "--glob",
+        default="**/*.py",
+        help="Glob pattern for file discovery (default: **/*.py).",
+    )
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        action="store_true",
+        help="Show all scanned files, not just errors.",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version="%(prog)s 0.1.0",
+    )
+
+    args = parser.parse_args(argv)
+    root = Path(args.path).resolve()
+
+    if not root.exists():
+        print(f"{RED}Error: path '{root}' does not exist.{RESET}", file=sys.stderr)
+        return 2
+
+    extra = [Path(p).resolve() for p in args.src]
+
+    _banner()
+    print(f"  {DIM}Scanning  {root}{RESET}")
+    if extra:
+        print(f"  {DIM}sys.path  {', '.join(str(p) for p in extra)}{RESET}")
+    print()
+
+    result = check_directory(root, extra_paths=extra, glob=args.glob)
+    _print_result(result, args.verbose)
+
+    return 0 if result.success else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

py_import_checker-0.2.0/tests/test_checker.py

@@ -0,0 +1,125 @@
+"""Tests for py-import-checker."""
+
+from __future__ import annotations
+
+import textwrap
+from pathlib import Path
+
+from py_import_checker.checker import check_directory
+from py_import_checker.cli import main
+
+# ---------------------------------------------------------------------------
+# Test constants (évite les magic numbers → PLR2004)
+# ---------------------------------------------------------------------------
+
+EXPECTED_SUCCESS_CHECKED = 2
+EXPECTED_MULTIPLE_ERRORS = 2
+EXPECTED_MULTIPLE_CHECKED = 3
+EXPECTED_CLI_SUCCESS = 0
+EXPECTED_CLI_FAILURE = 1
+EXPECTED_CLI_ERROR = 2   # Convention courante pour "command line usage error"
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def write_py(tmp_path: Path, name: str, content: str) -> Path:
+    """Write a Python file inside *tmp_path* and return its path."""
+    p = tmp_path / name
+    p.write_text(textwrap.dedent(content))
+    return p
+
+
+# ---------------------------------------------------------------------------
+# checker.check_directory
+# ---------------------------------------------------------------------------
+
+
+def test_clean_project(tmp_path: Path) -> None:
+    write_py(tmp_path, "mod_a.py", "x = 1\n")
+    write_py(tmp_path, "mod_b.py", "from mod_a import x\n")
+
+    result = check_directory(tmp_path)
+
+    assert result.success
+    assert result.checked == EXPECTED_SUCCESS_CHECKED
+    assert result.errors == []
+
+
+def test_broken_import_detected(tmp_path: Path) -> None:
+    write_py(tmp_path, "broken.py", "import _nonexistent_pkg_xyz\n")
+
+    result = check_directory(tmp_path)
+
+    assert not result.success
+    assert len(result.errors) == 1
+    assert result.errors[0].error_type == "ModuleNotFoundError"
+    assert "_nonexistent_pkg_xyz" in result.errors[0].message
+
+
+def test_runtime_error_ignored(tmp_path: Path) -> None:
+    """Pure runtime errors (NameError, ZeroDivisionError…) must NOT be reported."""
+    write_py(tmp_path, "runtime_err.py", "x = 1 / 0\n")
+
+    result = check_directory(tmp_path)
+
+    assert result.success
+    assert result.checked == 1
+
+
+def test_venv_skipped(tmp_path: Path) -> None:
+    venv_dir = tmp_path / ".venv" / "lib"
+    venv_dir.mkdir(parents=True)
+    (venv_dir / "something.py").write_text("import _nope\n")
+    write_py(tmp_path, "good.py", "pass\n")
+
+    result = check_directory(tmp_path)
+
+    assert result.success
+    assert result.checked == 1
+
+
+def test_multiple_errors(tmp_path: Path) -> None:
+    write_py(tmp_path, "a.py", "import _nope_a\n")
+    write_py(tmp_path, "b.py", "import _nope_b\n")
+    write_py(tmp_path, "c.py", "pass\n")
+
+    result = check_directory(tmp_path)
+
+    assert not result.success
+    assert len(result.errors) == EXPECTED_MULTIPLE_ERRORS
+    assert result.checked == EXPECTED_MULTIPLE_CHECKED
+
+
+# ---------------------------------------------------------------------------
+# cli.main
+# ---------------------------------------------------------------------------
+
+
+def test_cli_success(tmp_path: Path) -> None:
+    write_py(tmp_path, "ok.py", "x = 42\n")
+    code = main([str(tmp_path)])
+    assert code == EXPECTED_CLI_SUCCESS
+
+
+def test_cli_failure(tmp_path: Path) -> None:
+    write_py(tmp_path, "bad.py", "import _nope_cli\n")
+    code = main([str(tmp_path)])
+    assert code == EXPECTED_CLI_FAILURE
+
+
+def test_cli_missing_path(tmp_path: Path) -> None:
+    code = main([str(tmp_path / "does_not_exist")])
+    assert code == EXPECTED_CLI_ERROR
+
+
+def test_cli_src_flag(tmp_path: Path) -> None:
+    src = tmp_path / "src"
+    src.mkdir()
+    (src / "mylib.py").write_text("VALUE = 99\n")
+    write_py(tmp_path, "consumer.py", "from mylib import VALUE\n")
+
+    code = main([str(tmp_path), "--src", str(src)])
+    assert code == EXPECTED_CLI_SUCCESS