Unused

Unused identifies unused code in Rails, Phoenix, and other types of applications, improving developer productivity

Installing and Updating

Homebrew (Recommended)

You can install the formulae via Homebrew with brew tap:

brew tap unused-code/formulae

Next, run:

brew install unused

This will install unused and its corresponding dependencies.

To update, run:

brew update
brew upgrade unused

Nix

There is a Nix expression available in nixpkgs.

There are many ways to run unused with Nix, but the simplest is:

nix-shell -I nixpkgs=https://github.com/NixOS/nixpkgs/archive/nixpkgs-unstable.tar.gz -p unused --run 'unused --help'

Linux

Precompiled binaries are available for the latest release.

Download the linux-musl binary, and move the binary to somewhere within your $PATH.

Prerequisites

It is strongly recommended you install Universal Ctags to generate tags files. Universal Ctags supports more languages and has native parsers for a good number of them, resulting in faster tags generation time.

It is also recommended that you have a tags file generated on a semi-regular basis. Tim Pope wrote an article about wiring up ctags generation with a git hook. thoughtbot's dotfiles also reference a ctags git hook.

Usage

From your project directory, run:

unused

This will generate a list of tokens and corresponding definition locations for removal consideration.

You can see supported command-line flags with:

unused --help

Troubleshooting

If you run into trouble, run

unused doctor

This will perform a series of simple checks to help identify obvious issues with configuration.

License

Copyright 2020 Josh Clayton. See the LICENSE.