summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authork clair <kclair@riseup.net>2012-08-07 11:19:32 -0700
committerkali <kali@leap.se>2012-08-08 20:12:34 +0900
commitbda0f214d13387e4efceb127f0a8bbb37935f98c (patch)
treea8cacdb479e9d8c7eb5e2da7d76b491535e1bac8
parentb1e025a343d0c6019127871acb47d7b295d342e9 (diff)
updated README
cherry-picked kclair updates on buildbot branch into develop branch.
-rw-r--r--README.txt51
1 files changed, 38 insertions, 13 deletions
diff --git a/README.txt b/README.txt
index bb6f082..510bda5 100644
--- a/README.txt
+++ b/README.txt
@@ -4,12 +4,34 @@
= your internet encryption toolkit =
========================================
+Installation
+=============
+
+Dependencies
+--------------
+
+* python <= 2.7
+* python setuptools
+* qt4 libraries
+* python-qt4
+* python-nose, python-mock, python-coverage (if you want to run tests)
+
+If you are on a debian-based system, you can run:
+
+apt-get install python-qt4 python-qt4-doc pyqt4-dev-tools python-setuptools python-nose
+
Install
-=======
+---------------
+
+If not using virtualenv:
+sudo python setup.py install
+
+If using virtualenv:
python setup.py install
-Running
-=======
+
+Running the App
+-----------------
You need to set up a provider in your eip.cfg file:
@@ -25,8 +47,11 @@ leap --debug
(or python app.py --debug if you run it from the src/leap folder).
+Development
+==============
+
Running tests
-=============
+-------------
./run_tests.sh
@@ -38,18 +63,14 @@ or
nosetests leap.util.test_leap_argparse
-Deps
-====
-
-apt-get install python-qt4 python-qt4-doc pyqt4-dev-tools
Test-deps
-=========
+---------
-test-requires
+have a look at setup/test-requires
Hack
-====
+--------------
(recommended)
virtualenv . # ensure your .gitignore knows about it
@@ -58,10 +79,14 @@ bin/activate
# you should probably simlink sip.so and PyQt4 to your system-wide
# install, there are some issues with it.
-python setup.py develop # ... TBD: finish develop howto.
+python setup.py develop
+
+# ... TBD: finish develop howto.
+# ... and explain how is python setup develop useful.
Compiling resource/ui files
-===========================
+-----------------------------
+
You should refresh resource/ui files every time you
change an image or a resource/ui (.ui / .qc). From
the root folder: