The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

ABOUT

This repository contains a directory full of utilities to bolt on to CPAN-targeting distributions, to add useful travis-ci features to those dists.

PREREQS

All that is needed at present to get started, is a copy of git that provides git subtree, and a copy of Path::FindDev from CPAN.

You don't need Path::FindDev during deployment, its just used to streamline automated patching.

INSTALLING

First, check out a copy of these scripts, it can be a temporary directory, and you'll only need to do this once.

shell $ mkdir /tmp/tci-scripts $ cd /tmp/tci-scripts $ git clone https://github.com/kentfredric/travis-scripts.git

Then, chdir to the root of your project

shell $ chdir $PROJECT

And lastly, execute the installer

shell $ /tmp/tci-scripts/sync_tree.pl

This will create the folder called maint-travis-ci within your distribution, with a tree installed by git subtree, which will track this distribution.

To update your copy of /maint-travis-ci to the latest, simply execute

shell $ $PROJECT/maint-travis-ci/sync_tree.pl

While somewhere in your project.

CAVEATS

Note, this tool uses Path::FindDev, and by proxy, Path::IsDev to find a development root directory somewhere in the ancestry of $CWD.

As such, you will likely need to appease Path::IsDev by having a file of some description that marks the root of the development tree.