rocci 0.1.0__tar.gz

rocci-0.1.0/Cargo.lock

@@ -0,0 +1,280 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "crossbeam-deque"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9dd111b7b7f7d55b72c0a6ae361660ee5853c9af73f70c3c2ef6858b950e2e51"
+dependencies = [
+ "crossbeam-epoch",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-epoch"
+version = "0.9.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5b82ac4a3c2ca9c3460964f020e1402edd5753411d7737aa39c3714ad1b5420e"
+dependencies = [
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-utils"
+version = "0.8.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28"
+
+[[package]]
+name = "either"
+version = "1.16.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91622ff5e7162018101f2fea40d6ebf4a78bbe5a49736a2020649edf9693679e"
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "matrixmultiply"
+version = "0.3.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a06de3016e9fae57a36fd14dba131fccf49f74b40b7fbdb472f96e361ec71a08"
+dependencies = [
+ "autocfg",
+ "rawpointer",
+]
+
+[[package]]
+name = "ndarray"
+version = "0.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "882ed72dce9365842bf196bdeedf5055305f11fc8c03dee7bb0194a6cad34841"
+dependencies = [
+ "matrixmultiply",
+ "num-complex",
+ "num-integer",
+ "num-traits",
+ "portable-atomic",
+ "portable-atomic-util",
+ "rawpointer",
+]
+
+[[package]]
+name = "num-complex"
+version = "0.4.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "73f88a1307638156682bada9d7604135552957b7818057dcef22705b4d509495"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-integer"
+version = "0.1.46"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7969661fd2958a5cb096e56c8e1ad0444ac2bbcd0061bd28660485a44879858f"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "numpy"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6a5b15d63a5ff39e378daed0e1340d3a5964703ea9712eb09a0dc66fade996f4"
+dependencies = [
+ "libc",
+ "ndarray",
+ "num-complex",
+ "num-integer",
+ "num-traits",
+ "pyo3",
+ "pyo3-build-config",
+ "rustc-hash",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "portable-atomic-util"
+version = "0.2.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2a106d1259c23fac8e543272398ae0e3c0b8d33c88ed73d0cc71b0f1d902618"
+dependencies = [
+ "portable-atomic",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cd274650b21d4bfc26a0a47587962c1edb425f69287324355cd040c3ea66071c"
+dependencies = [
+ "libc",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c5e2a7d2f0d013342f295c048ad19237add5154a55b1c5a254c0ec93d4109078"
+dependencies = [
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ca85c467da1bbc8d866eea5deff9cf29ea5f7785054a17da36e65bda9c05845b"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ac53762fd065daa3194dd09337a38bd793a188100fd1a9304c4ab312d901771"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4ca3a1557399783172dc5bf39cfca835157732532cba56b71d2292161e53b362"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.46"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dfbc457d0c7a0759a614551b11a6409e5951f6c7537be1f1b7682b9ae9230368"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rawpointer"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60a357793950651c4ed0f3f52338f53b2f809f32d83a07f72909fa13e4c6c1e3"
+
+[[package]]
+name = "rayon"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fb39b166781f92d482534ef4b4b1b2568f42613b53e5b6c160e24cfbfa30926d"
+dependencies = [
+ "either",
+ "rayon-core",
+]
+
+[[package]]
+name = "rayon-core"
+version = "1.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "22e18b0f0062d30d4230b2e85ff77fdfe4326feb054b9783a3460d8435c8ab91"
+dependencies = [
+ "crossbeam-deque",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "rocci-core"
+version = "0.0.0"
+dependencies = [
+ "numpy",
+ "pyo3",
+ "rayon",
+]
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
+
+[[package]]
+name = "syn"
+version = "2.0.118"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1b9ae57f904213ebb649ce6895b8a66c66f0203b9319718f69a5612a065b1422"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.13.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"

rocci-0.1.0/Cargo.toml

@@ -0,0 +1,7 @@
+[workspace]
+members = ["rust"]
+resolver = "2"
+
+[profile.release]
+lto = "thin"
+codegen-units = 1

rocci-0.1.0/LICENSE

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

rocci-0.1.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: rocci
+Version: 0.1.0
+Classifier: Development Status :: 3 - Alpha
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Typing :: Typed
+Requires-Dist: numpy>=1.24
+Requires-Dist: scipy>=1.10
+Requires-Dist: matplotlib>=3.7 ; extra == 'plot'
+Provides-Extra: plot
+License-File: LICENSE
+Summary: Distribution-free simultaneous confidence bands for ROC curves
+Keywords: roc,confidence-band,bootstrap,auc,classification
+Author-email: "N. Delaney-Busch" <ndelaneybusch@gmail.com>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Changelog, https://github.com/ndelaneybusch/rocci/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://ndelaneybusch.github.io/rocci
+Project-URL: Homepage, https://github.com/ndelaneybusch/rocci
+Project-URL: Repository, https://github.com/ndelaneybusch/rocci
+
+# rocci
+
+[![PyPI](https://img.shields.io/pypi/v/rocci)](https://pypi.org/project/rocci/)
+[![Python versions](https://img.shields.io/pypi/pyversions/rocci)](https://pypi.org/project/rocci/)
+[![conda-forge](https://img.shields.io/conda/vn/conda-forge/rocci)](https://anaconda.org/conda-forge/rocci)
+[![CI](https://github.com/ndelaneybusch/rocci/actions/workflows/ci.yml/badge.svg)](https://github.com/ndelaneybusch/rocci/actions/workflows/ci.yml)
+[![Merge gates](https://github.com/ndelaneybusch/rocci/actions/workflows/gates.yml/badge.svg)](https://github.com/ndelaneybusch/rocci/actions/workflows/gates.yml)
+[![coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/ndelaneybusch/c2865a0da1db40e24976b7c721a4ca97/raw/rocci-coverage.json)](https://github.com/ndelaneybusch/rocci/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-latest-blue)](https://ndelaneybusch.github.io/rocci)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/ndelaneybusch/rocci/blob/main/LICENSE)
+
+**Distribution-free simultaneous confidence bands for ROC curves.**
+
+<!-- Absolute URL so the figure renders on PyPI as well as GitHub. -->
+![rocci envelope band vs Working-Hotelling band on heavy-tailed scores](https://raw.githubusercontent.com/ndelaneybusch/rocci/main/docs/assets/hero.png)
+
+`rocci` is a simple interface to easily add uncertainty estimates to your ROC
+curve that are very likely to be correct in nearly all use cases. It draws a
+simultaneous confidence band, which maintains the specified confidence of
+capturing the _entire_ true (population) ROC.
+
+`rocci` is designed to:
+- __just work__. It should do the right thing off the shelf for nearly any data
+  set.
+- __drop in to your workflow__. It natively integrates with sklearn, torch,
+  statsmodels, PyMC/arviz, and pandas/polars data.
+- __be fast__. Core operations are implemented in rust for speed (invisible to
+  the user).
+- __have a lightweight footprint__. Minimal runtime dependencies (just numpy and
+  scipy).
+- __support an open ecosystem__. Permissive MIT license, easy extensibility.
+
+By default, `rocci` uses a distribution-free method that provides informative
+bands without burdensome assumptions about the data. It maintains nominal
+coverage in a huge variety of contexts and the rare violations tend to be small
+misses. If you are comfortable adding a normality assumption to get tighter
+bands, `rocci` yields a "Working-Hotelling" band, but also carefully checks the
+normality assumption and warns you when it looks dicey.
+
+## Installation
+
+```bash
+pip install rocci            # prebuilt wheels — no Rust toolchain needed
+pip install 'rocci[plot]'    # + matplotlib for band.plot() and diagnostics
+uv add rocci                 # in uv-managed projects
+```
+
+Wheels cover Linux (glibc x86-64/aarch64 and musl), macOS (Intel and Apple
+silicon), and Windows, for every Python ≥ 3.10; runtime dependencies are
+numpy and scipy only. On any other platform `pip` falls back to the sdist
+(requires a [Rust toolchain](https://rustup.rs)), and if no compiled kernel
+is present at runtime a pure-NumPy backend with identical statistical
+semantics takes over automatically. A conda-forge package
+(`conda install -c conda-forge rocci`) follows the first PyPI release.
+Details: [installation guide](https://ndelaneybusch.github.io/rocci/getting-started/installation/).
+
+## Quickstart
+
+```python
+from rocci import roc_band
+
+band = roc_band(y_true, y_score)
+band.plot()
+print(band.summary())
+```
+
+Docs: <https://ndelaneybusch.github.io/rocci> ·
+Changelog: [CHANGELOG.md](CHANGELOG.md) ·
+Contributing (including the release process):
+[CONTRIBUTING.md](CONTRIBUTING.md)
+

rocci-0.1.0/README.md

@@ -0,0 +1,70 @@
+# rocci
+
+[![PyPI](https://img.shields.io/pypi/v/rocci)](https://pypi.org/project/rocci/)
+[![Python versions](https://img.shields.io/pypi/pyversions/rocci)](https://pypi.org/project/rocci/)
+[![conda-forge](https://img.shields.io/conda/vn/conda-forge/rocci)](https://anaconda.org/conda-forge/rocci)
+[![CI](https://github.com/ndelaneybusch/rocci/actions/workflows/ci.yml/badge.svg)](https://github.com/ndelaneybusch/rocci/actions/workflows/ci.yml)
+[![Merge gates](https://github.com/ndelaneybusch/rocci/actions/workflows/gates.yml/badge.svg)](https://github.com/ndelaneybusch/rocci/actions/workflows/gates.yml)
+[![coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/ndelaneybusch/c2865a0da1db40e24976b7c721a4ca97/raw/rocci-coverage.json)](https://github.com/ndelaneybusch/rocci/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-latest-blue)](https://ndelaneybusch.github.io/rocci)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/ndelaneybusch/rocci/blob/main/LICENSE)
+
+**Distribution-free simultaneous confidence bands for ROC curves.**
+
+<!-- Absolute URL so the figure renders on PyPI as well as GitHub. -->
+![rocci envelope band vs Working-Hotelling band on heavy-tailed scores](https://raw.githubusercontent.com/ndelaneybusch/rocci/main/docs/assets/hero.png)
+
+`rocci` is a simple interface to easily add uncertainty estimates to your ROC
+curve that are very likely to be correct in nearly all use cases. It draws a
+simultaneous confidence band, which maintains the specified confidence of
+capturing the _entire_ true (population) ROC.
+
+`rocci` is designed to:
+- __just work__. It should do the right thing off the shelf for nearly any data
+  set.
+- __drop in to your workflow__. It natively integrates with sklearn, torch,
+  statsmodels, PyMC/arviz, and pandas/polars data.
+- __be fast__. Core operations are implemented in rust for speed (invisible to
+  the user).
+- __have a lightweight footprint__. Minimal runtime dependencies (just numpy and
+  scipy).
+- __support an open ecosystem__. Permissive MIT license, easy extensibility.
+
+By default, `rocci` uses a distribution-free method that provides informative
+bands without burdensome assumptions about the data. It maintains nominal
+coverage in a huge variety of contexts and the rare violations tend to be small
+misses. If you are comfortable adding a normality assumption to get tighter
+bands, `rocci` yields a "Working-Hotelling" band, but also carefully checks the
+normality assumption and warns you when it looks dicey.
+
+## Installation
+
+```bash
+pip install rocci            # prebuilt wheels — no Rust toolchain needed
+pip install 'rocci[plot]'    # + matplotlib for band.plot() and diagnostics
+uv add rocci                 # in uv-managed projects
+```
+
+Wheels cover Linux (glibc x86-64/aarch64 and musl), macOS (Intel and Apple
+silicon), and Windows, for every Python ≥ 3.10; runtime dependencies are
+numpy and scipy only. On any other platform `pip` falls back to the sdist
+(requires a [Rust toolchain](https://rustup.rs)), and if no compiled kernel
+is present at runtime a pure-NumPy backend with identical statistical
+semantics takes over automatically. A conda-forge package
+(`conda install -c conda-forge rocci`) follows the first PyPI release.
+Details: [installation guide](https://ndelaneybusch.github.io/rocci/getting-started/installation/).
+
+## Quickstart
+
+```python
+from rocci import roc_band
+
+band = roc_band(y_true, y_score)
+band.plot()
+print(band.summary())
+```
+
+Docs: <https://ndelaneybusch.github.io/rocci> ·
+Changelog: [CHANGELOG.md](CHANGELOG.md) ·
+Contributing (including the release process):
+[CONTRIBUTING.md](CONTRIBUTING.md)

rocci-0.1.0/pyproject.toml

@@ -0,0 +1,145 @@
+[build-system]
+requires = ["maturin>=1.7,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "rocci"
+version = "0.1.0"
+description = "Distribution-free simultaneous confidence bands for ROC curves"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "N. Delaney-Busch", email = "ndelaneybusch@gmail.com" }]
+requires-python = ">=3.10"
+dependencies = ["numpy>=1.24", "scipy>=1.10"]
+keywords = ["roc", "confidence-band", "bootstrap", "auc", "classification"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Rust",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/ndelaneybusch/rocci"
+Documentation = "https://ndelaneybusch.github.io/rocci"
+Repository = "https://github.com/ndelaneybusch/rocci"
+Changelog = "https://github.com/ndelaneybusch/rocci/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+plot = ["matplotlib>=3.7"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-cov>=5",
+    "hypothesis>=6",
+    "ruff>=0.8",
+    "ty",
+    "maturin>=1.7,<2.0",
+    "pandas>=2",
+    "matplotlib>=3.7",
+    "pre-commit>=3",
+    "git-cliff>=2.7",
+]
+docs = [
+    "mkdocs-material>=9.5",
+    "mkdocstrings[python]>=0.26",
+    "mkdocs-jupyter>=0.25",
+    "jupytext>=1.16",
+    "ipykernel>=6",
+    "mike>=2.1",
+    "scikit-learn>=1.4",   # vignette 1 (breast-cancer quickstart); docs build only
+]
+
+[tool.maturin]
+python-source = "python"
+module-name = "rocci._core"
+manifest-path = "rust/Cargo.toml"
+features = ["pyo3/extension-module"]
+# maturin's workspace sdist omits the root LICENSE even though it emits
+# `License-File: LICENSE` metadata; PyPI rejects that mismatch at upload.
+include = [{ path = "LICENSE", format = "sdist" }]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra"
+markers = [
+    "slow: long-running statistical suites (excluded from `just test`)",
+]
+
+[tool.coverage.run]
+source = ["python/rocci"]
+
+[tool.coverage.report]
+exclude_also = ["if TYPE_CHECKING:", "raise NotImplementedError"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E", "W",    # pycodestyle
+    "F",         # pyflakes
+    "I",         # isort-style import sorting
+    "B",         # bugbear (likely bugs)
+    "UP",        # pyupgrade (keep idioms current for the 3.10 floor)
+    "D",         # pydocstyle — Google convention
+    "N",         # pep8-naming
+    "NPY",       # numpy-specific rules (legacy RNG ban, deprecated aliases)
+    "C4",        # comprehension hygiene
+    "SIM",       # simplifications
+    "RET",       # return-statement hygiene
+    "ARG",       # unused arguments
+    "PT",        # pytest style
+    "TID252",    # ban relative parent imports
+    "PERF",      # perflint (accidental quadratic patterns)
+    "RUF",       # ruff-native rules (incl. mutable-default, unused-noqa)
+]
+ignore = [
+    "D105",      # magic-method docstrings
+    "D107",      # __init__ docstrings (class docstring carries the contract)
+    "E501",      # line length: `ruff format` wraps code; a line left overlong is
+                 # one it cannot split — a trailing `# ty: ignore[...]` / `# noqa`
+                 # pragma — which we allow rather than contort the code around.
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.isort]
+known-first-party = ["rocci"]
+split-on-trailing-comma = false
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D", "ARG"]        # test names are the documentation
+"benchmarks/**" = ["D"]
+"docs/**" = ["D", "E402"]        # vignettes import mid-file for narrative flow
+"scripts/**" = ["D"]
+
+[tool.ruff.format]
+quote-style = "double"
+docstring-code-format = true
+skip-magic-trailing-comma = true
+
+[tool.ty.environment]
+python-version = "3.10"          # check against the floor, not the dev interpreter
+
+[tool.ty.src]
+include = ["python/rocci", "tests"]
+
+[tool.ty.rules]
+# ty's default correctness rules stay at their default (error) severity.
+# Promote the off-by-default/lenient ones that catch real bugs in numeric code:
+possibly-unresolved-reference = "error"
+unused-ignore-comment = "error"   # suppressions must stay honest
+redundant-cast = "warn"
+division-by-zero = "warn"

rocci-0.1.0/python/rocci/__init__.py

@@ -0,0 +1,46 @@
+"""Distribution-free simultaneous confidence bands for ROC curves.
+
+The public surface is small by design: :func:`roc_band` (and its multiclass
+sibling :func:`roc_band_ovr`), the :func:`from_estimator` convenience, the
+:class:`RocBand` result object, and :func:`show_versions` for bug reports.
+The exception and warning taxonomy is re-exported here so users can catch
+:class:`RocciError` or filter :class:`RocciWarning` (and its subclasses)
+without touching private modules. Everything else is private (``rocci._*``)
+or documented as internal.
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from rocci._api import from_estimator, roc_band, roc_band_ovr, show_versions
+from rocci._exceptions import RocciError
+from rocci._result import NormalityReport, RocBand
+from rocci._warnings import (
+    FallbackBackendWarning,
+    LowConfidenceWarning,
+    NormalityWarning,
+    RocciWarning,
+    SmallSampleWarning,
+    TiesWarning,
+)
+
+try:
+    __version__ = version("rocci")
+except PackageNotFoundError:  # pragma: no cover — source tree without install
+    __version__ = "0+unknown"
+
+__all__ = [
+    "FallbackBackendWarning",
+    "LowConfidenceWarning",
+    "NormalityReport",
+    "NormalityWarning",
+    "RocBand",
+    "RocciError",
+    "RocciWarning",
+    "SmallSampleWarning",
+    "TiesWarning",
+    "__version__",
+    "from_estimator",
+    "roc_band",
+    "roc_band_ovr",
+    "show_versions",
+]