Skip to main content

Convert your GitHub issues into printable cards for your physical Scrum/Kanban board.

Project description

GitHub Cards

PyPI Travis Documentation Status

Convert your GitHub issues into printable cards for your physical Scrum board.

Features

This tool creates a printable HTML-file containing the issues of a GitHub repository. You can print the file, cut the cards and attach them to your physical Scrum/Kanban board.

To use it, run

# github_cards REPOSITORY_OWNER REPOSITORY_NAME
>> github_cards pallets click

There are some options available, e.g. to access private repositories or only select a certain milestone.

>> github_cards --help

Usage: github_cards [OPTIONS] OWNER REPOSITORY

  Console script for github_cards.

Options:
  -u, --username TEXT            Username to perform authenticated requests
                                 with. If provided, the script will request
                                 the password.
  -p, --password TEXT            Password for the username provided. If the
                                 username is set but the password is not
                                 provided, script will request it.
  -m, --milestone-title TEXT     Limit selected issues to a milestone by the
                                 milestone's title. It will search the
                                 repository for that milestone and error if
                                 it's not available.
  -m#, --milestone-number TEXT   Limit selected issue to a milestone by the
                                 milestone's number (similarly to issue
                                 numbers). Will be overwritten by the
                                 milestone title if set.
  -s, --state [all|open|closed]  Limit to all, open or closed issues. Defaults
                                 to open
  -pr, --per-row INTEGER         Number of cards per row
  -pc, --per-column INTEGER      Number of cards per column
  -o, --output PATH              HTML filename to output to. Defaults to a
                                 value containing the repository title and the
                                 current time.
  --help                         Show this message and exit.                     Show this message and exit.

ToDo

  • Unspaghettify
  • Error handling
  • Add some tests
  • Add documentation
  • Caching of already covered cards
  • User provided templates
  • Authentication
  • List milestones

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.0 (2018-11-25)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

github_cards-0.1.14.tar.gz (11.3 kB view hashes)

Uploaded Source

Built Distribution

github_cards-0.1.14-py2.py3-none-any.whl (7.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page