From 97c7135bc346dd589b558aad6febbd34bebf025e Mon Sep 17 00:00:00 2001 From: "Kali Kaneko (leap communications)" Date: Thu, 1 Sep 2016 11:42:41 -0400 Subject: [docs] more info to the readme --- README.rst | 85 ++++++++++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 72 insertions(+), 13 deletions(-) diff --git a/README.rst b/README.rst index 587e4d3..b1f4193 100644 --- a/README.rst +++ b/README.rst @@ -1,29 +1,88 @@ -bitmask-dev +Bitmask =========== -**Your internet encryption toolkit** -Develop -------- +*Your internet encryption toolkit* -If you want to develop for the encrypted mail service, execute inside your virtualenv:: +.. image:: https://badge.fury.io/py/leap.bitmask.svg + :target: http://badge.fury.io/py/leap.bitmask +.. image:: https://img.shields.io/badge/IRC-leap-blue.svg + :target: http://webchat.freenode.net/?channels=%23leap&uio=d4 + :alt: IRC +.. image:: https://img.shields.io/badge/IRC-bitmask_(es)-blue.svg + :target: http://webchat.freenode.net/?channels=%23bitmask-es&uio=d4 + :alt: IRC-es - make dev-mail -If you want to develop for the gui client too, you have to have installed the -python2 bindings for Qt5 in your system (in debian this is python-pyqt5, -python-pyqt5.qtwebkit). After ensuring this, you can do:: +**Bitmask** is the client for the services offered by `the LEAP Platform`_. It +contains a command-line interface and a multiplatform desktop client. It can be +also used as a set of libraries to communicate with the different services from +third party applications. - make dev-all +It is written in python using `Twisted`_ and licensed under the `GPL3`_. The +Graphical User Interface is written in html+js and uses `PyQt5`_ for serving the +application. + +.. _`the LEAP Platform`: https://github.com/leapcode/leap_platform +.. _`Twisted`: https://twistedmatrix.com +.. _`PyQt5`: https://pypi.python.org/pypi/PyQt5 +.. _`GPL3`: http://www.gnu.org/licenses/gpl.txt + +Read the Docs! +------------------ + +The latest documentation is available at `LEAP`_. + +.. _`LEAP`: https://leap.se/en/docs/client + +Bugs +==== + +Please report any bugs `in our bug tracker`_. + +.. _`in our bug tracker`: https://leap.se/code/projects/report-issues + + +Development +============== Tests ----- -Tests need tox:: +You need tox to run the tests. If you don't have it in your system yet:: pip install tox + +And then run all the tests:: + tox -If you are developing against a non-published branch of leap.common or -leap.soledad, run instead:: +If you are developing against a non-published branch of ``leap.common`` or +``leap.soledad``, run instead:: tox -e py27-dev + +This expects ``leap_common`` and ``soledad`` repos to be checked out in the +parent folder. + +Hacking +------- + +If you want to develop for the encrypted mail service, execute inside your virtualenv:: + + make dev-mail + +If you want to develop for the gui client too, you have to have installed the +python2 bindings for Qt5 in your system (in debian: ``apt install python-pyqt5 +python-pyqt5.qtwebkit``). After ensuring this, you can do:: + + make dev-all + + +License +======= + +.. image:: https://raw.github.com/leapcode/bitmask_client/develop/docs/user/gpl.png + +Bitmask is released under the terms of the `GNU GPL version 3`_ or later. + +.. _`GNU GPL version 3`: http://www.gnu.org/licenses/gpl.txt -- cgit v1.2.3