SYNOPSIS

use Net::Bamboo;

# basics

my $bamboo = new Net::Bamboo;

$bamboo->hostname('bamboo.domain.com'); # hostname of bamboo server
$bamboo->username('myuser');            # bamboo username
$bamboo->password('mypass');            # bamboo password
$bamboo->debug($bool);                  # debug mode (dump HTTP/XML)

# projects

$bamboo->projects;      # array of Net::Bamboo::Project
$bamboo->num_projects;  # number of projects
$bamboo->project_keys;  # list of project keys
$bamboo->project($key); # get project by bamboo key

my $project = $bamboo->project($key);

$project->key;  # project key
$project->name; # project name

# plans

$project->plans;        # list of Net::Bamboo::Plan objects
$project->num_plans;    # number of plans
$project->plan_keys;    # list of plan keys
$project->plan($key);   # get plan by bamboo key

my $plan = $bamboo->plan($key);

$plan->key;             # plan key
$plan->name;            # plan name
$plan->num_stages;      # number of stages in plan
$plan->is_enabled;      # flag: is plan enabled
$plan->is_building;     # flag: is plan currently building
$plan->is_active;       # flag: is plan active
$plan->fqkey;           # fully qualified key (project key + plan key)

# builds

$plan->builds;          # list of Net::Bamboo::Build objects (five most recent)
$plan->build_numbers;   # list of build numbers
$plan->build($num);     # get build by number
$plan->latest_build;    # get most recent build

my $build = $plan->build($num);

$build->number;         # build number
$build->reason;         # build reason
$build->date_started;   # build start date/time (DateTime object)
$build->date_completed; # build end date/time (DateTime object)
$build->duration;       # build duration (DateTime::Duration object)
$build->succeeded;      # flag: build success?
$build->failed;         # flag: build failure?
$build->num_tests_ok;   # number of successful unit tests
$build->num_tests_fail; # number of failed unit tests

DESCRIPTION

Net::Bamboo is a simple OO interface to the RESTy interface exposed by Atlassian's Bamboo tool for continuous integration. The implementation is functionally lazy for the most part. Projects and plans are pulled in a single bulk request while the builds are pulled per plan as they are needed. Builds cycle often, so there exists a Plan->refresh method you may use to clear the attribute storing the builds; this will cause Net::Bamboo::Plan to pull a new build the next time it's requested. A similar method is available for the Net::Bamboo object as well, though it's likely to be used much less often.

This is a rough first cut. Pull requests against my github repository are more than welcome.

AUTHOR

Mike Eldridge <diz@cpan.org>