Project

fui

0.54
Low commit activity in last 3 years
There's a lot of open issues
A long-lived project that still receives updates
fuidblock/fuiHomepageDocumentationSource CodeBug TrackerWiki
Find unused Objective-C imports.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
419,326
Stars
2,046
Forks
178
Watchers
37
 Releases
Current version
0.6.0
Total releases
8
First release
2014-01-22
Latest release
2026-04-12
 Issues
Open Issues
10
Closed Issues
18
Total Issues
28
Issue Closure Rate
64%
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
5
Merged Pull Requests
19
Pull Request Acceptance Rate
79%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2019-12-22
Reverse Dependencies
0

 Dependencies

Runtime

gli
>= 0
 Project Readme

Fui

Gem Version Test

Find unused Objective-C imports.

What fui does: finds header (.h) files that are never imported anywhere in your project — i.e. classes that can potentially be deleted entirely.

What fui does not do: find #import statements within a file that are unused by that file's code. For that, use a tool like Clang's unused-includes warning or AppCode.

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 header (.h) files that are not imported anywhere in the project, and exits with the number of such 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.