Dist::Zilla::Plugin::TravisYML - creates a .travis.yml file for Travis CI
[TravisYML] ; defaults build_branch = /^build\/.*/ notify_email = 1 notify_irc = 0 mvdt = 0 ; These options are probably a good idea ; if you are going to use a build_branch [Git::CommitBuild] release_branch = build/%b release_message = Release build of v%v (on %b) [@Git] allow_dirty = dist.ini allow_dirty = README allow_dirty = .travis.yml push_to = origin push_to = origin build/master:build/master
This plugin creates a .travis.yml file in your distro for CI smoke testing (or what we like to call "[chain smoking|Dist::Zilla::App::Command::chainsmoke/CHAIN-SMOKING-]"). It will also (optionally) create a separate .travis.yml file for your build directory after a release.
.travis.yml
Why two files? Because chain smoking via DZIL will work a lot differently than a traditional C<Makefile.PL; make>. This tests both your distribution repo environment as well as what a CPAN user would see.
Of course, you still need to turn on TravisCI and the remote still needs to be a GitHub repo for any of this to work.
This is a regular expression indicating which (build) branches are okay for running through Travis CI, per the configuration's branch whitelist option. The value will be inserted directly as an only clause. The default is /^build\/.*/.
only
/^build\/.*/
This more or less requires Git::CommitBuild to work. (Ordering is important, too. TravisYML comes before Git::CommitBuild.) You should change this to match up with the release_branch option, if your build branch is not going to reside in a build/* structure.
release_branch
build/*
Also, if you want to disable build branch testing, you can set this to 0.
0
This affects the notification options of the resulting YML file. It can either be set to:
0 = Disable email notification
1 = Enable email notification, using Travis CI's default email scheme
1
foo@bar.com (can be multiple; one per line) = Enable email notification to these email addresses
foo@bar.com
The default is 1.
0 = Disable IRC notification
1 = Enable IRC notification, using the IRC or x_irc meta resource value
IRC
x_irc
irc://irc.perl.org/#roomname (can be multiple; one per line) = Enable IRC notification to these IRC server/rooms
irc://irc.perl.org/#roomname
The default is 0. Please ask permission from the room channel operators before enabling bot notification.
Turning this on enables Minimum Version Dependency Testing. This will make your YML file less of a static file, as it will now include commands to forcefully downgrade your dependencies to the lowest version that your prereqs said they would be able to use.
While going through the MVDT process is recommended, it can be a royal pain-in-the-ass sometimes, so this option isn't on by default. It's HIGHLY recommended that you read the above doc first to get an idea of what you're diving into.
This applies to both YML files.
The project homepage is https://github.com/SineSwiper/Dist-Zilla-TravisCI/wiki.
The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see https://metacpan.org/module/Dist::Zilla::TravisCI/.
Brendan Byrd <BBYRD@CPAN.org>
This software is Copyright (c) 2013 by Brendan Byrd.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
To install Dist::Zilla::Role::TravisYML, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Role::TravisYML
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Role::TravisYML
For more information on module installation, please visit the detailed CPAN module installation guide.