WebService::PivotalTracker - Perl library for the Pivotal Tracker REST API
version 0.11
my $pt = WebService::PivotalTracker->new( token => '...', ); my $story = $pt->story( story_id => 1234 ); my $me = $pt->me; for my $label ( $story->labels ) { } for my $comment ( $story->comments ) { }
This is fairly alpha software. The API is likely to change in breaking ways in the future.
This module provides a Perl interface to the REST API V5 for Pivotal Tracker. You will need to refer to the REST API docs for some details, as this documentation does not reproduce the details of every attribute available for a resource.
This class, WebService::PivotalTracker, provides the main entry point for all API calls.
WebService::PivotalTracker
All web requests which return anything other than a success status result in a call to die with a simple string error message. This will probably change to something more useful in the future.
die
This class provides the following methods:
This creates a new object of this class. It accepts the following arguments:
token
An MD5 access token for Pivotal Tracker.
This is required.
base_uri
The base URI against which all requests will be made. This defaults to https://www.pivotaltracker.com/services/v5.
https://www.pivotaltracker.com/services/v5
This method returns an array reference of WebService::PivotalTracker::Project objects, one for each project to which the token provides access.
This method accepts the following arguments:
story_id
The id of the project you are querying.
filter
A search filter. This is the same syntax as you would use in the PT application for searching. See https://www.pivotaltracker.com/help/articles/advanced_search/ for details.
This method returns a single WebService::PivotalTracker::Story object, if one exists for the given id.
The id of the story you are querying.
This creates a new story. This method accepts every attribute of a WebService::PivotalTracker::Story object. The project_id and name parameters are required.
project_id
name
It also accepts two additional optional parameters:
before_id
A story ID before which this story should be added.
after_id
A story ID after which this story should be added.
By default the story will be added as the last story in the icebox.
This looks up memberships in a project. It returns an array reference of WebService::PivotalTracker::ProjectMembership objects.
It is useful if you need to discover information about a person who is a member of your project.
The project_id parameter is required.
The sort_by parameter is optional.
sort_by
This returns a WebService::PivotalTracker::Me object for the user to which the token belongs.
Bugs may be submitted through https://github.com/maxmind/WebService-PivotalTracker/issues.
Dave Rolsky <autarch@urth.org>
Dave Rolsky <drolsky@maxmind.com>
Florian Ragwitz <rafl@debian.org>
Greg Oschwald <goschwald@maxmind.com>
Will Storey <will@summercat.com>
This software is Copyright (c) 2018 by MaxMind, Inc.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
To install WebService::PivotalTracker, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::PivotalTracker
CPAN shell
perl -MCPAN -e shell install WebService::PivotalTracker
For more information on module installation, please visit the detailed CPAN module installation guide.