summaryrefslogtreecommitdiff
path: root/README.txt
diff options
context:
space:
mode:
authorkali <kali@leap.se>2012-09-07 05:20:41 +0900
committerkali <kali@leap.se>2012-09-07 05:20:41 +0900
commit5006fda226a3fa6afda231df8aa733477bd4e420 (patch)
tree78004630c5eaa909c488d88ac68a46e999bb242d /README.txt
parentc6ec834446cd6772ff900a0637c7296746f53320 (diff)
update README with tox info and PyQt annoyances
Diffstat (limited to 'README.txt')
-rw-r--r--README.txt36
1 files changed, 20 insertions, 16 deletions
diff --git a/README.txt b/README.txt
index a7c03f80..28971255 100644
--- a/README.txt
+++ b/README.txt
@@ -23,27 +23,31 @@ apt-get install python-qt4 python-qt4-doc pyqt4-dev-tools python-setuptools pyth
Install
---------------
-If not using virtualenv:
+Global install:
sudo python setup.py install
If using virtualenv:
python setup.py install
+Install PyQt
+------------
+pip install PyQt will fail because PyQt4 does not use the standard setup.py mechanism.
+Instead, they use configure.py which generates a Makefile.
-Running the App
------------------
+python configure.py
+make && make install
-You need to set up a provider in your eip.cfg file:
+You can:
-cd ~/.config/leap
-vim eip.cfg
+* install PyQt globally and make a virtualenv with --site-packages
+* run pkg/install_pyqt.sh inside your virtualenv (with --no-site-packages)
+* run pkg/postmkvenv.sh after creating your virtualenv, for making symlinks to your global PyQt installation.
-[provider]
-remote_ip = XXX.XXX.XXX.XXX
-and then run:
+Running the App
+-----------------
-leap --debug
+leap --debug --logfile /tmp/leap.log
(or python app.py --debug if you run it from the src/leap folder).
@@ -66,6 +70,11 @@ or
nosetests leap.util.test_leap_argparse
+Tox
+---
+For running testsuite against all the supported python versions (currently 2.6 and 2.7), run:
+
+tox -v
Test-deps
---------
@@ -78,14 +87,9 @@ Hack
(recommended)
virtualenv . # ensure your .gitignore knows about it
bin/activate
-
-# you should probably simlink sip.so and PyQt4 to your system-wide
-# install, there are some issues with it.
-
+pkg/postmkvenv.sh
python setup.py develop
-# ... TBD: finish develop howto.
-# ... and explain how is python setup develop useful.
Compiling resource/ui files
-----------------------------