durep - disk usage reports

durep generates human-readable HTML and text reports of disk usage from ncdu JSON reports. It is useful for informing users of compute clusters about their disk usage.

For SSI-specific deployment and usage on our internal uGerm server, see out (private) repo rit-deploy-durep.

Installation

Install with pip or uv from the pyproject.toml: uv venv && uv pip install .. To install with dev dependencies: uv venv && uv pip install '.[dev]'.

Usage

durep has two subcommands:

• detail: Takes an ncdu JSON file and creates a detailed report of disk usage with an interactive sunburst diagram. Optionally takes a second JSON file which must be of the same top-level directory at a different time, in which case it provides information about disk usage changes between the two.
• overview: Takes many ncdu JSON files and creates a report with total disk usage per top-level directory over time. Also takes a CSV file with columns project,group mapping the top-level directory basename (project) to an arbitrary group.

Examples

Generate a detailed report from one JSON file

durep detail --out-dir output report.json

Generate a detailed report from a pair of JSON files of the same directory at different times

durep detail --out-dir output report_20260112.json report_20260329.json

Generate an overview of a large collection of NCDU reports

durep overview ncdu_reports/*json --out-dir output --metadata-csv-path metadata.csv