5 releases

0.2.5 Oct 23, 2024
0.2.4 Oct 23, 2024
0.2.2 Jan 26, 2022
0.2.1 Oct 29, 2021
0.2.0 Oct 29, 2021

#171 in Filesystem

MIT/Apache

16KB
359 lines

dux

A Rust implementation of GNU coreutils du in order to learn and explore Rust. This is by no means better, faster or smarter compared to du. So don't use it.

Build

# build
$ cargo build --release

# build and publish to ~/bin/ folder
$ ./publish

Usage

# current path
$ dux
Total size is 204828703 bytes (204.83 MB) across 1176 items

# specify a path
$ dux ~/bin/
Total size is 586934311 bytes (586.93 MB) across 3372 items

# list largest files
$ dux -l
Largest files:
+----------+----------------+
| Size     | File           |
+----------+----------------+
| 23.56 MB | {file 1}       |
+----------+----------------+

Total size is 586934311 bytes (586.93 MB) across 3372 items

Cli Args

dux 0.2.0

Calculate disk space used by a folder

USAGE:
    dux [OPTIONS] [PATH]

ARGS:
    <PATH>    The folder to use (default to current directory)

OPTIONS:
    -h, --help                Print help information
    -l, --list-large-files    Lists top 10 largest files
    -V, --version             Print version information

Performance

For smaller directory, the performance is on-par or better than du (I have no idea why!)

$ time du -hd 0
126G    .
du -hd 0  0.01s user 0.04s system 47% cpu 0.088 total

$ time dux
Total size is 129930609382 bytes (129.93 GB) across 159 items
dux  0.00s user 0.01s system 51% cpu 0.024 total

but for larger folder du is 3x faster at least,

$ time du -hd 0
699M    .
du -hd 0  0.05s user 0.67s system 48% cpu 1.498 total

$ time dux     
Total size is 666559986 bytes (666.56 MB) across 31623 items
dux  0.21s user 3.16s system 76% cpu 4.390 total

Suggestions

If you have any idea about how the performance can be improved (without writing unsafe code) and anything to make the code more idiomatic - then help this friend out by sending PR.

Dependencies

~4–11MB
~113K SLoC