This entry assumes you already have general understandings about Travis CI (helps build and run tests) and Coveralls.io (tracking code coverages), if not you should go to travis-ci.com and coveralls.io first.
With Travis CI, you can link and make use of it on any public Github repos; with private ones, a paid package will be needed.
Here are the shorten guideline, hope it will be helpful:
1. In Github repo settings section, add Travis CI as new service.
2. Add .travis.yml into root directory of the repo.
Sample content:
language: python python: - "2.6" - "2.7" env: - DJANGO=1.4 DJANGO_VERSION_MIN=1.4 DJANGO_VERSION_MAX=1.5 - DJANGO=1.6 DJANGO_VERSION_MIN=1.6 DJANGO_VERSION_MAX=1.7 - DJANGO=1.7 DJANGO_VERSION_MIN=1.7 DJANGO_VERSION_MAX=1.8 matrix: exclude: - python: "2.6" env: DJANGO=1.7 DJANGO_VERSION_MIN=1.7 DJANGO_VERSION_MAX=1.8 install: - pip install -q "Django>=$DJANGO_VERSION_MIN,<$DJANGO_VERSION_MAX" - pip install -q django-nose==1.2 coverage coveralls flake8 - pip install -e . script: - flake8 scraper --exclude=*/migrations/*,*test* - coverage run --source='./' --omit=*/migrations/*,*test* run_tests.py after_script: - coveralls
This declares the main language for the target product, its versions, and preferred environments. Next sections are steps for installing, testing and submitting coverage result.
If the results of installing and testing sections are good, then you will receive blue 'passing' badges for the corresponding repository (from both Travis CI and Coveralls.io)
3. Embed the badges from Travis CI, Coveralls.io into the README file.
The most recent repo of mine (django-scraper) currently has these