lissues, un cliente sencillo para redmine
=========================================

lissues es un cliente de consola para el sistema
de tickets "redmine".

Instalación
-----------

Dentro del directorio de repositorios puedes ejecutar
el comando::

    sudo python setup.py develop

o bien, desde cualquier lugar::

    sudo pip install lissues


Configuración
-------------

Antes de comenzar, ejecuta el comando ``li -e`` para
que se abra un editor de texto y puedas configurar el
acceso a redmine.

Recuerda que tienes que tener una cuenta en redmine, permisos
para alterar los proyectos y tener habilitado el soporte REST desde
las propiedades de redmine.

Uso básico
----------

Para listar los proyectos puedes usar el siguiente comando::

    li -p

tendría que aparecer un asterisco a la izquierda del proyecto
en el que estás trabajando, si no es así, tendrías que ejecutar
nuevamente el comando ``li -e`` para configurarlo.

Luego, para listar todos los bugs del proyecto seleccionado tienes
que ejecutar el siguiente comando::

    li -i

Creación de issues
------------------

Para crear un issue necesitas definir un asunto y una descripción.

La forma general del comando es::

    li -c "asunto" "descripcion"

Por ejemplo, para crear un issue reportando un error de acceso en
un sitio web podríamos invocar al siguiente comando::

    li -c "error de acceso al panel de administracion" "el servidor está ..."

y lo que obtendríamos como resultado::

    Bug #23: 'error de acceso al panel de administracion' creado dentro del proyecto 'ejemplo'

Es decir, aparecerá en pantalla el número de issue asignado al 


Creación masiva de issues
-------------------------

Para agilizar la carga de bugs, también existe un comando para
realizar importaciones masivas desde un archivo csv.

La forma general del comando es::

    li -b archivo.csv

y el archivo debe tener dos columnas, una con el asunto del issue
y la otra con la descripción del mismo.

Por ejemplo::

    titulo; descripción sobre un determinado issue
    bug2; una descripción sobre el segundo bug
