view README @ 315:8f89fd351225

Not necessary to select project when the project is stopped For me this statement is completely wrong. Nevertheless it also has no effect either. Therefore its save to remove it.
author Björn Ricks <bjoern.ricks@intevation.de>
date Fri, 11 Oct 2013 12:14:25 +0200
parents a69126bb29e6
children a3d1fc6c0153
line wrap: on
line source
Installation
============

Getan requires `urwid <http://excess.org/urwid>`_ in a version >= 1.0. Urwid is
a console user interface library written is python.

Install urwid
-------------

On Debian GNU/Linux >= Wheezy just run as root:::

    $ apt-get install python-urwid

On other systems urwid may be installed via pip or directly put into the sources
of getan.

Using pip
^^^^^^^^^

To install urwid via pip run as root::

    $ pip install urwid

Or if you prefer using a virtualenv::

    $ virtuelenv getan-env
    $ source getan-env/bin/activate
    (getan-env)$ pip install urwid

Using urwid sources
^^^^^^^^^^^^^^^^^^^

Urwid can be put as source to the getan directory when getan is run directly
from the sources. Urwid source can be downloaded from `pypi
<https://pypi.python.org/pypi/urwid/>`_ or from the `urwid website
<http://excess.org/urwid/>`_.

For urwid 1.1.1 the direct download link from pypi is
`<https://pypi.python.org/packages/source/u/urwid/urwid-1.1.1.tar.gz>`_ (md5sum
should be 932d199de6fc847eab2c151512220665).::

    $ cd getan-source
    $ wget https://pypi.python.org/packages/source/u/urwid/urwid-1.1.1.tar.gz
    $ md5sum urwid-1.1.1.tar.gz
    $ tar xzvf urwid-1.1.1.tar.gz
    $ ln -s urwid-1.1.1/urwid urwid

Install getan
-------------

A installation of getan is not required. It can also be run directly from the
sources. To install getan system wide the following command must be run as root
user::

    $ python setup.py install

Starting getan
==============

Getan can be directly run from sources or after a system wide installation from
the bin dir (e.g. /usr/bin).

Running from Sources
--------------------

To run getan from the sources run::

    $ ./getan.py

or::

    $ ./getan.py /path/to/mytime.db

to choose a different sqlite3 database the the defautl time.db

The classic version of 'getan' which is based on curses can be run with::

    $ classic/getan

or::

    $ classic/getan /path/to/mytime.db

Running from installation
-------------------------

After installing getan it can be run with::

    $ getan

or::

    $ getan /path/to/mytime.db

The classic version of 'getan' is also available::

    $ getan-classic

or::

    $ getan-classic /path/to/mytime.db
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)