How to Contribute to Troposphere


  1. Fork
  2. Make the code better
  3. Make the code pass tests
  4. Create a Pull Request

How to Get Help

See at top of the project for developer mailing list.

How to Test Your Code

The latest test scripts can be found at If you look at the details of a job, you can see what automated tests will be run against any commits to the project.

  1. Create a virtualenv (e.g. virtualenv ~/virtualenv/troposphere)
  2. Activate it: source ~/virtualenv/troposphere/bin/activate
  3. pip install --upgrade pip setuptools wheel
  4. pip install -r docs/requirements.txt
  5. Run tests:
  6. pycodestyle .
  7. pyflakes .
  8. python test

Tests are run against Python 2.7, 3.3, 3.4, and 3.5.

Contributing Example Code

New example code should go into troposphere/examples. The expected CloudFormation Template should be stored in troposphere/tests/examples_output/. When tests are run the output of the code in the examples directory will be compared with the expected results in the example_output directory.