framelint 0.1.0__tar.gz

framelint-0.1.0/.gitignore

@@ -0,0 +1,32 @@
+# Byte-compiled / optimized / cache
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+dist/
+*.egg-info/
+*.egg
+wheels/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Test / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# IDE / OS
+.idea/
+.vscode/
+.DS_Store

framelint-0.1.0/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project are documented here. The format is based on
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-06-27
+
+### Added
+- Initial release.
+- Data-quality checks: missingness, duplicate rows, constant/zero-variance
+  columns, cardinality (likely-ID and high-cardinality), type consistency
+  (numbers-as-strings and mixed types), and numeric outliers (IQR / z-score).
+- Opt-in per-column rules: email, date/datetime, numeric range, regex, and
+  allowed-value sets.
+- Schema-drift detection against a saved baseline (added/removed columns, dtype
+  changes, null-rate jumps, and distribution shifts).
+- `Report` with `summary()` (rich console), `to_dict`, `to_json`, `to_html`,
+  and `to_markdown`, plus a `passed` pass/fail decision.
+- Typer-based CLI (`framelint scan`, `framelint baseline save`) with CI-friendly
+  exit codes (0 pass, 1 quality failure, 2 usage error).
+- Configuration via defaults, `pyproject.toml`, standalone TOML, a dict/Config,
+  and CLI flags, with a documented precedence order.
+- Full type hints and a `py.typed` marker.
+
+[Unreleased]: https://github.com/AnoopIbrampur/framelint/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/AnoopIbrampur/framelint/releases/tag/v0.1.0

framelint-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anoop Ibrampur
+
+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.

