Contribution Guide

Legal

All of Typhoon is Licensed under Apache v2.0. By contributing to Typhoon you agree:

• To license the work under Apache v2.0
• That you have the right to assign this license - this is your original work, or you have permission from the owners to contribute.

Attribution and Copyright

All files MUST include the copyright header found in the repository: Copyright-Header.txt. Your help replacing any incorrect headers with this canonical one, as we propagate this requirement across the codebase, is greatly appreciated. We recommend the use of a code snippet with the abbreviation 'typhoon_header' to automate the insertion of this notice.

If you want, you can use a filter that will automatically check the header presence and include it if it is not already there for every file you add or modify. To enable this behaviour you should run this two commands in your working copy directory:

git config filter.typhoonheader.smudge 'cat'
git config filter.typhoonheader.clean '`git rev-parse --git-dir`/../Scripts/typhoonheader'

This two config entries register the filter that will add the right header for you.

Command-Line Build

Builds unit tests, integration tests and code coverage reports. Please run this script before committing your work or sending requests. This is the same script the build server runs, so running locally will minimize the chance of breakage and any subsequent impact on the productivity of your fellow developers.

Dependencies:

We recommended installing CLI build dependencies using HomeBrew (http://brew.sh) or MacPorts (https://www.macports.org/) and Ruby gems.

brew install lcov
brew install groovy
brew install doxygen
brew install graphviz
gem install xcpretty

. . and now run

build.sh

Code Style

The AppCode project included in the repository has a complete set of code styles that AppCode's formatting engine will apply. We'd appreciate a contribution that contains a similar configuration for Uncrustify.

In case of any doubt, the best thing is looking the code around the point that you are editing, and keep the style consistent.

Core Team

• Jasper Blues (Founder / Project Lead) - [email protected]
• Aleksey Garbarev, Principal Developer
• Robert Gilliam - [email protected]
• Daniel Rodríguez Troitiño
• Erik Sundin

With contributions from:

• César Estébanez Tascón : Circular Dependencies fixes.
• Bryn Cooke : Late injections & story board integration.
• Jeffrey Roberts, Mobile Software Engineer at Riot Games, previous contributor to Swiz for ActionScript : Advice, feedback and testing.
• José González Gómez, Mobile and cloud developer at OPEN input : Feedback; testing, support for property placeholders in initializers.
• Sergio Padrino Recio : Performance improvements.
• Josh Ervine : Feedback and support for TyphoonFactoryProviders.
• Your name here!!!!!!!

(If you've sent a pull request and didn't get a mention. . . sorry! Please let us know and we'll correct it).

---