This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

# JIRA-CARDS

JiraCards prints agile cards for your physical board from Jira. The issues are read from a Jira Agile Board or individual issues can be provided to create single cards.

## Overview

JiraCards makes it super easy to generate physical cards from digital Jira issues. By default it fetches Jira issues from a given Jira Agile Board and generates for every found issue on the board a physical card. The generated cards are written to a HTML file. This HTML file can be used to print the cards.

The cards produced are clear and readable and a custom template can be provided to easily create custom looking cards.

JiraCards uses the Jira REST API to get all the relevant data from Jira. You can provide a username and password for authentication. BasicAuth is used for authentication.

On an A4 page 6 cards are rendered. The cards can then be easily guillotined out and used on your physical board.

## Installation

### Using pip

To install JiraCards:

$ sudo pip install jira-cards

### From source

First, get the latest source code:

$ git clone https://github.com/hypebeast/JiraCards.git

Install it:

$ cd JiraCards $ python setup.py install

### Setup a development environment

First, get the latest source code:

$ git clone https://github.com/hypebeast/JiraCards.git

Install dependencies:

$ cd JiraCards $ make env

Run JiraCards:

$ python jiracards/jira-cards.py -h

## Configuration

JiraCards reads the configuration from the following place:

$ ~/.jira-cards/config

The configuration file is created during the first startup of JiraCards. If you want to create the config file with the default options just execute the program:

$ jira-cards -h

### Use another config file

If you want to use a different configuration file, you can call JiraCards with –config option:

$ jira-cards –config my_config

### Configuration Options

The following options are available:

  • jira: The URL of your Jira instance.
  • user: The username you want to use for authentication.
  • password: The password you want to use for authentication.
  • output: The name of the output file for the generated cards.
  • board: The Jira Board ID where to get the issues from.
  • template: The filename of the custom template. If no template is provided, the default template is used.
  • default_issue_color: The default color for a issue.
  • issueTypes: The available issue types. It’s possible to provide a custom color for every specified issue type. The list is comma sperated.
  • color_: The color for an issue type. For example, if you specify an ‘Blocker’ as an issue type, you can add an ‘color_blocker’ option to the config file: color_blocker = #FF0000. The following replacements in issue type names are carried out (see the default config for examples): * Whitespaces are converted to _. * - are converted to _

## Usage

To list all available commands and options:

$ jira-cards -h

If you want to generate cards from your JIRA Agile Board with ID 19, execute the following command:

$ jira-cards -j http://jira.example.com -u username -p password -b 19 -o cards.html

### Available Commands

For an overview about all commands run JiraCards with the help options:

$ jira-cards -h

The following commands are available:

  • gen: This the default command. If JiraCards is called without a command this command will be executed. It reads Jira issues from the specified board and generates a card for every found issue.
  • show: Prints the default template to stdout. The default template can be used to create a custom template.
  • tempdata: Prints the available data which is available in a template.

### Command Line Options

For an overview about all commands run JiraCards with the help options:

$ jira-cards -h

The following options are available:

  • -j, –jira: The URL of your Jira instance.
  • -u, –user: The username you want to use for authentication.
  • -p, –password: The password you want to use for authentication.
  • -o, –output: The name of the output file for the generated cards.
  • -b, –board: The Jira Board ID where to get the issues from.
  • -t, –template: The filename of the custom template. If no template is provided, the default template is used.
  • -c, –config: The config filename.

## Custom Template

It’s possible to create a custom template in order to create different looking cards. To provide a custom template use the following command:

$ jira-cards -t my_template.html

### Available Template Data

The avialable template data can be printed with the following command:

$ jira-cards tempdata
Release History

Release History

0.2.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
jira-cards-0.2.0.tar.gz (9.2 kB) Copy SHA256 Checksum SHA256 Source Jun 14, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting