'Pivotal Tracker' < https://www.pivotaltracker.com> is a project management software-as-a-service that provides a REST API. This package provides an R interface to that API, allowing you to query it and work with its responses.
While the basic methods for working with "stories", the main object of interest in Pivotal Tracker, are implemented, the package is very much a work in progress. If you find this useful and want to see more, please make an issue or (even better!) a pull request.
Install the package from CRAN with
The pre-release version of the package can be pulled from GitHub using the devtools package:
To access the Pivotal Tracker API, you'll need to get an API token, and then you'll need to provide the token and your project ID as "options". Set them in your current session with
or put that in your
.Rprofile for use in every session.
vignette("pivotaltrackR") for an overview.
Pagination of large responses is handled automatically: no need to make special requests to fetch all.
The repository includes a Makefile to facilitate some common tasks, if you're into that sort of thing.
$ make test. Requires the httptest package. You can also specify a specific test file or files to run by adding a "file=" argument, like
$ make test file=api.
test_package will do a regular-expression pattern match within the file names. See its documentation in the testthat package.
$ make doc. Requires the roxygen2 package.
getStories(). To deal with individual stories,