https://github.com/jeffctown/xcutility

A tool to find and delete files that are missing from Xcode projects
https://github.com/jeffctown/xcutility

ios macos objective-c swift tvos xcode

Last synced: 9 days ago
JSON representation

A tool to find and delete files that are missing from Xcode projects

• Host: GitHub
• URL: https://github.com/jeffctown/xcutility
• Owner: jeffctown
• License: mit
• Created: 2019-02-14T22:24:27.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-05-31T23:04:43.000Z (over 4 years ago)
• Last Synced: 2024-10-15T09:29:15.724Z (22 days ago)
• Topics: ios, macos, objective-c, swift, tvos, xcode
• Language: Swift
• Size: 117 KB
• Stars: 36
• Watchers: 1
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# xcutility

[![Swift Version](https://img.shields.io/badge/Swift-5.0-orange.svg?style=for-the-badge)](https://swift.org)

[![GitHub release](https://img.shields.io/github/release/jeffctown/xcutility.svg?style=for-the-badge)](https://github.com/jeffctown/xcutility/releases)

[![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg?style=for-the-badge)](https://raw.githubusercontent.com/jeffctown/xcutility/master/LICENSE.md) 

[![Build Status](https://travis-ci.org/jeffctown/xcutility.svg?&branch=master)](https://travis-ci.org/jeffctown/xcutility)[![codecov.io](https://codecov.io/github/jeffctown/xcutility/coverage.svg?branch=master)](https://codecov.io/github/jeffctown/xcutility?branch=master)

xcutility is a tool to find and delete unused files from Xcode projects.  

It recursively searches through a path to find all of the path's Xcode projects and files, and will tell you which files are not referenced or built in any of your Xcode projects.  

## Installation

### Using a pre-built package:

You can install xcutility by downloading `xcutility.pkg` from the

[latest GitHub release](https://github.com/jeffctown/xcutility/releases/latest) and

running it.

### Compiling from source:

You can also build from source by cloning this project and running

`make install` (Xcode 10.2 or later).

## Quick Start

* Find Swift files not referenced in any Xcode projects:

```xcutility norefs --extensions .swift```

* Find Objective C files not referenced in any Xcode projects:

```xcutility norefs --extensions .m,.h```

* Find Swift & Objective C files not referenced in any Xcode projects:

```xcutility norefs --extensions .m,.h,.swift```

* Find Swift files not compiled in any Xcode projects:

```xcutility unbuilt --extensions .swift```

* Find Objective C files not compiled in any Xcode projects:

```xcutility unbuilt --extensions .m```

* Find Swift & Objective C files not compiled in any Xcode projects:

```xcutility unbuilt --extensions .m,.swift```

## Usage

### Help

```

$ xcutility help

Available commands:

   all       Find files that are not built or referenced in any Xcode projects

   help      Display general or command-specific help

   norefs    Find files that are not referenced in any Xcode projects

   unbuilt   Find files that are referenced in Xcode but not built in any build phases

   version   Display the current version of xcutility

```

### Unreferenced Files

#### Find Files that are Unreferenced by any Xcode Projects in the Current Directory

```bash

xcutility norefs

```

#### Find Files that are Unreferenced by any Xcode Projects In a Specific Path

```bash

xcutility norefs --path ~/MySweetSweetApp/

```

#### Find Files With a Certain Extension that are Unreferenced by any Xcode Projects 

```bash

xcutility norefs --extensions .swift

```

#### Find Only Files With Multiple Extensions that are Unreferenced by any Xcode Projects

```bash

xcutility norefs --extensions .swift,.h,.m

```

#### Find And Delete Files With Multiple Extensions that are Unreferenced by any Xcode Projects

```bash

xcutility norefs --extensions .swift,.h,.m --delete

```

#### Find Unreferenced Files Verbosely

```bash

xcutility norefs --verbose

```

### Find Unreferenced Files Combined Usage

```bash

xcutility norefs --path ~/MySweetSweetApp/ --extension .swift,.h,.m --verbose --delete

```

### Unbuilt Files

#### Find Files that are not built by any Xcode Project Build Phases in the Current Directory

```bash

xcutility unbuilt

```

#### Find Files that are not built by any Xcode Project Build Phases in a specific path

```bash

xcutility unbuilt --path ~/MySweetSweetApp/

```

#### Find Files With a Certain Extension that are not built by any Xcode Projects Build Phases

```bash

xcutility unbuilt --extensions .swift

```

#### Find Only Files With Multiple Extensions that are not built by any Xcode Projects Build Phases

```bash

xcutility unbuilt --extensions .swift,.h,.m

```

#### Find And Delete Files With Multiple Extensions that are not built by any Xcode Projects Build Phases

```bash

xcutility unbuilt --extensions .swift,.m --delete

```

#### Find Unbuilt Files Verbosely

```bash

xcutility unbuilt --verbose

```

### Find Unbuilt Files Combined Usage

```bash

xcutility unbuilt --path ~/MySweetSweetApp/ --extension .swift,.m --verbose --delete

```

## License

xcutility is released under the [MIT license](LICENSE.md).