Skip to content

Latest commit

 

History

History
172 lines (106 loc) · 4.23 KB

README.rst

File metadata and controls

172 lines (106 loc) · 4.23 KB

Rapport: Work report generator for the lazy

https://travis-ci.org/saschpe/rapport.png?branch=master

Writing work reports is tedious. Some people have custom hacks. This is meant to be the last one. It's Apache-2.0 licensed and written in Python, not VimScript, not Bash, not Ruby, not C, ..., you probably got it ;-)

Features

  • Asynchronously collects data from various resources:
    • Bugzilla
    • Gerrit
    • Github
    • Launchpad
    • MediaWiki
    • OpenBuildService
    • Trello
    • Twitter
  • Supports plugins for extendability
  • Simple ini-style config file
  • (Almost) comprehensive unit and functional testsuite
  • Supports creating work reports for arbitrary timeframes and provides some convenient ones:
    • Current week / month
    • Recent days
    • Week / month of of year
    • Generic

Installation

To install rapport from the Python Package Index, simply:

$ pip install rapport

Or, if you absolutely must:

$ easy_install rapport

But, you really shouldn't do that. Lastly, you can check your distro of choice if they provide packages. For openSUSE, you can find packages in the Open Build Service for all releases. If you happen to use openSUSE:Factory (the rolling release / development version), simply:

$ sudo zypper install rapport

Usage

Rapport allows to query various upstream resources for modifications you made. So before creating your first work report, you should check rapport's config file and add your credentials to the resources you are interested in.

By default, rapport creates a work report for the current weak, so from Monday until now (And yes, i18n and i10n are on the TODO list). You can also set the timeframe to consider explicitly. For instance, you could generate a work report for the last 10 days:

$ rapport create --recent-days 10

Check the help of the create command for other options:

$ rapport create --help

You can show a list of all previous work reports:

$ rapport list

And display details for a specific work report:

$ rapport show 2013-05-21T09:27:43

Or display the latest work report by:

$ rapport show

If you need further assistance, check rapport's help:

$ rapport help

Hacking and contributing

You can test rapport from your git checkout by executing the rapport.cli module:

$ python -m rapport.cli

Alternatively, you can invoke the convenience script wrapper:

$ ./scripts/rapport

Fork the repository on Github to start making your changes to the master branch (or branch off of it). Don't forget to write a test for fixed issues or implemented features whenever appropriate. You can invoke the testsuite from the repository root directory via:

$ python setup.py test

Or by running nose directly:

$ nosetests

Both assume you have the test dependencies installed (available on PYTHONPATH) on your system. If that doesn't work for you, you can create a virtual environment instead:

$ virtualenv .venv
$ source .venv/bin/activate
(.venv)$ pip install -r test-requirements.txt
(.venv)$ nosetests

Lastly, if using virtualenv is too tedious or you want to test different configurations (py26, py27, py33, pep8), you can also use tox:

$ tox