Project

pivotal_to_pdf

0.03
No commit activity in last 3 years
No release in over 3 years
pivotal_to_pdfywen/pivotal_to_pdfHomepageDocumentationSource CodeBug TrackerWiki
Convert Pivotal Tracker Stories to 4x6 PDF for printing so that you can stick the card to your story board
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
73,160
Stars
34
Forks
18
Watchers
2
 Releases
Current version
1.6.0
Total releases
23
First release
2010-11-24
Latest release
2015-05-29
 Issues
Open Issues
2
Closed Issues
13
Total Issues
15
Issue Closure Rate
86%
 Pull Requests
Open Pull Requests
2
Closed Pull Requests
2
Merged Pull Requests
8
Pull Request Acceptance Rate
66%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2013-03-15
Reverse Dependencies
0

 Dependencies

Development

rspec
>= 0

Runtime

activeresource
= 3.0.9
pivotal_to_pdf-formatters
>= 0.0.4
prawn
= 0.12.0
thor
>= 0
 Project Readme

pivotal_to_pdf -- print the stories from pivotal tracker to a PDF file

Build Status Code Quality

DESCRIPTION

This is a gem that can read a story from pivotal tracker and print into a 4x6 card so that you can print the card and stick to your physical story board.

I steal the part of code from http://ephemera.karmi.cz/post/622136360/create-printable-pdf-cards-for-your-pivotal-tracker-stor The difference is the code there print to a A4 paper with 4 stories on it. This gem prints one card at a time and the gem doesn't require an exported csv file.

INSTALL

$ [sudo] gem install pivotal_to_pdf

USAGE

First you need to create a .pivotal.yml under your home directory. On windows, have this file in %HOME%.pivotal.yml

a sample .pivotal.yml:

token: your-api-token-of-pivotal-tracker
project_id: your-ptroject-id
formatter: PivotalToPdf::Formatters::Default

The meaning of the formatter key will be explained in the next section

After install the gem, you can do:

  • pivotal_to_pdf current_iteration # print stories for the current iteration into a PDF file

  • pivotal_to_pdf story STORY_ID, additional_story_ids # print stories specifed by IDs into a PDF file

  • pivotal_to_pdf iteration ITERATION_NUMBER # print a single iteration specifed by the number into a PDF file

  • pivotal_to_pdf label LABEL_TEXT # print stories matching the specified label into a PDF file

Examples:

pivotal_to_pdf story 159898

pivotal_to_pdf story 159898 159987

pivotal_to_pdf current_iteration

pivotal_to_pdf iteration 42

pivotal_to_pdf label print-these

Type in

pivotal_to_pdf help

pivotal_to_pdf help <command>

for more usage information

The gem will then read the story/stories and print it into a PDF file

The points section will be printed only for features. Bugs and Chores don't have points

Printed a green bounding box for feature, a yellow box for chores and a red box for bugs

The gem assumes that you have https access to the pivotal tracker

Formatters

From the version 1.3.0, The gem supports alternative formatter other than the default one. In the .pivotal.yml file, if you define a key like

formatter: PivotalToPdf::Formatters:MyPrettyHtmlWriter

The gem will use PivotalToPdf::Formatters::MyPrettyHtmlWriter to generate the output.

This feature is associated to the issue #14. I basically rewrite the code to implement this myself.

The actual formatters live in a seperate gem so that only that gem needs to be updated when needed. Once that gem is updated, you can do:

$ gem update pivotal_to_pdf-formatters

to use the new formatters being added

##Contributors