framelint-0.1.0/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: framelint
+Version: 0.1.0
+Summary: A lightweight data-quality profiler and CI gate for tabular data.
+Project-URL: Homepage, https://github.com/AnoopIbrampur/framelint
+Project-URL: Repository, https://github.com/AnoopIbrampur/framelint
+Project-URL: Issues, https://github.com/AnoopIbrampur/framelint/issues
+Project-URL: Changelog, https://github.com/AnoopIbrampur/framelint/blob/main/CHANGELOG.md
+Author-email: Anoop Ibrampur <anoopibrampur@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: ci,data-engineering,data-profiling,data-quality,data-validation,dataframe,pandas,schema-drift
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: pandas>=1.3
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Requires-Dist: typer>=0.9
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pandas-stubs; extra == 'dev'
+Requires-Dist: pre-commit>=3.0; extra == 'dev'
+Requires-Dist: pyarrow>=10.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: parquet
+Requires-Dist: pyarrow>=10.0; extra == 'parquet'
+Description-Content-Type: text/markdown
+
+# framelint
+
+[![PyPI version](https://img.shields.io/pypi/v/framelint.svg)](https://pypi.org/project/framelint/)
+[![Python versions](https://img.shields.io/pypi/pyversions/framelint.svg)](https://pypi.org/project/framelint/)
+[![CI](https://github.com/AnoopIbrampur/framelint/actions/workflows/ci.yml/badge.svg)](https://github.com/AnoopIbrampur/framelint/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/AnoopIbrampur/framelint/branch/main/graph/badge.svg)](https://codecov.io/gh/AnoopIbrampur/framelint)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Typed](https://img.shields.io/badge/typed-yes-brightgreen.svg)](https://peps.python.org/pep-0561/)
+
+**A lightweight data-quality profiler and CI gate for tabular data.**
+
+`framelint` scans a pandas DataFrame or a CSV/Parquet file and produces a clear
+data-quality report — nulls, duplicates, constant columns, likely-ID columns,
+type inconsistencies, numeric outliers, format violations, and schema drift.
+
+Its standout feature: it doubles as a **CI gate**. Point it at your data, set
+thresholds, and it exits non-zero when quality drops — so a bad dataset fails
+the build instead of silently flowing downstream.
+
+---
+
+## Why this exists
+
+Data pipelines break quietly. A column starts arriving 40% null, an upstream job
+starts writing numbers as strings, a join silently doubles your rows — and
+nobody notices until a dashboard looks wrong weeks later. `framelint` turns
+those failures into loud, early, automated signals you can drop into CI in one
+line.
+
+## Install
+
+```bash
+pip install framelint
+# Parquet support:
+pip install "framelint[parquet]"
+```
+
+Requires Python 3.9+.
+
+## 30-second quickstart
+
+```python
+import framelint
+
+report = framelint.scan("sales.csv")   # or pass a DataFrame
+report.summary()                        # pretty console table
+print(report.passed)                    # -> True / False
+
+report.to_json("report.json")           # machine-readable
+report.to_html("report.html")           # shareable report
+```
+
+Example console output:
+
+```
+framelint  FAILED  rows=1000 cols=6  errors=1 warnings=3 info=1
+┏━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ Severity ┃ Check            ┃ Column  ┃ Message                               ┃
+┡━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
+│ error    │ missingness      │ region  │ Column 'region' is 62.0% null.        │
+│ warning  │ duplicates       │ —       │ Found 12 duplicate rows (full-row).   │
+│ warning  │ type_consistency │ price   │ Column 'price' holds numbers as ...   │
+│ warning  │ outliers         │ amount  │ Column 'amount' has 18 outliers ...   │
+│ info     │ cardinality      │ id      │ Column 'id' looks like an identifier. │
+└──────────┴──────────────────┴─────────┴───────────────────────────────────────┘
+```
+
+## Features
+
+- **Missingness** — per-column null counts and rates, with severity thresholds.
+- **Duplicate rows** — full-row or by a subset of key columns.
+- **Constant / zero-variance** and all-null columns.
+- **Cardinality** — likely-identifier and high-cardinality column detection.
+- **Type consistency** — numbers stored as strings, mixed-type columns.
+- **Outliers** — numeric outliers via IQR or z-score (configurable).
+- **Format validation** (opt-in) — email, date/datetime, numeric ranges,
+  regex, and allowed-value sets, per column.
+- **Schema drift** — save a baseline, then detect added/removed columns, dtype
+  changes, null-rate jumps, and distribution shifts.
+- **Severity levels** — every finding is `info`, `warning`, or `error`.
+- **Pass/fail decision** — based on configurable thresholds, for use in CI.
+- **Outputs** — rich console, `dict`, JSON, HTML, and Markdown.
+
+## CLI
+
+```bash
+# Scan and write reports
+framelint scan sales.csv --html report.html --json report.json
+
+# Fail the build if any error-level finding is present
+framelint scan sales.csv --fail-on error
+
+# Save a baseline, then scan a new file for drift
+framelint baseline save sales.csv baseline.json
+framelint scan new.csv --baseline baseline.json
+```
+
+Exit codes: **0** = passed, **1** = quality failure, **2** = usage error.
+
+### Use it in CI to gate data quality
+
+```yaml
+# .github/workflows/data-quality.yml
+name: data-quality
+on: [push, pull_request]
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install framelint
+      - run: framelint scan data/sales.csv --fail-on error --baseline data/baseline.json
+```
+
+If quality drops below your thresholds, the step exits non-zero and the build
+fails — no extra glue code required.
+
+## Configuration
+
+Thresholds and per-column rules can be set, in increasing order of precedence:
+
+1. Built-in defaults
+2. `[tool.framelint]` in `pyproject.toml`
+3. A standalone TOML file (`--config rules.toml`)
+4. A `dict` / `Config` passed to `scan(...)`
+5. Individual CLI flags (e.g. `--fail-on`, `--outlier-method`)
+
+```toml
+# pyproject.toml  (or a standalone --config file, same schema)
+[tool.framelint]
+null_rate_warning = 0.10
+null_rate_error = 0.50
+duplicate_rate_error = 0.05
+outlier_method = "iqr"      # or "zscore"
+fail_on = "error"
+
+[tool.framelint.columns.email]
+type = "email"
+
+[tool.framelint.columns.age]
+min = 0
+max = 120
+```
+
+| Key | Default | Meaning |
+| --- | --- | --- |
+| `null_rate_warning` / `null_rate_error` | 0.10 / 0.50 | Null-rate thresholds |
+| `duplicate_rate_warning` / `duplicate_rate_error` | 0.0 / 0.10 | Duplicate-row thresholds |
+| `duplicate_subset` | `null` | Key columns for duplicate detection |
+| `id_cardinality_ratio` | 0.95 | Unique-ratio to flag a likely ID |
+| `high_cardinality_ratio` | 0.50 | Unique-ratio to flag high cardinality |
+| `outlier_method` | `"iqr"` | `iqr` or `zscore` |
+| `iqr_factor` / `zscore_threshold` | 1.5 / 3.0 | Outlier sensitivity |
+| `outlier_rate_warning` / `outlier_rate_error` | 0.01 / 0.10 | Outlier-rate thresholds |
+| `drift_mean_shift` | 3.0 | Mean shift (in baseline std) to flag drift |
+| `drift_null_rate_increase` | 0.10 | Null-rate jump to flag drift |
+| `fail_on` | `"error"` | Severity at/above which `passed` is `False` |
+
+Per-column rules (`[tool.framelint.columns.<name>]`): `type` (`email`/`date`/
+`datetime`), `min`, `max`, `regex`, `allowed`.
+
+## Programmatic API
+
+```python
+import framelint
+
+# Baseline + drift
+framelint.save_baseline("sales.csv", "baseline.json")
+report = framelint.scan("new.csv", baseline="baseline.json")
+
+# Inline configuration
+report = framelint.scan(df, config={"fail_on": "warning", "outlier_method": "zscore"})
+
+report.to_dict()        # full machine-readable result
+report.to_markdown()    # Markdown string
+report.counts_by_severity()
+```
+
+## Contributing
+
+Contributions are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) and the
+[Code of Conduct](CODE_OF_CONDUCT.md). In short:
+
+```bash
+pip install -e ".[dev]"
+ruff check . && ruff format --check .
+mypy
+pytest
+```
+
+## License
+
+[MIT](LICENSE) © Anoop Ibrampur

framelint-0.1.0/README.md

@@ -0,0 +1,195 @@
+# framelint
+
+[![PyPI version](https://img.shields.io/pypi/v/framelint.svg)](https://pypi.org/project/framelint/)
+[![Python versions](https://img.shields.io/pypi/pyversions/framelint.svg)](https://pypi.org/project/framelint/)
+[![CI](https://github.com/AnoopIbrampur/framelint/actions/workflows/ci.yml/badge.svg)](https://github.com/AnoopIbrampur/framelint/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/AnoopIbrampur/framelint/branch/main/graph/badge.svg)](https://codecov.io/gh/AnoopIbrampur/framelint)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Typed](https://img.shields.io/badge/typed-yes-brightgreen.svg)](https://peps.python.org/pep-0561/)
+
+**A lightweight data-quality profiler and CI gate for tabular data.**
+
+`framelint` scans a pandas DataFrame or a CSV/Parquet file and produces a clear
+data-quality report — nulls, duplicates, constant columns, likely-ID columns,
+type inconsistencies, numeric outliers, format violations, and schema drift.
+
+Its standout feature: it doubles as a **CI gate**. Point it at your data, set
+thresholds, and it exits non-zero when quality drops — so a bad dataset fails
+the build instead of silently flowing downstream.
+
+---
+
+## Why this exists
+
+Data pipelines break quietly. A column starts arriving 40% null, an upstream job
+starts writing numbers as strings, a join silently doubles your rows — and
+nobody notices until a dashboard looks wrong weeks later. `framelint` turns
+those failures into loud, early, automated signals you can drop into CI in one
+line.
+
+## Install
+
+```bash
+pip install framelint
+# Parquet support:
+pip install "framelint[parquet]"
+```
+
+Requires Python 3.9+.
+
+## 30-second quickstart
+
+```python
+import framelint
+
+report = framelint.scan("sales.csv")   # or pass a DataFrame
+report.summary()                        # pretty console table
+print(report.passed)                    # -> True / False
+
+report.to_json("report.json")           # machine-readable
+report.to_html("report.html")           # shareable report
+```
+
+Example console output:
+
+```
+framelint  FAILED  rows=1000 cols=6  errors=1 warnings=3 info=1
+┏━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ Severity ┃ Check            ┃ Column  ┃ Message                               ┃
+┡━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
+│ error    │ missingness      │ region  │ Column 'region' is 62.0% null.        │
+│ warning  │ duplicates       │ —       │ Found 12 duplicate rows (full-row).   │
+│ warning  │ type_consistency │ price   │ Column 'price' holds numbers as ...   │
+│ warning  │ outliers         │ amount  │ Column 'amount' has 18 outliers ...   │
+│ info     │ cardinality      │ id      │ Column 'id' looks like an identifier. │
+└──────────┴──────────────────┴─────────┴───────────────────────────────────────┘
+```
+
+## Features
+
+- **Missingness** — per-column null counts and rates, with severity thresholds.
+- **Duplicate rows** — full-row or by a subset of key columns.
+- **Constant / zero-variance** and all-null columns.
+- **Cardinality** — likely-identifier and high-cardinality column detection.
+- **Type consistency** — numbers stored as strings, mixed-type columns.
+- **Outliers** — numeric outliers via IQR or z-score (configurable).
+- **Format validation** (opt-in) — email, date/datetime, numeric ranges,
+  regex, and allowed-value sets, per column.
+- **Schema drift** — save a baseline, then detect added/removed columns, dtype
+  changes, null-rate jumps, and distribution shifts.
+- **Severity levels** — every finding is `info`, `warning`, or `error`.
+- **Pass/fail decision** — based on configurable thresholds, for use in CI.
+- **Outputs** — rich console, `dict`, JSON, HTML, and Markdown.
+
+## CLI
+
+```bash
+# Scan and write reports
+framelint scan sales.csv --html report.html --json report.json
+
+# Fail the build if any error-level finding is present
+framelint scan sales.csv --fail-on error
+
+# Save a baseline, then scan a new file for drift
+framelint baseline save sales.csv baseline.json
+framelint scan new.csv --baseline baseline.json
+```
+
+Exit codes: **0** = passed, **1** = quality failure, **2** = usage error.
+
+### Use it in CI to gate data quality
+
+```yaml
+# .github/workflows/data-quality.yml
+name: data-quality
+on: [push, pull_request]
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install framelint
+      - run: framelint scan data/sales.csv --fail-on error --baseline data/baseline.json
+```
+
+If quality drops below your thresholds, the step exits non-zero and the build
+fails — no extra glue code required.
+
+## Configuration
+
+Thresholds and per-column rules can be set, in increasing order of precedence:
+
+1. Built-in defaults
+2. `[tool.framelint]` in `pyproject.toml`
+3. A standalone TOML file (`--config rules.toml`)
+4. A `dict` / `Config` passed to `scan(...)`
+5. Individual CLI flags (e.g. `--fail-on`, `--outlier-method`)
+
+```toml
+# pyproject.toml  (or a standalone --config file, same schema)
+[tool.framelint]
+null_rate_warning = 0.10
+null_rate_error = 0.50
+duplicate_rate_error = 0.05
+outlier_method = "iqr"      # or "zscore"
+fail_on = "error"
+
+[tool.framelint.columns.email]
+type = "email"
+
+[tool.framelint.columns.age]
+min = 0
+max = 120
+```
+
+| Key | Default | Meaning |
+| --- | --- | --- |
+| `null_rate_warning` / `null_rate_error` | 0.10 / 0.50 | Null-rate thresholds |
+| `duplicate_rate_warning` / `duplicate_rate_error` | 0.0 / 0.10 | Duplicate-row thresholds |
+| `duplicate_subset` | `null` | Key columns for duplicate detection |
+| `id_cardinality_ratio` | 0.95 | Unique-ratio to flag a likely ID |
+| `high_cardinality_ratio` | 0.50 | Unique-ratio to flag high cardinality |
+| `outlier_method` | `"iqr"` | `iqr` or `zscore` |
+| `iqr_factor` / `zscore_threshold` | 1.5 / 3.0 | Outlier sensitivity |
+| `outlier_rate_warning` / `outlier_rate_error` | 0.01 / 0.10 | Outlier-rate thresholds |
+| `drift_mean_shift` | 3.0 | Mean shift (in baseline std) to flag drift |
+| `drift_null_rate_increase` | 0.10 | Null-rate jump to flag drift |
+| `fail_on` | `"error"` | Severity at/above which `passed` is `False` |
+
+Per-column rules (`[tool.framelint.columns.<name>]`): `type` (`email`/`date`/
+`datetime`), `min`, `max`, `regex`, `allowed`.
+
+## Programmatic API
+
+```python
+import framelint
+
+# Baseline + drift
+framelint.save_baseline("sales.csv", "baseline.json")
+report = framelint.scan("new.csv", baseline="baseline.json")
+
+# Inline configuration
+report = framelint.scan(df, config={"fail_on": "warning", "outlier_method": "zscore"})
+
+report.to_dict()        # full machine-readable result
+report.to_markdown()    # Markdown string
+report.counts_by_severity()
+```
+
+## Contributing
+
+Contributions are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) and the
+[Code of Conduct](CODE_OF_CONDUCT.md). In short:
+
+```bash
+pip install -e ".[dev]"
+ruff check . && ruff format --check .
+mypy
+pytest
+```
+
+## License
+
+[MIT](LICENSE) © Anoop Ibrampur

framelint-0.1.0/pyproject.toml

@@ -0,0 +1,149 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "framelint"
+dynamic = ["version"]
+description = "A lightweight data-quality profiler and CI gate for tabular data."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Anoop Ibrampur", email = "anoopibrampur@gmail.com" }]
+keywords = [
+    "data-quality",
+    "data-validation",
+    "data-profiling",
+    "pandas",
+    "dataframe",
+    "ci",
+    "data-engineering",
+    "schema-drift",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "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",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pandas>=1.3",
+    "rich>=13.0",
+    "typer>=0.9",
+    "tomli>=2.0; python_version < '3.11'",
+]
+
+[project.optional-dependencies]
+parquet = ["pyarrow>=10.0"]
+dev = [
+    "framelint[parquet]",
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "ruff>=0.6",
+    "mypy>=1.8",
+    "pandas-stubs",
+    "build>=1.0",
+    "twine>=5.0",
+    "pre-commit>=3.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/AnoopIbrampur/framelint"
+Repository = "https://github.com/AnoopIbrampur/framelint"
+Issues = "https://github.com/AnoopIbrampur/framelint/issues"
+Changelog = "https://github.com/AnoopIbrampur/framelint/blob/main/CHANGELOG.md"
+
+[project.scripts]
+framelint = "framelint.cli:main"
+
+[tool.hatch.version]
+path = "src/framelint/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/framelint"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/framelint", "tests", "README.md", "LICENSE", "CHANGELOG.md"]
+
+# ---------------------------------------------------------------------------
+# Ruff: linter + formatter
+# ---------------------------------------------------------------------------
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle errors
+    "W",    # pycodestyle warnings
+    "F",    # pyflakes
+    "I",    # isort
+    "N",    # pep8-naming
+    "UP",   # pyupgrade
+    "B",    # flake8-bugbear
+    "C4",   # flake8-comprehensions
+    "SIM",  # flake8-simplify
+    "PTH",  # flake8-use-pathlib
+    "ARG",  # flake8-unused-arguments
+    "RUF",  # ruff-specific
+    "D",    # pydocstyle
+]
+ignore = [
+    "D203",  # one-blank-line-before-class (conflicts with D211)
+    "D213",  # multi-line-summary-second-line (conflicts with D212)
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D", "ARG"]
+"examples/**" = ["D", "ARG"]
+# Typer relies on function-call defaults (typer.Argument/Option) by design, and
+# evaluates annotations at runtime, so `Optional[X]` is required for Python 3.9.
+"src/framelint/cli.py" = ["B008", "UP007", "UP045"]
+
+# ---------------------------------------------------------------------------
+# mypy: strict type checking
+# ---------------------------------------------------------------------------
+[tool.mypy]
+strict = true
+warn_unreachable = true
+files = ["src", "tests"]
+
+[[tool.mypy.overrides]]
+module = ["tests.*"]
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+disallow_untyped_calls = false
+
+# ---------------------------------------------------------------------------
+# pytest + coverage
+# ---------------------------------------------------------------------------
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "-ra --cov=framelint --cov-report=term-missing --cov-report=xml"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+branch = true
+source = ["framelint"]
+
+[tool.coverage.report]
+show_missing = true
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+]