roundup-cli
===========

roundup-cli is a simple command line interface for the `Roundup Issue Tracker`_.
It uses the XML-RPC interface to communicate with Roundup.

Configuration
-------------

roundup-cli will look for a configuration file in this order `roundup.cf`,
`~/.roundup.cfg`. The format is based on `configparser`_.

A section describe parameters for a roundup instance. `url`, `username` and
`password` are required entries like this::

    [foo]
    url = http://localhost:8000/roundup
    username = foo
    password = bar

Any other entries will be used to display the corresponding roundup class. It
must be a comma separated list of field names, the first field will be used for
short display::

    issue = title,priority,status,superseder,nosy,assignedto,keyword
    user = username,realname,organisation,address
    msg = author,date,content


Nutshell
--------

Here a simple scenario::

    $ roundup-cli
    None: use foo
    demo: get issue1
     title: Add issue creation to roundup-cli
     priority: feature
     status: in-progress
     superseder:
     nosy: admin,demo
     assignedto: admin
     keyword:
    issue1@demo: show messages
     messages:
    -------------------------------------------------------------------------------
     msg1
     author: demo
     date: <Date 2011-11-25.20:58:30.768>
     content: It will be great to create issue from roundup-cli
    -------------------------------------------------------------------------------
     msg2
     author: admin
     date: <Date 2011-11-25.20:59:06.176>
     content: Agree, I start working on it.
    -------------------------------------------------------------------------------
    issue1@demo: search issue status:in-progress
     issue1: Add issue creation to roundup-cli


For more information please visit the `roundup-cli website`_.

.. _Roundup Issue Tracker: http://www.roundup-tracker.org/
.. _configparser: http://docs.python.org/library/configparser.html
.. _roundup-cli website: http://code.google.com/p/roundup-cli/
