Free, local and automatic testing of GitHub Pull Requests with Xcode Bots. Keep your team productive and safe. Get up and running in minutes. (Follow Builda on Twitter for infrequent updates.)

Xcode 7 support is in beta. Get the latest beta release if you'd like to give it a try. We still fully support Xcode 6 in versions up to 0.2.9.

Version 1.0 is being built on a branch. The latest stable build is on master.

💭 Thinking of trying Buildasaur? Check out the list of teams and projects already using it.
🔄 Already using Buildasaur? Please consider adding yourself to our success stories!
💝 Want to contribute? Take a look at issues with the label "up-for-grabs", comment on the issue that you're working on it and let's improve Buildasaur together!

To find out how to set up Xcode Server on your Mac in minutes (and more), check out my series of tutorials.

The code that makes talking to Xcode Server easy lives in a separate project: XcodeServerSDK. Buildasaur is just one app that uses this SDK, but now you can build your own!

Buildasaur was designed to be easy to setup, while still giving you all the customization you need. By choosing the right defaults, most projects can get Buildasaur setup in minutes, start it and never have to worry about it again.

Buildasaur runs as a background Mac app, its configuration window goes away when you don't need it. This gives you a chance to quickly peek at the status of your syncers from the menu bar.

You have multiple options of getting started with Buildasaur, from source code to downloading the App.

• get the .app of the latest release
• starting with version 0.2.8, release .app is always signed with my Developer ID (Jan Dvorsky), so that you can be sure you're really launching an official release. Feel free to run Buildasaur yourself from code, just be aware that you will get a warning from OS X if you have Gatekeeper enabled.
• check out code and build and run in Xcode (requires Xcode 6.3 with Swift 1.2, thus OS X 10.10.3)

• Install Xcode 6+, Xcode Server 4+ and have your GitHub repo credentials ready

Xcode Server Setup

• Open Server.app, go to Services -> Xcode and add select your Xcode
• after the setup finishes, enable the service with the giant switch on the top right

GitHub Setup

• go to GitHub.com and when you're signed in, go to Settings -> Applications -> Personal access tokens -> Generate new token
• leave the default rights and copy the token

Buildasaur Setup

• Checkout your repo locally over SSH
• Launch Buildasaur (see Getting Buildasaur for instructions)
• Click Add your Xcode Server
  • Fill in the IP address/host name of your Xcode server (127.0.0.1 if on the same machine)
  • Fill in the username and password if only some users can create bots
  • Click Done, which validates the credentials
• Click Add your Xcode Project and select the Xcode project or workspace that you want to test
  • Click on Pick a template to build, which will guide you through setting up of a new template
  • Paste your GitHub token
  • Select the path to your SSH keys
  • (Optional) Fill in your SSH key passphrase
  • Make sure that your account has read and write access to the GitHub repository (Buildasaur needs to be able to read Pull Requests, read PR comments, add a PR comment, read commit statuses, add a commit status)
  • Click Done, which validates the settings, SSH access and GitHub access
• In the bottom part, choose the sync interval (default is now 15 seconds, which works pretty well, don't decrease it too much, GitHub rate-limits access to 5000 requests per hour)
• If both Server and Project configs say Verified access, all is well, click Start to start syncing your pull requests with bots.

The default workflow is as follows:

• a Pull Request is created by the author, Builda creates a bot
• if the "lttm" barrier (see below) is disabled, an integration is started immediately. if the "lttm" barrier is enabled, Builda waits until someone comments "lttm" in the Pull Request conversation (the "lttm" barrier is enabled by default, can be disabled in the UI)
• an integration is performed on the PR's branch
• result of the integration is reported back to GitHub by changing the status of the latest commit of the branch and posting a comment in the PR conversation (optional, enabled by default)
• if any additional commits are pushed, another integration gets performed and reported back
• when a PR is closed, the bot gets deleted
• if you require a different workflow, create an issue and we'll figure something out

• "Looks Testable To Me"
• an optional extra step in the workflow (enabled by default)
• instead of integrating immediately after a PR is created, the reviewer first has a chance to look at the code and request any fixes of the code from the author
• when the reviewer is happy with the code visually, she comments "lttm" in the PR and the bot is activated and performs an integration of the code
• from that point on, if any additional commits are pushed, they get integrated as with the basic workflow

• Builda can (and by default does) post a comment into the PR conversation when an integration finishes

• this can be controlled in the UI with the toggle named "Post Status Comments"

In addition to automatic bot management with syncers, you can create bots from an existing Build Template and a branch by clicking Manual Bot Management when your syncer is setup. This is useful for creating one-off bots based on e.g. release branches with a different Build Template than you use for PRs.

In case Builda crashes, you can find crash logs at ~/Library/Logs/DiagnosticReports/Buildasaur-*. Please let me know if that happens and I'll take a look. Also, Builda logs (pretty verbosely) to ~/Library/Application Support/Buildasaur/Builda.log, so this is another place to watch in case of any problems.

Please create an issue with a description of a problem or a pull request with a fix. Or, if you just want to help out, take a look at issues with the label "up-for-grabs", comment on the issue that you're working on it and let's improve Buildasaur together!

If you're feeling brave and would like to dig into how Xcode Server works under the hood, you might find this article I wrote useful: Under the Hood of Xcode Server. Recommended reading if you want to extend Buildasaur to take a greater advantage of Xcode Server (there are still a plenty of unused APIs.)

I also write about working on Buildasaur, its challenges, interesting problems and failures on my blog.

MIT

• Vojta Micka (@higgcz) for our great new logo!

Honza Dvorsky - http://honzadvorsky.com, @czechboy0