Rugby

๐Ÿˆ Cache CocoaPods for faster rebuild and indexing Xcode project

Stars
618
Forks
46
Open issues
5
Closed issues
56
Last release
3 months ago
Last commit
3 months ago
Watchers
618
Total releases
80
Total commits
940
Open PRs
1
Closed PRs
123
Repo URL
Platform
Mac
License
mit
Category
Offers premium version?
NO
Proprietary?
NO
About




Motivation

Why do we need some optimizations while working on huge projects with CocoaPods?
- Slow and unnecessary indexing of pods targets, which implementation we rarely try to edit;
- Redundant rebuild time, probably as a result of problems, related to CocoaPods or Xcode;
- Freezing UI during navigating through a project or editing it;
- Broken or extremely slow autocompletion;
- Noisy laptop turbines, heated aluminum, and infinite spinning pinwheel.

More in the ๐Ÿ“– foundation and remastering stories.

Description

๐Ÿˆ Rugby is CLI tool that was developed to solve the above problems:
+ Cache all pods dependencies and remove their targets from the Pods project;
+ Rebuild only changed pods or even download them;
+ Delete any unneeded targets with sources from a project and reduce its size.

What makes it different?

๐Ÿ•Š Not a project dependency, just an optional step;
๐ŸŒฑ Doesn't change Podfile and Podfile.lock;
โœˆ๏ธ Can run a sequence of commands from a YAML file;
๐Ÿ•น๏ธ Single command usage;
๐Ÿณ Ready for remote cache;
๐Ÿงฃ Cozy log output;
๐Ÿš€ Swiftish and uses native Xcode build system.

Ruby alternatives: PodBuilder | CocoaPods Binary Cache | CocoaPods Binary


How to install ๐Ÿ“ฆ

First of all, if you have the first version Rugby 1.x, you need to delete it.
Then call where rugby command and be sure that there are no any of paths to rugby.

First Install
curl -Ls https://swiftyfinch.github.io/rugby/install.sh | bash
Self-Update

If you already have Rugby, which version is at least 2.0.0b2, you can use such a command.

> rugby update
Full Guide

Read more in the guide how to install it.
If you look for the legacy Rugby 1.x, visit this page.

How to use ๐Ÿˆ Preconditions

  1. If you use Objective-C in your project, be sure that you import modules correctly.
    Use @import Something instead of #import "Something.h".
    Because Rugby will include built frameworks in your project;
  2. Before using Rugby you should be sure that your project source code is finalized.
    ๐Ÿ”ธ For example: if you use SwiftGen, run it before calling Rugby.
    Otherwise, your source code will be modified during building with Rugby. Then the hashes of binaries will not be suited.
    If you encounter a problem, try to use rugby build pre to prebuild your project and finalize source code;
  3. Be sure that all your pods (including development) are ready to build standalone.
    Otherwise, you can get a state when one of them can't be reused correctly without the source of its dependencies.
    As a temporary workaround, you can exclude some pods like rugby -e BadPod.
    ๐Ÿ”ธ For example: if some of your pods use incorrect headers.

Then run this command in your project directory after each pod install.
It will build all targets by default:

> rugby

Deintegrate it with the rollback command:

> rugby rollback

Also, you can write a custom plan (sequence of commands).
Use ๐Ÿˆ RugbyPlanner for visualizing changes in your project without applying them.
For advanced usage, please read the documentation below.

๐Ÿ“š Documentation

๐Ÿ“ฆ How to Install
๐Ÿ“– Commands Help
๐Ÿš Migration Guide
๐Ÿณ Remote Cache


๐ŸŽฏ Roadmap

  • ๐Ÿ‘จ๐Ÿปโ€๐Ÿ”ง Increase Code Coverage up to 50% #236

๐Ÿค Contribution

Feel free to open a pull request / an issue or a discussion.

๐Ÿ“ฎ Support

If you want to support this project, you can do some of these:
1) Press โญ๏ธ. It's a nice mark which means that Rugby is useful;
2) Share the project ๐ŸŒ somewhere with somebody;
3) Leave feedback in the discussions ๐Ÿ’ฌ section.

Let's Roll-oll ๐Ÿˆ

Alternative Projects

Subscribe to Open Source Businees Newsletter

Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.

We'll never share your email with anyone else.