python-du

A disk usage analyzer that scans a directory and prints a visual tree map of folder sizes — right in your terminal.

Example

Installation

pip install -e .

pip uninstall python-du

Usage

python-du [path] [options]

If no path is given, the current directory is scanned.

Options

Examples

Scan the current directory with defaults:

python-du

Scan /var/log showing only entries above 5%, two levels deep:

python-du /var/log -d 2 -m 5

Pipe to a file (automatically disables color):

python-du /home > usage-report.txt

Publishing to PyPI

pip install build twine
python -m build
twine upload dist/*

When prompted, use __token__ as the username and your PyPI API token as the password.

To skip the prompt, create a ~/.pypirc file:

[pypi]
username = __token__
password = pypi-YOUR-TOKEN-HERE

Note: Bump the version in pyproject.toml before each upload — PyPI rejects duplicate version numbers.

Requirements

• Python >= 3.9
• No external dependencies