drift-or-shift 0.1.0a1__tar.gz

drift_or_shift-0.1.0a1/LICENSE

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

drift_or_shift-0.1.0a1/PKG-INFO

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: drift-or-shift
+Version: 0.1.0a1
+Summary: Label shift vs. concept drift: Bayes-optimal offset correction, calibration, and drift diagnostics.
+Author-email: Diogo Ribeiro <hansolo.dj@gmail.com>
+Maintainer-email: Diogo Ribeiro <hansolo.dj@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/DiogoRibeiro7/drift-or-shift
+Project-URL: Repository, https://github.com/DiogoRibeiro7/drift-or-shift
+Project-URL: Issues, https://github.com/DiogoRibeiro7/drift-or-shift/issues
+Project-URL: Changelog, https://github.com/DiogoRibeiro7/drift-or-shift/blob/main/CHANGELOG.md
+Keywords: label-shift,concept-drift,prior-shift,calibration,machine-learning,reproducible-research
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.23
+Requires-Dist: scikit-learn>=1.2
+Requires-Dist: pandas>=1.5
+Requires-Dist: matplotlib>=3.6
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: black==26.5.1; extra == "dev"
+Requires-Dist: build==1.6.1; extra == "dev"
+Requires-Dist: mypy==2.3.1; extra == "dev"
+Requires-Dist: pandas-stubs==2.3.3.260113; extra == "dev"
+Requires-Dist: pre-commit==4.6.2; extra == "dev"
+Requires-Dist: pytest==9.1.1; extra == "dev"
+Requires-Dist: pytest-cov==7.1.0; extra == "dev"
+Requires-Dist: ruff==0.16.8; extra == "dev"
+Requires-Dist: tomli==2.4.1; python_version < "3.11" and extra == "dev"
+Requires-Dist: types-PyYAML==6.0.12.20260906; extra == "dev"
+Dynamic: license-file
+
+# drift-or-shift
+
+[![CI](https://github.com/DiogoRibeiro7/drift-or-shift/actions/workflows/ci.yml/badge.svg)](https://github.com/DiogoRibeiro7/drift-or-shift/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000)](https://github.com/psf/black)
+[![Checked with mypy](https://img.shields.io/badge/mypy-checked-2a6db2)](https://mypy-lang.org/)
+
+A reproducible research pipeline for distinguishing **label shift** from **concept
+drift**, and for showing exactly when a training-free logit offset is sufficient —
+and when it is not.
+
+The experiments reproduce and extend the analysis in
+[SSRN 6052514](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=6052514): start from synthetic two-class Gaussian
+data, apply the Bayes-optimal offset correction without retraining, then observe
+which metrics are invariant (ROC AUC) and which are not (PR-AUC, effective sample
+size). When the class-conditionals themselves move, the offset provably cannot
+recover the new posterior, and retraining becomes necessary.
+
+---
+
+## Installation
+
+```bash
+# From source, for development
+git clone https://github.com/DiogoRibeiro7/drift-or-shift.git
+cd drift-or-shift
+make install          # editable install + dev extras + pre-commit hooks
+```
+
+Without `make`:
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pre_commit install
+```
+
+Runtime install only:
+
+```bash
+python -m pip install .
+```
+
+Requires Python 3.10+. This installs the `drift_or_shift` package, the
+`drift_shift_pipeline` compatibility alias, the `caliblab` calibration
+benchmarking helpers, and the eleven `dos-expN` console scripts.
+
+## Quickstart
+
+```bash
+# Fast end-to-end sanity check (seconds)
+python scripts/smoke_exp1.py --results-dir results/smoke
+
+# A full experiment
+dos-exp1 --pi-train 0.2 --pi-tests 0.05 0.2 0.5 --results-dir results
+
+# Aggregate every run into a reviewable dashboard
+python scripts/aggregate_results.py --results-dir results \
+    --output reports/dashboard.md --figure reports/best_risk.png
+```
+
+Each run writes `tables/`, `figures/`, and a `_summary.json` into
+`results/<experiment>/<utc-timestamp>/`.
+
+## Core concepts
+
+### Label shift vs. concept drift
+
+| | Label shift | Concept drift |
+| --- | --- | --- |
+| What moves | Class prior `π` only | The class-conditionals `p(x\|y)` |
+| Posterior recoverable without retraining? | **Yes** — additive logit offset | **No** |
+| Demonstrated by | Exp 1, 2, 5, 8–11 | Exp 4, 7 |
+
+### Offset correction
+
+Logits are log-odds, so shifting the prior from `π_train` to `π_test` is a
+constant additive term:
+
+```
+offset = log( π_test · (1 − π_train) / (π_train · (1 − π_test)) )
+```
+
+Apply the offset **before** comparing against the cost-derived threshold
+`log(c10 / c01)`; with default costs (`c10 = c01 = 1`) that threshold is zero.
+Because a constant offset preserves the ranking of scores, ROC AUC is invariant
+under label shift — while PR-AUC, which depends on prevalence, is not.
+
+## Experiments
+
+| Command | What it demonstrates |
+| --- | --- |
+| `dos-exp1` | Synthetic label shift: offset correction vs. oracle risk |
+| `dos-exp2` | ROC AUC invariance and PR-AUC prevalence dependence |
+| `dos-exp3` | ESS fraction shrinking as class weight α grows |
+| `dos-exp4` | Concept drift: standard vs. offset vs. retrained |
+| `dos-exp5` | Breast cancer label shift replication with resampling |
+| `dos-exp6` | Calibration (temperature, isotonic) vs. offset under label shift |
+| `dos-exp7` | Drift-type sweep: covariance, feature, and label shift |
+| `dos-exp8` | Multimodal label shift with mixture components |
+| `dos-exp9` | Covertype: real, high-dimensional label shift |
+| `dos-exp10` | Credit-card fraud benchmark with reweighted prevalences |
+| `dos-exp11` | High-variance medical-style benchmark with nonlinear test shifts |
+
+Sources live in [src/drift_or_shift/experiments/](src/drift_or_shift/experiments/).
+Every script accepts `--help`.
+
+## Reproducibility
+
+- All generators take an explicit `seed`; summaries record seeds, sizes, costs,
+  and prevalence grids.
+- Run-directory names and summary timestamps are **UTC** and timezone-aware.
+- `ExperimentConfig` in `drift_or_shift.experiments._common` (or the CLI flags)
+  pins a run's configuration.
+- `reproduce/` holds a separate calibration-benchmark replication driven by
+  [reproduce/config/default.yaml](reproduce/config/default.yaml).
+
+## Tooling utilities
+
+- `drift_or_shift.drift_variants` — inject covariance/feature shifts, label
+  noise, and density-ratio scoring without rebuilding the generators.
+- `scripts/aggregate_results.py` — collect every `results/*/*_summary.json` into
+  a markdown dashboard; `--fail-on-alerts` exits non-zero when drift is detected.
+- `scripts/drift_alerts.py` — flag `feature_max_*` statistics above threshold
+  into `reports/drift_alerts.csv`.
+- `scripts/watch_results.py` — poll `results/` and refresh alerts + dashboard as
+  new summaries land (`--once` for a single pass).
+
+See [docs/CLI_USAGE.md](docs/CLI_USAGE.md) for full flag documentation.
+
+## Development
+
+```bash
+make check      # ruff + black + mypy + pytest, exactly what CI runs
+make test-cov   # tests with an HTML coverage report
+make build      # sdist + wheel, validated with twine
+make help       # all targets
+```
+
+CI runs the suite on Python 3.10–3.13 on Linux, plus Windows and macOS spot
+checks, and verifies that the built wheel installs and runs in a clean
+environment.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for branching and PR conventions, and
+[CHANGELOG.md](CHANGELOG.md) for release history.
+
+## Project documents
+
+| File | Contents |
+| --- | --- |
+| [RESULTS_DIGEST.md](RESULTS_DIGEST.md) | Latest metrics and artifact paths |
+| [REPORT.md](REPORT.md) | Reproduction steps and what each figure claims |
+| [notes/lessons.md](notes/lessons.md) | Counter-intuitive findings worth revisiting |
+| [ROADMAP.md](ROADMAP.md) | Milestones |
+| [FUTURE.md](FUTURE.md) | Candidate extensions |
+| [RELEASE.md](RELEASE.md) | Release checklist |
+
+## Citation
+
+If this code supports academic work, please cite the underlying paper
+([SSRN 6052514](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=6052514)) and reference this repository:
+
+```bibtex
+@software{ribeiro_drift_shift_pipeline,
+  author  = {Ribeiro, Diogo},
+  title   = {drift-or-shift: label shift, offset correction and drift diagnostics},
+  url     = {https://github.com/DiogoRibeiro7/drift-or-shift},
+  version = {0.1.0}
+}
+```
+
+## License
+
+Released under the [MIT License](LICENSE).

drift_or_shift-0.1.0a1/README.md

@@ -0,0 +1,174 @@
+# drift-or-shift
+
+[![CI](https://github.com/DiogoRibeiro7/drift-or-shift/actions/workflows/ci.yml/badge.svg)](https://github.com/DiogoRibeiro7/drift-or-shift/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000)](https://github.com/psf/black)
+[![Checked with mypy](https://img.shields.io/badge/mypy-checked-2a6db2)](https://mypy-lang.org/)
+
+A reproducible research pipeline for distinguishing **label shift** from **concept
+drift**, and for showing exactly when a training-free logit offset is sufficient —
+and when it is not.
+
+The experiments reproduce and extend the analysis in
+[SSRN 6052514](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=6052514): start from synthetic two-class Gaussian
+data, apply the Bayes-optimal offset correction without retraining, then observe
+which metrics are invariant (ROC AUC) and which are not (PR-AUC, effective sample
+size). When the class-conditionals themselves move, the offset provably cannot
+recover the new posterior, and retraining becomes necessary.
+
+---
+
+## Installation
+
+```bash
+# From source, for development
+git clone https://github.com/DiogoRibeiro7/drift-or-shift.git
+cd drift-or-shift
+make install          # editable install + dev extras + pre-commit hooks
+```
+
+Without `make`:
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pre_commit install
+```
+
+Runtime install only:
+
+```bash
+python -m pip install .
+```
+
+Requires Python 3.10+. This installs the `drift_or_shift` package, the
+`drift_shift_pipeline` compatibility alias, the `caliblab` calibration
+benchmarking helpers, and the eleven `dos-expN` console scripts.
+
+## Quickstart
+
+```bash
+# Fast end-to-end sanity check (seconds)
+python scripts/smoke_exp1.py --results-dir results/smoke
+
+# A full experiment
+dos-exp1 --pi-train 0.2 --pi-tests 0.05 0.2 0.5 --results-dir results
+
+# Aggregate every run into a reviewable dashboard
+python scripts/aggregate_results.py --results-dir results \
+    --output reports/dashboard.md --figure reports/best_risk.png
+```
+
+Each run writes `tables/`, `figures/`, and a `_summary.json` into
+`results/<experiment>/<utc-timestamp>/`.
+
+## Core concepts
+
+### Label shift vs. concept drift
+
+| | Label shift | Concept drift |
+| --- | --- | --- |
+| What moves | Class prior `π` only | The class-conditionals `p(x\|y)` |
+| Posterior recoverable without retraining? | **Yes** — additive logit offset | **No** |
+| Demonstrated by | Exp 1, 2, 5, 8–11 | Exp 4, 7 |
+
+### Offset correction
+
+Logits are log-odds, so shifting the prior from `π_train` to `π_test` is a
+constant additive term:
+
+```
+offset = log( π_test · (1 − π_train) / (π_train · (1 − π_test)) )
+```
+
+Apply the offset **before** comparing against the cost-derived threshold
+`log(c10 / c01)`; with default costs (`c10 = c01 = 1`) that threshold is zero.
+Because a constant offset preserves the ranking of scores, ROC AUC is invariant
+under label shift — while PR-AUC, which depends on prevalence, is not.
+
+## Experiments
+
+| Command | What it demonstrates |
+| --- | --- |
+| `dos-exp1` | Synthetic label shift: offset correction vs. oracle risk |
+| `dos-exp2` | ROC AUC invariance and PR-AUC prevalence dependence |
+| `dos-exp3` | ESS fraction shrinking as class weight α grows |
+| `dos-exp4` | Concept drift: standard vs. offset vs. retrained |
+| `dos-exp5` | Breast cancer label shift replication with resampling |
+| `dos-exp6` | Calibration (temperature, isotonic) vs. offset under label shift |
+| `dos-exp7` | Drift-type sweep: covariance, feature, and label shift |
+| `dos-exp8` | Multimodal label shift with mixture components |
+| `dos-exp9` | Covertype: real, high-dimensional label shift |
+| `dos-exp10` | Credit-card fraud benchmark with reweighted prevalences |
+| `dos-exp11` | High-variance medical-style benchmark with nonlinear test shifts |
+
+Sources live in [src/drift_or_shift/experiments/](src/drift_or_shift/experiments/).
+Every script accepts `--help`.
+
+## Reproducibility
+
+- All generators take an explicit `seed`; summaries record seeds, sizes, costs,
+  and prevalence grids.
+- Run-directory names and summary timestamps are **UTC** and timezone-aware.
+- `ExperimentConfig` in `drift_or_shift.experiments._common` (or the CLI flags)
+  pins a run's configuration.
+- `reproduce/` holds a separate calibration-benchmark replication driven by
+  [reproduce/config/default.yaml](reproduce/config/default.yaml).
+
+## Tooling utilities
+
+- `drift_or_shift.drift_variants` — inject covariance/feature shifts, label
+  noise, and density-ratio scoring without rebuilding the generators.
+- `scripts/aggregate_results.py` — collect every `results/*/*_summary.json` into
+  a markdown dashboard; `--fail-on-alerts` exits non-zero when drift is detected.
+- `scripts/drift_alerts.py` — flag `feature_max_*` statistics above threshold
+  into `reports/drift_alerts.csv`.
+- `scripts/watch_results.py` — poll `results/` and refresh alerts + dashboard as
+  new summaries land (`--once` for a single pass).
+
+See [docs/CLI_USAGE.md](docs/CLI_USAGE.md) for full flag documentation.
+
+## Development
+
+```bash
+make check      # ruff + black + mypy + pytest, exactly what CI runs
+make test-cov   # tests with an HTML coverage report
+make build      # sdist + wheel, validated with twine
+make help       # all targets
+```
+
+CI runs the suite on Python 3.10–3.13 on Linux, plus Windows and macOS spot
+checks, and verifies that the built wheel installs and runs in a clean
+environment.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for branching and PR conventions, and
+[CHANGELOG.md](CHANGELOG.md) for release history.
+
+## Project documents
+
+| File | Contents |
+| --- | --- |
+| [RESULTS_DIGEST.md](RESULTS_DIGEST.md) | Latest metrics and artifact paths |
+| [REPORT.md](REPORT.md) | Reproduction steps and what each figure claims |
+| [notes/lessons.md](notes/lessons.md) | Counter-intuitive findings worth revisiting |
+| [ROADMAP.md](ROADMAP.md) | Milestones |
+| [FUTURE.md](FUTURE.md) | Candidate extensions |
+| [RELEASE.md](RELEASE.md) | Release checklist |
+
+## Citation
+
+If this code supports academic work, please cite the underlying paper
+([SSRN 6052514](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=6052514)) and reference this repository:
+
+```bibtex
+@software{ribeiro_drift_shift_pipeline,
+  author  = {Ribeiro, Diogo},
+  title   = {drift-or-shift: label shift, offset correction and drift diagnostics},
+  url     = {https://github.com/DiogoRibeiro7/drift-or-shift},
+  version = {0.1.0}
+}
+```
+
+## License
+
+Released under the [MIT License](LICENSE).

drift_or_shift-0.1.0a1/pyproject.toml

@@ -0,0 +1,192 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "drift-or-shift"
+description = "Label shift vs. concept drift: Bayes-optimal offset correction, calibration, and drift diagnostics."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Diogo Ribeiro", email = "hansolo.dj@gmail.com" }]
+maintainers = [{ name = "Diogo Ribeiro", email = "hansolo.dj@gmail.com" }]
+keywords = [
+    "label-shift",
+    "concept-drift",
+    "prior-shift",
+    "calibration",
+    "machine-learning",
+    "reproducible-research",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Typing :: Typed",
+]
+dynamic = ["version"]
+dependencies = [
+    "numpy>=1.23",
+    "scikit-learn>=1.2",
+    "pandas>=1.5",
+    "matplotlib>=3.6",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+# Dev tooling is pinned exactly: an unpinned `ruff`/`mypy` means a new release
+# can turn CI red without a single line of project code changing.
+dev = [
+    "black==26.5.1",
+    "build==1.6.1",
+    "mypy==2.3.1",
+    # pandas-stubs 3.x requires Python >= 3.11 and this project supports
+    # 3.10, so the dev extra cannot install it. See dependabot.yml.
+    "pandas-stubs==2.3.3.260113",
+    "pre-commit==4.6.2",
+    "pytest==9.1.1",
+    "pytest-cov==7.1.0",
+    "ruff==0.16.8",
+    # tomllib is stdlib from 3.11; 3.10 needs the backport.
+    "tomli==2.4.1; python_version < '3.11'",
+    "types-PyYAML==6.0.12.20260906",
+]
+
+[project.urls]
+Homepage = "https://github.com/DiogoRibeiro7/drift-or-shift"
+Repository = "https://github.com/DiogoRibeiro7/drift-or-shift"
+Issues = "https://github.com/DiogoRibeiro7/drift-or-shift/issues"
+Changelog = "https://github.com/DiogoRibeiro7/drift-or-shift/blob/main/CHANGELOG.md"
+
+[project.scripts]
+dos-exp1 = "drift_or_shift.experiments.exp1_label_shift_synth:main"
+dos-exp2 = "drift_or_shift.experiments.exp2_auc_pr_invariance:main"
+dos-exp3 = "drift_or_shift.experiments.exp3_ess_vs_weight:main"
+dos-exp4 = "drift_or_shift.experiments.exp4_concept_drift:main"
+dos-exp5 = "drift_or_shift.experiments.exp5_realdata_breast_cancer:main"
+dos-exp6 = "drift_or_shift.experiments.exp6_calibration_label_shift:main"
+dos-exp7 = "drift_or_shift.experiments.exp7_drift_types:main"
+dos-exp8 = "drift_or_shift.experiments.exp8_multimodal_label_shift:main"
+dos-exp9 = "drift_or_shift.experiments.exp9_covtype_label_shift:main"
+dos-exp10 = "drift_or_shift.experiments.exp10_credit_card_fraud:main"
+dos-exp11 = "drift_or_shift.experiments.exp11_high_variance_medical:main"
+
+# ---------------------------------------------------------------------------
+# Packaging
+# ---------------------------------------------------------------------------
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"*" = ["py.typed"]
+
+[tool.setuptools.dynamic]
+version = { attr = "drift_or_shift.__version__" }
+
+# ---------------------------------------------------------------------------
+# Lint / format
+# ---------------------------------------------------------------------------
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+src = ["src", "tests", "scripts", "reproduce"]
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "SIM",    # flake8-simplify
+    "RET",    # flake8-return
+    "PTH",    # flake8-use-pathlib
+    "DTZ",    # flake8-datetimez
+    "RUF",    # ruff-specific
+]
+ignore = [
+    "E501",   # line length is enforced by the formatter
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["B018"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["drift_or_shift", "drift_shift_pipeline", "caliblab", "reproduce"]
+
+[tool.black]
+line-length = 88
+target-version = ["py310"]
+
+# ---------------------------------------------------------------------------
+# Types
+# ---------------------------------------------------------------------------
+
+[tool.mypy]
+files = ["src"]
+# NOTE: this is deliberately ahead of `requires-python`. NumPy's bundled stubs
+# use PEP 695 `type` statements, which mypy only parses when python_version is
+# 3.12+, so pinning 3.10 here fails before it checks a single project file.
+# The 3.10 floor is still enforced: ruff runs with target-version = "py310",
+# and CI runs the full test suite on a real 3.10 interpreter.
+python_version = "3.12"
+ignore_missing_imports = true
+warn_unused_configs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+no_implicit_optional = true
+strict_equality = true
+
+# ---------------------------------------------------------------------------
+# Tests / coverage
+# ---------------------------------------------------------------------------
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+# `-m "not network"` keeps the default run offline and fast. Run the
+# dataset-downloading experiments explicitly with `-m network`.
+addopts = "-ra --strict-markers --strict-config -m 'not network'"
+markers = [
+    "network: requires downloading an external dataset",
+    "slow: takes more than a few seconds",
+]
+filterwarnings = [
+    "error::DeprecationWarning:drift_or_shift.*",
+    "error::DeprecationWarning:caliblab.*",
+]
+
+[tool.coverage.run]
+# The scripts are documented entry points, so they are measured too. Leaving
+# them out reported 89% while a fifth of the shipped code was invisible.
+source = ["drift_or_shift", "caliblab", "scripts", "reproduce"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true
+# A floor, not a target. Set below the current figure so ordinary churn does
+# not fail the build, but a real regression does. exp9/exp10 are excluded from
+# the default run (they download datasets), which caps the achievable number.
+fail_under = 85
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+    'if __name__ == "__main__":',
+]

drift_or_shift-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+