README.md

Fui

Find unused Objective-C imports.

Table of Contents

• Usage
  • Get Help
  • Find Unused Classes in the Current Directory
  • Find Unused Classes in any Path
  • Skip Interface Builder (.xib) Files
  • Ignore Local Imports
  • Ignore Global Imports
  • Ignore a Path
  • Ignore Multiple Paths
  • Delete All Unused Class Files with Prompt
• Xcode Plugin
• Contributing
• Copyright and License

Usage

gem install fui

Get Help

fui help

Find Unused Classes in the Current Directory

fui find

The find command lists all the files that contain unused imports and exits with the number of files found.

Find Unused Classes in any Path

fui --path=~/source/project/Name find

Skip Interface Builder (.xib) Files

Running fui with -x (or --ignore-xib-files) will, for example, mark Foo.h as unused when Foo.xib holds a reference to the Foo class and no other references to Foo.h exist.

fui -x --path=~/source/project/Name find

Ignore Local Imports

Running fui with -l (or --ignore-local-imports) will, for example, mark Foo.h as unused when Bar.h contains a local (quotation syntax) import of Foo.h (eg. #import Foo.h).

fui -l --path=~/source/project/Name find

Ignore Global Imports

Running fui with -g (or --ignore-global-imports) will, for example, mark Foo.h as unused when Bar.h contains a global (bracket syntax) import of Foo.h (eg. #import <Framework/Foo.h>).

fui -g --path=~/source/project/Name find

Ignore a Path

Running fui with -i (or --ignore-path) will, for example, ignore a Pods folder when searching for headers or referencing files.

fui --path=~/source/project/Name --ignore-path=Pods find

Ignore Multiple Paths

Running fui with -i (or --ignore-path) can ignore multiple folders when searching for headers or referencing files.

fui --path=~/source/project/Name --ignore-path=Pods --ignore-path=Libraries find

Delete All Unused Class Files with Prompt

fui --path=~/source/project/Name delete --perform --prompt

Xcode Plugin

Use xcfui for integration with Xcode.

Contributing

There're a few feature requests and known issues. Please contribute! See CONTRIBUTING.

Copyright and License

Copyright (c) 2014-2018, Daniel Doubrovkine, Artsy, based on code by Dustin Barker.

This project is licensed under the MIT License.