Source / README

``_ is a `python`_ package written in pure Python code.
It is a lightweight security library that provides integration with:

* `pycrypto`_ - The Python Cryptography Toolkit

It is optimized for performance, well tested and documented.


* `source code`_, `examples`_ and `issues`_ tracker are available
  on `bitbucket`_
* `documentation`_, `readthedocs`_
* `eggs`_ on `pypi`_


``_ requires `python`_ version 2.4 to 2.7 or 3.2.
It is independent of operating system. You can install it from `pypi`_
site using `setuptools`_::

    $ easy_install

If you are using `virtualenv`_::

    $ virtualenv env
    $ env/bin/easy_install

If you would like take benefit of one of cryptography library that has
built-in support specify extra requirements::

    $ easy_install[pycrypto]


You can get the `source code`_ using `mercurial`_::

    $ hg clone
    $ cd

Prepare `virtualenv`_ environment in *env* directory ::

    $ make env

... and run all tests::

    $ make test

You can read how to compile from source code different versions of
`python`_ in the `article`_ published on `mind reference`_ blog.

You can run certain make targets with specific python version. Here
we are going to run `doctest`_ with python3.2::

    $ make env doctest-cover VERSION=3.2

Generate documentation with `sphinx`_::

	$ make doc

If you run into any issue or have comments, go ahead and add on

.. _`article`:
.. _`bitbucket`:
.. _`doctest`:
.. _`documentation`:
.. _`eggs`:
.. _`examples`:
.. _`issues`:
.. _`mercurial`:
.. _`mind reference`:
.. _`pycrypto`:
.. _`pypi`:
.. _`python`:
.. _`readthedocs`:
.. _`setuptools`:
.. _`source code`:
.. _`sphinx`:
.. _`virtualenv`:
.. _``: