summaryrefslogtreecommitdiff
path: root/README.rst
diff options
context:
space:
mode:
authorTomás Touceda <chiiph@leap.se>2014-04-04 16:58:18 -0300
committerTomás Touceda <chiiph@leap.se>2014-04-04 16:58:18 -0300
commit81715dc47d77934c4f67d2527a56c28f58f0345d (patch)
tree6e66940af735e089803c5ce05ad1ce1df16c9d1e /README.rst
parent496036f15cf257d16b6594770812da64a249280c (diff)
parenteb4cdab9c6b8ff66bb4667cc6195d2c366122540 (diff)
Merge branch 'release-0.5.0'
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst101
1 files changed, 3 insertions, 98 deletions
diff --git a/README.rst b/README.rst
index fc0f9772..ff84d56b 100644
--- a/README.rst
+++ b/README.rst
@@ -17,111 +17,16 @@ Currently we distribute pre-compiled `bundles`_ for Linux, OSX and Windows.
.. _`PySide`: http://qt-project.org/wiki/PySide
.. _`the LEAP Platform`: https://github.com/leapcode/leap_platform
-.. _`bundles`: https://downloads.leap.se/client/
+.. _`bundles`: https://dl.bitmask.net
Read the Docs!
------------------
-The latest documentation is available at `Read The Docs`_.
+The latest documentation is available at `LEAP`_.
-.. _`Read The Docs`: http://bitmask.rtfd.org
+.. _`LEAP`: https://leap.se/en/docs/client
-Dependencies
-------------------
-
-Bitmask depends on these libraries:
-
-* ``python 2.6`` or ``2.7``
-* ``qt4 libraries``
-* ``libopenssl``
-* ``openvpn``
-
-Python packages are listed in ``pkg/requirements.pip`` and ``pkg/test-requirements.pip``
-
-Getting dependencies under debian
-++++++++++++++++++++++++++++++++++
-
-With a Debian based system, to be able to run Bitmask you need to run the following command::
-
- $ sudo apt-get install git python-dev python-setuptools
- python-virtualenv python-pip python-openssl libsqlite3-dev g++ openvpn
- pyside-tools python-pyside
-
-Installing
------------
-
-Quick install, from the cheese shop::
-
- $ sudo pip install leap.bitmask
-
-If you prefer to install from sources::
-
- $ make
- $ sudo python2 setup.py install
-
-
-Running
--------
-
-After a successful installation, there should be a launcher called ``bitmask`` somewhere in your path::
-
- $ bitmask
-
-If you are testing a new provider and do not have a CA certificate chain tied to your SSL certificate, you should execute Bitmask in the following way::
-
- $ bitmask --danger
-
-But **DO NOT use it on a regular basis**.
-
-**WARNING**: If you use the --danger flag you may be victim to a MITM_ attack without noticing. Use at your own risk.
-
-.. _MITM: http://en.wikipedia.org/wiki/Man-in-the-middle_attack
-
-Hacking
-=======
-
-Get the source from the main Bitmask repo::
-
- git clone https://leap.se/git/bitmask_client
-
-The code is also browsable online at::
-
- https://leap.se/git/?p=bitmask_client.git
-
-Some steps need to be run when setting a development environment for the first time.
-
-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>*)::
-
- $ virtualenv .
- $ source bin/activate
-
-Make sure you are in the development branch::
-
- (bitmask)$ git checkout develop
-
-Symlink your global pyside libraries::
-
- (bitmask)$ pkg/postmkvenv.sh
-
-And make your working tree available to your pythonpath::
-
- (bitmask)$ python2 setup.py develop
-
-Run Bitmask::
-
- (bitmask)$ bitmask --debug
-
-Testing
-=======
-
-Have a look at ``pkg/test-requirements.pip`` for the tests dependencies.
-
-To run the test suite::
-
- $ ./run_tests.sh
-
-which the first time should automagically install all the needed dependencies in your virtualenv for you.
License
=======