Description
A Pivotal Tracker API gem that can be used to interface with the Pivotal Tracker API v5.
pivotal-tracker-api alternatives and similar gems
Based on the "Third-party APIs" category.
Alternatively, view pivotal-tracker-api alternatives based on common mentions on social networks and blogs.
-
ruby-gmail
A Rubyesque interface to Gmail. Connect to Gmail via IMAP and manipulate emails and labels. Send email with your Gmail account via SMTP. Includes full support for parsing and generating MIME messages. -
itunes_store_transporter
Upload and manage your assets in the iTunes Store using the iTunes Store’s Transporter (iTMSTransporter).
WorkOS - The modern identity platform for B2B SaaS
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of pivotal-tracker-api or a related project?
README
pivotal-tracker-api
A Pivotal Tracker API gem that can be used to interface with the Pivotal Tracker API v5.
Basic Example
# Use your personal pivotal token
PivotalAPI::Service.set_token A_PIVOTAL_TOKEN
# Authenticate a user using email / pass
@me = PivotalAPI::Me.retrieve('USERNAME', 'PASSWORD')
# Note: PivotalAPI::Me.retrieve will automatically set the api token so there is no need to use PivotalAPI::Service.set_token if you use PivotalAPI::Me.retrieve to login
# If you login using PivotalAPI::Me.retrieve, you can simply ask your Me object for your projects.
@projects = @me.projects
# If you set your personal pivotal token manually using PivotalAPI::Service.set_token, you can get your projects using the following.
@projects = PivotalAPI::Projects.retrieve()
# To get a specific project, use the following.
@project = PivotalAPI::Project.retrieve(PROJECT_ID)
# Get a project's stories, this will return an array of PivotalAPI::Story instance's
@stories = @project.stories
# Get a specific story for a project, this will return a PivotalAPI::Story instance
@story = @project.story(STORY_ID)
# Get a story's comments, this will return an array of PivotalAPI::Comment instance's
@comments = @story.comments
# Get a story's owners, this will return an array of PivotalAPI::Person instance's
@owners = @story.owners
# Get a story's followers, this will return an array of PivotalAPI::Person instance's
@followers = @story.followers
# Get a story's tasks, this will return an array of PivotalAPI::Task instance's
@tasks = @story.tasks
# Get a story's transitions, this will return an array of PivotalAPI::StoryTransition instance's
@transitions = @story.transitions
# Get a story's cycle time details, this will return ana array of PivotalAPI::CycleTimeDetails instance's
@cycle_time_details = @story.cycle_time_details
# Get a project's activity, this will return an array of PivotalAPI::Activity instance's
@stories = @project.activity
# Get a project's iterations, this will return an array of PivotalAPI::Iteration instance's
@iterations = @project.iterations
# Get a project's current iteration
@iteration = @project.current_iteration
# Get a project's next iteration
@iteration = @project.next_iteration
# Get a project's previous iteration
@iteration = @project.previous_iteration
For additional infomation on how to interface with this gem and use it to communicate with the Pivotal Tracker API v5 see the PivotalAPI::Service class and the Service Tests.
Contributing to pivotal-tracker-api
- Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
- Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
- Fork the project.
- Start a feature/bugfix branch.
- Commit and push until you are happy with your contribution.
- Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
- Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
Copyright
Copyright (c) 2013 Jeremy Fox (jeremyfox.me). See LICENSE.txt for further details.
*Note that all licence references and agreements mentioned in the pivotal-tracker-api README section above
are relevant to that project's source code only.