rapiDU 0.1.0__tar.gz

rapidu-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,262 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # Ruff and mypy produce the same verdict on every interpreter, so running them
+  # once is enough; the matrix below is for the code, not the linters.
+  lint:
+    name: Lint & types
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0 # setuptools-scm derives the version from tags
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install package + dev deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - run: ruff check .
+      - run: ruff format --check .
+      - run: mypy src/ tests/
+
+  test:
+    name: Test (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        # The package declares >=3.6 and is verified by hand on the 3.6.8
+        # /usr/bin/python3 of a RHEL8 login node, which is the deployment target
+        # that motivates the stdlib-only constraint. tests/test_py36_compat.py
+        # guards that floor here; these are the versions GitHub still provides.
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install package + dev deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      # TMPDIR stays on the runner's local disk. The suite handles a networked
+      # filesystem -- that is what the settling logic is for -- but the fixture
+      # trees would take tens of seconds to settle for no added coverage.
+      - name: Test with pytest
+        run: python -m pytest --cov=rapidu --cov-report=xml --cov-report=term --cov-fail-under=70
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+
+  # The headline claim, checked rather than asserted: this walker agrees with du
+  # byte-for-byte. It is also in the test suite; here it runs against a tree the
+  # runner built itself, outside pytest, so a broken fixture cannot hide it.
+  agrees-with-du:
+    name: Byte-for-byte agreement with du
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build a tree with the pathologies that break naive walkers
+        run: |
+          mkdir -p tree/a/b/c
+          for i in $(seq 1 40); do head -c 5000 /dev/urandom > "tree/a/f$i"; done
+          for i in $(seq 1 20); do head -c 9000 /dev/urandom > "tree/a/b/g$i"; done
+          head -c 3000 /dev/urandom > tree/a/b/c/payload
+          for i in $(seq 1 5); do ln tree/a/b/c/payload "tree/link$i"; done  # hard links
+          truncate -s 1G tree/sparse.bin                                     # sparse
+          ln -s /etc/hostname tree/dangling.sym
+          sync
+
+      - name: du and rapidu must return the same integer
+        run: |
+          cat > walksize.py <<'PY'
+          import sys
+          from rapidu.walk import walk
+          print(walk(sys.argv[1], threads=int(sys.argv[2])).size)
+          PY
+          # Wait for two consecutive du readings to agree before comparing
+          # anything. A runner's ext4 settles instantly, but this is the exact
+          # trap the package documents, and a comparison of two measurements
+          # taken while the filesystem is still moving would fail for a reason
+          # that has nothing to do with the walker.
+          prev=-1
+          for _ in $(seq 1 20); do
+            cur=$(du -s --block-size=1 tree | cut -f1)
+            [ "$cur" = "$prev" ] && break
+            prev=$cur
+            sleep 3
+          done
+          DU=$(du -s --block-size=1 tree | cut -f1)
+          for t in 1 2 4 8 16; do
+            SD=$(PYTHONPATH=src python3 walksize.py tree "$t")
+            echo "threads=$t  du=$DU  rapidu=$SD"
+            if [ "$DU" != "$SD" ]; then
+              echo "::error::rapidu disagreed with du at $t threads ($SD vs $DU)"
+              exit 1
+            fi
+          done
+
+  # This package exists to be run on a login node during a storage emergency,
+  # where nothing is installed and pip may not be able to write anywhere. If it
+  # needs an install, or a quota backend, or a TTY, that claim is false.
+  zero-install:
+    name: Runs with nothing installed
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: No pip, no venv, no dependencies -- just PYTHONPATH
+        run: |
+          cd /tmp && mkdir -p bare/sub && head -c 100000 /dev/urandom > bare/sub/f
+          PYTHONPATH=$GITHUB_WORKSPACE/src python3 -m rapidu bare
+          PYTHONPATH=$GITHUB_WORKSPACE/src python3 -m rapidu bare --json | python3 -m json.tool > /dev/null
+
+      - name: The package imports nothing outside the standard library
+        run: |
+          python3 - <<'PY'
+          import ast, pathlib, sys
+          stdlib = set(getattr(sys, "stdlib_module_names", ()))
+          assert stdlib, "need Python 3.10+ for stdlib_module_names"
+          bad = []
+          for path in sorted(pathlib.Path("src/rapidu").glob("*.py")):
+              for node in ast.walk(ast.parse(path.read_text())):
+                  if isinstance(node, ast.Import):
+                      names = [a.name.split(".")[0] for a in node.names]
+                  elif isinstance(node, ast.ImportFrom) and node.level == 0:
+                      names = [(node.module or "").split(".")[0]]
+                  else:
+                      continue
+                  bad += [(path.name, n) for n in names if n and n not in stdlib]
+          assert not bad, "non-stdlib imports: {}".format(bad)
+          print("stdlib only, confirmed across", len(list(pathlib.Path('src/rapidu').glob('*.py'))), "modules")
+          PY
+
+      # There is no `quota`, no `mmlsquota` and no `lfs` on a GitHub runner, and
+      # that is the off-site case: every field must go absent WITH A REASON, and
+      # nothing downstream may break. A traceback here is the bug.
+      - name: A missing quota backend degrades to n/a, not to zero and not to a crash
+        run: |
+          pip install -e .
+          set +e
+          out=$(rdu --quota-only 2>&1); code=$?
+          set -e
+          echo "$out"
+          test $code -eq 1 || { echo "::error::expected exit 1 (attention), got $code"; exit 1; }
+          case "$out" in
+            *Traceback*) echo "::error::crashed instead of reporting"; exit 1 ;;
+          esac
+          echo "$out" | grep -q "n/a" || { echo "::error::absent quota did not print n/a"; exit 1; }
+          echo "$out" | grep -qi "not on PATH" || { echo "::error::n/a printed without a reason"; exit 1; }
+
+      - name: Output is clean when redirected -- no escape codes in a support ticket
+        run: |
+          rdu . > plain.txt
+          if grep -qP '\x1b\[' plain.txt; then
+            echo "::error::colour escapes leaked into non-TTY output"; exit 1
+          fi
+          NO_COLOR=1 rdu . --color auto > nocolor.txt
+          if grep -qP '\x1b\[' nocolor.txt; then
+            echo "::error::NO_COLOR was ignored"; exit 1
+          fi
+          # --help is painted after argparse has laid it out, which is a second
+          # place colour can leak from -- and `rdu --help > usage.txt` is exactly
+          # what someone does before pasting it into a ticket.
+          rdu --help > help.txt
+          if grep -qP '\x1b\[' help.txt; then
+            echo "::error::colour escapes leaked into redirected --help"; exit 1
+          fi
+
+      # A -c walk never calls stat, so it has no bytes. Reconciling that against
+      # a live quota once fabricated an UNEXPLAINED GAP the size of the whole
+      # quota -- the exact failure the reconciler exists to prevent.
+      - name: A stat-free walk never manufactures a finding
+        run: |
+          rdu . -c --json > count.json
+          python3 - <<'PY'
+          import json
+          doc = json.load(open("count.json"))
+          for rec in doc.get("reconciliation", []):
+              assert rec["verdict"] != "gap", rec
+          print("no fabricated gaps from a count-only walk")
+          PY
+
+  # An installed wheel is what a user actually gets. A package that imports from
+  # the source tree but not from site-packages is a packaging bug, and the
+  # release workflow is the wrong place to discover it.
+  wheel:
+    name: Built wheel installs and runs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist and wheel
+        run: |
+          pip install build twine
+          python -m build
+          twine check dist/*
+
+      - name: Install the wheel into a clean venv and use it
+        run: |
+          python -m venv /tmp/check
+          /tmp/check/bin/pip install --quiet dist/*.whl
+          /tmp/check/bin/rapidu --version
+          /tmp/check/bin/rdu --version          # the short alias must be there too
+          /tmp/check/bin/rdu /tmp --json | python3 -m json.tool > /dev/null
+          /tmp/check/bin/python -c "import rapidu, pathlib; \
+            assert (pathlib.Path(rapidu.__file__).parent / 'py.typed').is_file(), \
+            'py.typed missing from the wheel'"
+
+      # The stdlib-only promise is a packaging fact, not just a source fact. The
+      # `[dev]` extra legitimately appears here as `; extra == "dev"`, so only
+      # unconditional requirements are a failure -- those are what a plain
+      # `pip install rapidu` would drag onto a login node.
+      - name: The wheel carries no unconditional dependencies
+        run: |
+          python -m zipfile -e dist/*.whl /tmp/unpacked
+          meta=$(find /tmp/unpacked -name METADATA | head -1)
+          runtime=$(grep '^Requires-Dist:' "$meta" | grep -v 'extra ==' || true)
+          if [ -n "$runtime" ]; then
+            echo "::error::the wheel declares runtime dependencies:"
+            echo "$runtime"
+            exit 1
+          fi
+          echo "no unconditional Requires-Dist, as intended"

rapidu-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  build-and-publish:
+    name: Build & Publish to PyPI
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          # setuptools-scm needs full history + tags to derive the version.
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build wheel and sdist
+        run: |
+          pip install build setuptools-scm
+          python -m build
+
+      - name: Verify tag matches built version
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PKG_VERSION=$(python -m setuptools_scm)
+          echo "Tag version: $TAG_VERSION"
+          echo "Package version: $PKG_VERSION"
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "Tag version ($TAG_VERSION) != package version ($PKG_VERSION)"
+            exit 1
+          fi
+          echo "Version match OK"
+
+      - name: Check artifacts with twine
+        run: |
+          pip install twine
+          twine check dist/*
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

rapidu-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+*.egg
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.log
+*.csv
+.DS_Store
+.coverage
+coverage.xml
+
+# Generated by setuptools-scm at build time
+src/rapidu/_version.py
+
+# Local (machine-specific) Claude Code config — not shared
+.claude/settings.local.json
+.claude/hooks/
+
+# Local audit notes: contains real cluster paths, never publish.
+issues.md

rapidu-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Keep in step with the ruff release CI resolves, or the hook's --fix
+    # and CI's check will disagree about import sorting.
+    rev: v0.16.1
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v2.3.0
+    hooks:
+      - id: mypy
+        # rapidu has no runtime dependencies, so mypy needs no extras.
+        additional_dependencies: []

rapidu-0.1.0/LICENSE

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

rapidu-0.1.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.md
+recursive-include tests *
+# The demo GIF alone is 1.9 MB and is 95% of the sdist. Nobody
+# installing the package needs it; it is a README asset.
+prune assets

rapidu-0.1.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: rapiDU
+Version: 0.1.0
+Summary: A much faster du that tells you why your quota is full.
+Author-email: Youzhi Yu <yuyouzhi666@icloud.com>
+License: MIT
+Project-URL: Homepage, https://github.com/PursuitOfDataScience/rapidu
+Project-URL: Repository, https://github.com/PursuitOfDataScience/rapidu.git
+Project-URL: Documentation, https://github.com/PursuitOfDataScience/rapidu#readme
+Project-URL: Issues, https://github.com/PursuitOfDataScience/rapidu/issues
+Keywords: du,disk-usage,quota,inodes,gpfs,lustre,hpc,storage
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: System :: Monitoring
+Classifier: Typing :: Typed
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff<0.17,>=0.15; extra == "dev"
+Requires-Dist: mypy<3,>=1.8; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Requires-Dist: setuptools-scm>=8; extra == "dev"
+Dynamic: license-file
+
+<h1 align="center">rapiDU</h1>
+
+<p align="center">
+  <strong>A much faster <code>du</code> that tells you why your quota is full.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/PursuitOfDataScience/rapidu/actions/workflows/ci.yml"><img src="https://github.com/PursuitOfDataScience/rapidu/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <img src="https://img.shields.io/badge/python-3.6%2B-blue.svg" alt="Python 3.6+">
+  <img src="https://img.shields.io/badge/dependencies-none-brightgreen.svg" alt="No dependencies">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT License">
+</p>
+
+<p align="center">
+  <img src="assets/demo.gif" width="900" alt="rapiDU walking a project tree and explaining that it occupies 266.8 MiB to hold 75.5 MiB of data, ranking the same tree by file count, printing a quota table with the age of its snapshot, finding 512 MiB held by a deleted-but-open file descriptor, and catching a freshly written GPFS tree that loses 224 MiB while it settles.">
+</p>
+
+## Install
+
+```bash
+pip install rapidu
+```
+
+## Use
+
+```bash
+rdu                      # this directory: how big, and what is big inside it
+rdu /project/mylab       # any other path
+rdu ~/scratch -n 20      # list 20 entries instead of 10
+
+rdu -i                   # rank by file count -- what an inode quota limits
+rdu -c                   # count files only, no stat: ~8x again on GPFS
+rdu -Q                   # the quota table, and the age of its figures
+rdu -D                   # space held by files deleted while still open
+rdu -a                   # the full audit: quota + /proc scan + reconciliation
+```
+
+## Faster, and the same number
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/benchmark-dark.png">
+    <img src="assets/benchmark-light.png" width="720" alt="Cold GPFS walk: du takes 168.1s against rapiDU's 25.4s on a 792,225-file package cache (6.6x), and 298.5s against 57.4s on a 1,686,589-file project directory (5.2x).">
+  </picture>
+</p>
+
+Same total as `du`, to the byte. That is checked on every commit.
+
+## Reading the table
+
+```
+      size  of tree              share      files  path
+ 661.5 GiB  █████▋░░░░░░░░░░░░   31.9%        350  checkpoints/
+ 343.8 GiB  ██▊░░░░░░░░░░░░░░░   16.6%        968  datasets/
+ 470.9 GiB  ▒▒▒▒▒▒▒▒░░░░░░░░░░   22.9%      4,117  (84 more — use -n 0 for all)
+```
+
+The bar is share of the whole tree, so it always agrees with the number beside
+it. The hatched row is everything not listed. The column you sorted by is the one
+in colour — under `-i`, `files` takes the tone and `size` steps back. Sizes are
+cumulative, so any row agrees with `du -s` on that path.

rapidu-0.1.0/README.md

@@ -0,0 +1,61 @@
+<h1 align="center">rapiDU</h1>
+
+<p align="center">
+  <strong>A much faster <code>du</code> that tells you why your quota is full.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/PursuitOfDataScience/rapidu/actions/workflows/ci.yml"><img src="https://github.com/PursuitOfDataScience/rapidu/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <img src="https://img.shields.io/badge/python-3.6%2B-blue.svg" alt="Python 3.6+">
+  <img src="https://img.shields.io/badge/dependencies-none-brightgreen.svg" alt="No dependencies">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT License">
+</p>
+
+<p align="center">
+  <img src="assets/demo.gif" width="900" alt="rapiDU walking a project tree and explaining that it occupies 266.8 MiB to hold 75.5 MiB of data, ranking the same tree by file count, printing a quota table with the age of its snapshot, finding 512 MiB held by a deleted-but-open file descriptor, and catching a freshly written GPFS tree that loses 224 MiB while it settles.">
+</p>
+
+## Install
+
+```bash
+pip install rapidu
+```
+
+## Use
+
+```bash
+rdu                      # this directory: how big, and what is big inside it
+rdu /project/mylab       # any other path
+rdu ~/scratch -n 20      # list 20 entries instead of 10
+
+rdu -i                   # rank by file count -- what an inode quota limits
+rdu -c                   # count files only, no stat: ~8x again on GPFS
+rdu -Q                   # the quota table, and the age of its figures
+rdu -D                   # space held by files deleted while still open
+rdu -a                   # the full audit: quota + /proc scan + reconciliation
+```
+
+## Faster, and the same number
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/benchmark-dark.png">
+    <img src="assets/benchmark-light.png" width="720" alt="Cold GPFS walk: du takes 168.1s against rapiDU's 25.4s on a 792,225-file package cache (6.6x), and 298.5s against 57.4s on a 1,686,589-file project directory (5.2x).">
+  </picture>
+</p>
+
+Same total as `du`, to the byte. That is checked on every commit.
+
+## Reading the table
+
+```
+      size  of tree              share      files  path
+ 661.5 GiB  █████▋░░░░░░░░░░░░   31.9%        350  checkpoints/
+ 343.8 GiB  ██▊░░░░░░░░░░░░░░░   16.6%        968  datasets/
+ 470.9 GiB  ▒▒▒▒▒▒▒▒░░░░░░░░░░   22.9%      4,117  (84 more — use -n 0 for all)
+```
+
+The bar is share of the whole tree, so it always agrees with the number beside
+it. The hatched row is everything not listed. The column you sorted by is the one
+in colour — under `-i`, `files` takes the tone and `size` steps back. Sizes are
+cumulative, so any row agrees with `du -s` on that path.

rapidu-0.1.0/pyproject.toml

@@ -0,0 +1,140 @@
+[build-system]
+requires = ["setuptools>=64", "wheel", "setuptools-scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[project]
+# Display name only. PyPI matches case-insensitively (PEP 503), so this
+# installs as `pip install rapidu` just as readily, and the importable
+# module stays lowercase `rapidu` -- the PyYAML/yaml arrangement.
+name = "rapiDU"
+description = "A much faster du that tells you why your quota is full."
+readme = "README.md"
+license = { text = "MIT" }
+# Stdlib only, and deliberately conservative: the tool is most useful on a bare
+# login node during a quota emergency, where the interpreter is whatever the OS
+# shipped and pip may not be able to write anywhere. Verified running on the
+# 3.6.8 /usr/bin/python3 of a RHEL8 login node; CI covers 3.9-3.13, which is the
+# range GitHub runners still provide.
+requires-python = ">=3.6"
+authors = [{ name = "Youzhi Yu", email = "yuyouzhi666@icloud.com" }]
+# No "slurm" here: this package never calls a scheduler. It reads filesystems,
+# quota backends and /proc, and everything it uniquely reports is a property of
+# a quota'd network filesystem rather than of a batch system.
+keywords = ["du", "disk-usage", "quota", "inodes", "gpfs", "lustre", "hpc", "storage"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering",
+    "Topic :: System :: Filesystems",
+    "Topic :: System :: Monitoring",
+    "Typing :: Typed",
+]
+# No runtime dependencies, on purpose. This runs during a storage emergency, on
+# a login node, possibly with a full home directory that pip cannot write to.
+dependencies = []
+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://github.com/PursuitOfDataScience/rapidu"
+Repository = "https://github.com/PursuitOfDataScience/rapidu.git"
+Documentation = "https://github.com/PursuitOfDataScience/rapidu#readme"
+Issues = "https://github.com/PursuitOfDataScience/rapidu/issues"
+
+[project.scripts]
+rapidu = "rapidu.cli:main"
+# `rdu` is the short alias, and it is also how the name stays tied to `du`:
+# you type `du`, you type `rdu`.
+#
+# Both names were checked against the registries on 2026-08-02, because
+# Constraint 16 exists. `rapidu` is free on PyPI, npm and crates.io. `rdu` is
+# taken on PyPI by an unrelated chemistry library that ships no console script,
+# and no Debian package installs an `rdu` binary, so the *command* is clear.
+#
+# The previous alias was `sd`, which was wrong: chmln/sd is a widely packaged
+# Rust find-and-replace tool in Debian, Ubuntu, Homebrew and Arch, so on any
+# machine with both installed one of them was silently shadowed depending on
+# PATH order.
+rdu = "rapidu.cli:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    # Upper-bounded on purpose: a formatter with no ceiling turns `ruff format
+    # --check` into a job that fails on a day nobody touched the repo. 0.15 and
+    # 0.16 were both verified to leave this tree unchanged.
+    "ruff>=0.15,<0.17",
+    "mypy>=1.8,<3",
+    "build>=1.0",
+    "twine>=4.0",
+    "setuptools-scm>=8",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["rapidu*"]
+
+[tool.setuptools.package-data]
+rapidu = ["py.typed"]
+
+[tool.setuptools_scm]
+# Written at build/install time so the version needs no runtime metadata
+# lookup -- importlib.metadata does not exist on the 3.6 login-node python.
+version_file = "src/rapidu/_version.py"
+# setuptools-scm's stock template opens with `from __future__ import
+# annotations` and annotates with PEP 604 unions, which is a SyntaxError on
+# 3.6 and would break the login-node path this package exists to serve.
+# Emit the one line actually needed instead. Guarded by
+# tests/test_py36_compat.py.
+# Must be a TOML *basic* string: a literal ('...') one would not expand \n.
+version_file_template = "__version__ = \"{version}\"\n"
+
+[tool.ruff]
+target-version = "py38"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "C4", "SIM"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/rapidu/cli.py" = ["T201"]
+"src/rapidu/report.py" = ["T201"]
+# The deleted-fd tests must hold descriptors open across statements -- that is
+# precisely the condition under test -- so a context manager is not available.
+"tests/test_deleted.py" = ["SIM115"]
+# Same for the demo renderer: its unlinked-but-open scene only exists while the
+# descriptor is still held, which a `with` block would close.
+"assets/render_demo.py" = ["SIM115"]
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.mypy]
+python_version = "3.10"   # mypy's own floor; the runtime floor is 3.6, guarded by tests/test_py36_compat.py
+ignore_missing_imports = true
+warn_unused_ignores = false
+exclude = "src/rapidu/_version.py"
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.coverage.run]
+source = ["rapidu"]
+omit = ["*/tests/*", "*/_version.py"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+]