Product definition
Scoped the tool around one operational question: where is this chosen directory using its space?
Open Source / Python Automation / Daily Build
Disk Map
/ Overview
A dependency-free Python CLI that maps a local directory by total size, file type and largest files without following symbolic links.
A nearly full disk shows that space is running out but not which local files or file types are responsible, and manual inspection becomes slow across nested directories.
/ Provided servicesClear thinking.
Clear thinking.
Practical delivery.
Safe traversal
Kept scanning read-only, contained to the selected root and explicitly excluded symbolic links so the report does not cross unexpected boundaries.
Python engineering
Implemented stable aggregation, human-readable sizes, JSON output and useful CLI error codes with only the standard library.
/ Solution
I built a standard-library Python CLI that safely walks one chosen directory, aggregates byte usage by extension and ranks its largest files while skipping symbolic links.
/ Impact
Readable directory-size summary
File-type usage breakdown
Configurable largest-file ranking
Ten passing standard-library tests
Python
os.walk, pathlib and defaultdict provide deterministic traversal and aggregation without third-party dependencies.
CLI & JSON
argparse exposes directory, ranking-limit and machine-readable output options for terminal or local automation use.
Unittest
Ten tests cover formatting, grouping, totals, ranking, symlink boundaries, empty directories, invalid input and JSON output.