Metadata-Version: 2.4
Name: dsz
Version: 0.2.0
Summary: Show disk usage of a directory's immediate children.
Keywords: disk usage,du,cli,filesystem
Author: Kyle O'Malley
Author-email: Kyle O'Malley <j.kyle.omalley@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/jkomalley/dsz
Project-URL: Repository, https://github.com/jkomalley/dsz
Project-URL: Issues, https://github.com/jkomalley/dsz/issues
Project-URL: Changelog, https://github.com/jkomalley/dsz/blob/main/CHANGELOG.md
Description-Content-Type: text/markdown

# dsz

Show disk usage of a directory's immediate children, sorted by size.

## Installation

```
uv tool install dsz
```

## Usage

```
dsz [PATH] [--min-percent N]
```

- `PATH` — directory to scan (default: current directory)
- `--min-percent N` — collapse entries below N% of the total into a single `<other>` line (default: 1.0; N must be between 0 and 100)

## Example

```
$ dsz ~
/home/user    24.2 GB
   18.2 GB  75% Videos               ###############
    4.1 GB  17% Documents            ###
    1.6 GB   7% Downloads            #
  312.4 MB   1% <other 5>
```

Hidden entries (dot files and directories) and symlinks are excluded from all counts. Drill into a subdirectory by passing it as `PATH`.
