The Tin Summer
If you do a significant amount of programming, you'll probably end up with
build artifacts scattered about. sn
is a tool to help you find those
artifacts.
sn
is also a replacement for du
. It has far nicer
output, saner commands and defaults, and it even runs faster on big directories
thanks to multithreading.
Installation
Binary install
The easiest way to install is to download a binary from the releases page.
Cargo
If your platform doesn't have binaries, get cargo. Then:
Make sure you are on nightly; otherwise
Shell completions
After setting BASH_COMPLETIONS_DIR
or FISH_COMPLETIONS_DIR
, you can install the
bash
or fish
features like so:
Note that this might need to be run as root, depending on your setup.
Use
To list directory and file sizes for the current directory:
$ sn all -f
To get a list of directory sizes concurrently, excluding version control:
$ sn p --exclude '\.git|\.pijul|_darcs|\.hg'
To get a sorted list of the 12 biggest directories in $DIR
:
$ sn sort $DIR -n12
To search current directory for directories with build artifacts:
To look for artifacts or directories containing artifacts that occupy more than 200MB of disk space:
Accessibility
To turn off colorized output:
Comparison
Reasons to use du
- Reads disk usage, not file sizes
- Optionally dereferences symlinks
- Slightly faster on small directories
- Well-supported
Reasons to use sn
- Faster on large directories
- Uses regex for exclusions, making it
dramatically faster than
du
when used with the--exclude
flag. - Defaults to human-readable output
- Colorized output
- Nicer help via clap
- Provides Sorted output
- Finds build artifacts
- Reads file sizes, not disk usage
- Extensible in Rust
- Benefits from upstream improvements in Rust ecosystem
Screenshots (alacritty + solarized dark)
The Tin Summer
du
Heuristic for build artifacts
Currently, sn
looks for files that either have an extension associated with
build artifacts, or executable files that are ignored by version control. It also looks for "build
directories", like .stack-work
, elm-stuff
, etc. and it considers all their
contents to be build artifacts.
Languages Supported
The following is a list of languages sn artifacts
has been tested with.
The intent is to support basically anything, so feel free to open a PR or start an issue.
- Haskell (incl. GHCJS)
- rust
- julia
- python
- Elm
- nim
- Vimscript
- Idris
- FORTRAN
- C