summaryrefslogtreecommitdiff
path: root/README.rst
diff options
context:
space:
mode:
authorkali <kali@leap.se>2013-01-30 06:52:59 +0900
committerkali <kali@leap.se>2013-01-30 06:52:59 +0900
commit570f84756b3d1f689a172a3ff0c55abf6a60b9dd (patch)
tree0f262acacf35743664c6408edbafe6ba6f119d14 /README.rst
parente60abdcb796ad9e2c44e9b37d3a68e7f159c035c (diff)
parent10a2303fe2d21999bce56940daecb78576f5b741 (diff)
Merge branch 'pre-release-0.2.0' into release-0.2.0
This merge contains today's state of develop branch, minus soledad and email components.
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst178
1 files changed, 63 insertions, 115 deletions
diff --git a/README.rst b/README.rst
index d1f91c4b..9ef3f99b 100644
--- a/README.rst
+++ b/README.rst
@@ -4,169 +4,117 @@ The LEAP Encryption Access Project Client
*your internet encryption toolkit*
-Installation
-=============
-
-Base Dependencies
-------------------
-Leap client depends on these libraries:
-
-* python 2.6 or 2.7
-* qt4 libraries (see installing Qt section below)
-* libgnutls
-* openvpn
-
-Python packages are listed in ``pkg/requirements.pip`` and ``pkg/test-requirements.pip``
-
-Debian systems
---------------
-
-* python-qt4
-* python-gnutls == 1.1.9
-* python-keyring
-* python-crypto
-* python setuptools
-* python-nose, python-mock, python-coverage (if you want to run tests)
-
-Under a debian-based system, you can run::
-
- # apt-get install openvpn python-qt4 python-keyring python-crypto
-
-For testing:
-
- python-nose python-mock python-coverage
+Read the docs!
+==============
-For _building_ the package you will need to install also::
+You can read the documentation online at `http://leap-client.readthedocs.org <http://leap-client.readthedocs.org/en/latest/>`_. If you prefer to build it locally, run::
- pyqt4-dev-tools libgnutls-dev python-setuptools python-all-dev
+ $ cd docs
+ $ make html
+Quick Start
+==============
-Install python dependencies with pip
--------------------------------------
-Use pip (preferrable inside a virtualenv) to install all the required python packages::
+At the current development stage we still do not have any versioned release. Instead, you might want to have a look at the `testers guide <http://leap-client.readthedocs.org/en/latest/testers/howto.html>`_ for a quick howto on fetching and testing latest development code.
- # apt-get install python-pip python-dev libgnutls-dev
- % pip install -r pkg/requirements.pip
+Dependencies
+------------------
+LEAP Client depends on these libraries:
-Install leap-client
--------------------
+* ``python 2.6`` or ``2.7``
+* ``qt4 libraries``
+* ``libgnutls``
+* ``openvpn``
-After getting the source and installing all the dependencies, proceed to install ``leap-client`` package:
+Python packages are listed in ``pkg/requirements.pip`` and ``pkg/test-requirements.pip``
-# need to run this if you are installing from the git source tree
-# not needed if installing from a tarball::
+Debian
+^^^^^^
- python setup.py branding
+Under a debian-based system, you can run::
-# run this if you have installed previous versions before::
+ $ apt-get install openvpn python-qt4 python-crypto python-requests python-gnutls
- python setup.py clean
+For *testing*::
-And finally, build and install leap-client::
+ $ apt-get install python-nose python-mock python-coverage
- python setup.py install # as root if installing globally.
+For *building* the package you will need to install also::
+ $ apt-get install pyqt4-dev-tools libgnutls-dev python-setuptools python-all-dev
-Running the App
------------------
-If you're running a branded build, the script name will have a infix that
-depends on your build flavor. Look for it in ``/usr/local/bin``::
+pip
+^^^
- % leap-springbok-client
+Use pip to install the required python packages::
-In order to run the client in debug mode::
+ $ apt-get install python-pip python-dev libgnutls-dev
+ $ pip install -r pkg/requirements.pip
- % leap-springbok-client --debug --logfile /tmp/leap.log
-To see all the available command line options::
+Installing
+-----------
- % leap-springbok-client --help
+After getting the source and installing all the dependencies, proceed to install ``leap-client`` package::
+ $ python setup.py install
-Development
-==============
-Troubleshooting PyQt install inside a virtualenv
-------------------------------------------------
-If you attempt to install PyQt inside a virtualenv using pip, it will fail because PyQt4 does not use the standard setup.py mechanism.
+Running
+-------
-As a workaround, you can:
+After a successful installation, there should be a launcher called ``leap-client`` somewhere in your path::
- * run pkg/postmkvenv.sh after creating your virtualenv. It will symlink to your global PyQt installation _(recommended)_.
- * install PyQt globally and make a virtualenv with --site-packages
+ $ leap-client
-Or, if you prefer, you can download the official PyQt tarball and execute `configure.py` in the root folder of their distribution, which generates a Makefile::
- python configure.py
- make && make install
+Hacking
+=======
+See the `hackers guide <http://leap-client.readthedocs.org/en/latest/dev/environment.html>`_.
-Hack
---------------
+The LEAP client git repository is available at::
-The LEAP client git repository is available at:
-git://leap.se/leap_client
+ git://leap.se/leap_client
Some steps need to be run when setting a development environment for the first time.
-# recommended: enable a **virtualenv** to isolate your libraries::
-
- % virtualenv . # ensure your .gitignore knows about it
- % source bin/activate
-
-# make sure you are in the development branch::
-
- (leap_client)% git checkout develop
- (leap_client)% pkg/postmkvenv.sh
- (leap_client)% python setup.py branding
- (leap_client)% python setup.py develop
-
-to avoid messing with the entry point and global versions installed,
-it's recommended to run the app like this during development cycle::
-
- (leap_client)% cd src/leap
- (leap_client)% python app.py --debug
+Enable a **virtualenv** to isolate your libraries. (Current *.gitignore* knows about a virtualenv in the root tree. If you do not like that place, just change ``.`` for *<path.to.environment>*)::
-Install testing dependencies
-----------------------------
+ $ virtualenv .
+ $ source bin/activate
-have a look at ``pkg/test-requirements.pip``
-The ./run_tests.sh command should install all of them in your virtualenv for you.
+Make sure you are in the development branch::
-Running tests
--------------
+ (leap_client)$ git checkout develop
-There is a convenience script at ``./run_tests.sh``
+Symlink your global pyqt libraries::
-If you want to run specific tests, pass the (sub)module to nose::
- nosetests leap.util
+ (leap_client)$ pkg/postmkvenv.sh
-or::
- nosetests leap.util.tests.test_leap_argparse
+And make your working tree available to your pythonpath::
-Hint: colorized output
-----------------------
-Install ``rednose`` locally and activate it, and give your eyes a rest :)::
+ (leap_client)$ python setup.py develop
- (leap_client)% pip install rednose
- (leap_client)% export NOSE_REDNOSE=1
+Testing
+=======
-Tox
----
-For running testsuite against all the supported python versions (currently 2.6 and 2.7), run::
+Have a look at ``pkg/test-requirements.pip`` for the tests dependencies.
- % tox -v
+To run the test suite::
+ $ ./run_tests.sh
+
+which the first time should automagically install all the needed dependencies in your virtualenv for you.
-Compiling resource/ui files
------------------------------
+License
+=======
-You should refresh resource/ui files every time you change an image or a resource/ui (.ui / .qc). From the root folder::
+.. image:: https://raw.github.com/leapcode/leap_client/develop/docs/user/gpl.png
- % make ui
- % make resources
+The LEAP Client is released under the terms of the `GNU GPL version 3`_ or later.
-As there are some tests to guard against unwanted resource updates, you will have to update the resource hash in those failing tests.
+.. _`GNU GPL version 3`: http://www.gnu.org/licenses/gpl.txt