Skip to content

Contribution Guide

jasperblues edited this page Dec 16, 2014 · 29 revisions

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

Build Script Output

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

With contributions from:

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