[![CI](https://github.com/aleury/dstats/actions/workflows/ci.yml/badge.svg)](https://github.com/aleury/dstats/actions/workflows/ci.yml)
[![Nightly](https://github.com/aleury/dstats/actions/workflows/nightly.yml/badge.svg)](https://github.com/aleury/dstats/actions/workflows/nightly.yml)
[![Audit](https://github.com/aleury/dstats/actions/workflows/audit.yml/badge.svg)](https://github.com/aleury/dstats/actions/workflows/audit.yml)

# Install with Cargo

```
$ cargo install dstats
```

# Build from source

```
$ git clone git@github.com:aleury/dstats.git

$ cd dstats

$ cargo install --path .
```

# Usage

```
A simple utility for finding large files on your system.

Usage: dstats [OPTIONS] [PATH]

Arguments:
  [PATH]  [default: .]

Options:
  -n <NUMBER>      [default: 5]
  -h, --help       Print help
  -V, --version    Print version
```

## Examples

```sh
# View the top 5 largest files under the current directory
$ dstats

# View the top 10 largest files under the current directory
$ dstats -n 10

# View the top 10 largest files under the given path
$ dstats ./stuff -n 10
```