=begin html

<a href="https://travis-ci.org/ivanwills/VCS-Which"><img src="https://travis-ci.org/ivanwills/VCS-Which.png" alt="VCS-Which"></a>
<a href="https://coveralls.io/r/ivanwills/VCS-Which?branch=master"><img src="https://coveralls.io/repos/ivanwills/VCS-Which/badge.svg?branch=master" alt="Coverage Status" /></a>

=head1 App-JenkinsCli

This module provide the C<jenkins-cli> command to allow interactions with a
Jenkins server via the command line.

=head1 INSTALLATION

To install this module, run the following commands:

   # from CPAN
   # with cpanm client (https://cpanmin.us/)
   cpanm [--sudo] App::JenkinsCli
   # with cpan client
   cpan App::JenkinsCli

   # from source
   perl Build.PL
   ./Build
   ./Build test
   ./Build install

=head1 SYNOPSIS

  jenkins-cli [option] command

OPTIONS:
 -b --base-url[=]str
               The base url of the Jenkins instance to talk to
 -U --username[=]str
               The username to interact with Jenkins
 -P --password[=]str
               The passowrd of --username

 -v --verbose  Show more detailed option
    --version  Prints the version information
    --help     Prints this help information
    --man      Prints the full documentation for jenkins-cli

COMMANDS:
 ls|list [search]
               List jenkins jobs
 start job     Start the Jenkins job "job"
 stop job      Stop a Jenkins job (not yet implemented)
 tail job      Tail a jenkins job (not yet implemented)
 disable job   Diable a job
 enable job    Enable a job
 wipe job      Wipeout workspace for job (not yet implemented)
 queue         Show the current job build queue
 history job   Show a jobs build history (not yet implemented)
 config job    Show a config for a job
 create job config.xml
               Create a new job from "config.xml"

=head1 CONFIGURATION

You can save your configuration into C<~/.jenkins-cli.yml> so that you don't
have to enter them each time. The following is an example of what the file
looks like:

 ---
 base_url: http://localhost:8080/
 username: admin
 password: my-secrent-password

=head1 SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

   perldoc App::JenkinsCli

You can also look for information at:

   RT, CPAN's request tracker
       http://rt.cpan.org/NoAuth/Bugs.html?Dist=App-JenkinsCli

   AnnoCPAN, Annotated CPAN documentation
       http://annocpan.org/dist/App-JenkinsCli

   CPAN Ratings
       http://cpanratings.perl.org/d/App-JenkinsCli

   Search CPAN
       http://search.cpan.org/dist/App-JenkinsCli/

   Source Code
       git://github.com/ivanwills/App-jenkins-cli.git

=head1 COPYRIGHT AND LICENCE

Copyright (C) 2016 Ivan Wills

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

=cut