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>