tin-summer 1.4.1

Command-line tool to find build artifacts and junk on your computer. Shatters records not glass.
Documentation

The Tin Summer

Build Status

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. It's especially useful when you're writing build systems, because you can make sure your clean command gets everything.

As of recently, sn is also a replacement for du. It has far nicer output, saner commands and defaults, and it even runs faster on multicores.

Installation

Binary install

The easiest way to install for Linux or Windows is to download a binary from the releases page.

Cargo

If your platform doesn't have binaries, get cargo. Then:

 $ cargo install tin-summer

Make sure you are on nightly; otherwise

rustup run nightly cargo install tin-summer

Use

Currently, sn looks for files that either have an extension associated with build artifacts, as well as executable files listed in the relevant .gitignore, .ignore, or darcs boringfile.

Search current directory for directories with build artifacts:

 $ sn ar

Look in $DIR for build artifacts and sort them by size:

 $ sn ar $DIR --sort

Look for artifacts or directories containing artifacts that occupy more than 200MB of disk space:

 $ sn ar -t200M

Shell completions

After setting BASH_COMPLETIONS_DIR or FISH_COMPLETIONS_DIR, you can use the bash or fish features like so:

 $ cargo install --features fish tin-summer

Accessibility

To turn off colorized output:

export CLICOLOR=0

Features

  • find "likely build artifact" directories
    • use .gitignore/path to make decision
    • smart output (only first few files per dir)
  • colorized output
  • sort results by size

Screenshots (alacritty + solarized dark)

The Tin Summer

Displaying a user's timeline in a terminal.

du

Displaying a user's timeline in a terminal.

Languages Supported

The intent is to support basically anything, so if your DOC is not on the list, feel free to open a PR or start an issue.

  • Haskell (incl. GHCJS)
  • rust
  • julia
  • python
  • Elm
  • nim
  • Vimscript
  • Idris
  • FORTRAN
  • C

Name

The name is a pun on Günter Grass' novel Die Blechtrommel or The Tin Drum in English. Thus, the binary is sn, and it sums up file sizes in directories.