wiki:TravisCoverals

Version 2 (modified by Antony Polukhin, 8 years ago) ( diff )

--

Travis and Coveralls integration

We'll be adding TravisCI and Coveralls integration to a Boost library. Let's take a Boost.LexicalCast as an example. At the end we'll get ​something like this.

Travis requires some access permissions to the repository that are usually provided by Boostorg Admins. However bothering Admins is actually not required:

  • go to the Boost project page (in our example it would be ​https://github.com/boostorg/lexical_cast)
  • press the "Fork" button at the top right corner. Now you have a copy of the boost project in your account.
  • clone the original boostorg repo or use an existing clone. Change directory to the clone folder (cd boost_maintain/boost/libs/lexical_cast/)
  • add our forked repo as another remote host for default push: git remote set-url --add origin git@github.com:<your_login>/lexical_cast.git. If everything is right, you'll see something like this if you execute git remote -v:
    origin	git@github.com:boostorg/lexical_cast.git (fetch)
    origin	git@github.com:boostorg/lexical_cast.git (push)
    origin	git@github.com:<your_login>/lexical_cast.git (push)
    
  • now add the .travis.yml file, tune the README.md and commit changes:
    cp ../variant/.travis.yml ./                       # Copying .travis.yml from Boost.Variant
    git add .travis.yml                                # Adding .travis.yml for next commit
    
    cp ../variant/README.md ./                         # Copying README.md from Boost.Variant
    sed -i 's/variant/lexical_cast/g' README.md        # Replacing `variant` with `lexical_cast`
    sed -i 's/apolukhin/<your_login>/g' README.md      # Replace `apolukhin` login name wuth your own login name
    gedit README.md                                    # ... editing README.md in editor
    git add README.md                                  # Adding README.md for next commit
    
    git commit -m "Travis and Coveralls integration"   # Committing changes to GIT
    git push                                           # push changes to boostorg and forked repo using one command
    

That's it! If everything is done right, you'll see the build process going on TravisCI and after ~20 minutes results will be visible in README.md view on github.

Note: See TracWiki for help on using the wiki.