.. _install:

Installation
============

From source
-----------

``turses`` is evolving fast, you can find the `latest version on GitHub
<https://github.com/alejandrogomez/turses>`_.

You can either clone the public repository::

    $ git clone git://github.com/alejandrogomez/turses.git

Download the `tarball <https://github.com/alejandrogomez/turses/tarball/master>`_::

    $ curl -OL https://github.com/alejandrogomez/turses/tarball/master

Or, download the `zipball <https://github.com/alejandrogomez/turses/zipball/master>`_::

    $ curl -OL https://github.com/alejandrogomez/turses/zipball/master


Once you have a copy of the source, you can embed it in your Python package,
or install it into your site-packages easily::

    $ python setup.py install


Distribute & pip
----------------

Installing is simple with `pip <http://www.pip-installer.org/>`_::

    $ pip install turses

or (but `you should consider using pip
<http://www.pip-installer.org/en/latest/other-tools.html#pip-compared-to-easy-install>`_):  ::

    $ easy_install turses
