summaryrefslogtreecommitdiff
path: root/docs/hacking/devenv.rst
diff options
context:
space:
mode:
authorKali Kaneko <kali@leap.se>2017-10-02 20:29:38 +0200
committerKali Kaneko <kali@leap.se>2017-10-02 23:58:40 +0200
commitdd80e6083247446a44c22ac430620045aba287ef (patch)
tree2013ff98dec0f38cc7dd30fbd7e095ab5c4dee51 /docs/hacking/devenv.rst
parent0c497dbac737b6a92ad8662005fe152f7a9c1fe9 (diff)
[docs] split development docs
the page was becoming too cluttered.
Diffstat (limited to 'docs/hacking/devenv.rst')
-rw-r--r--docs/hacking/devenv.rst68
1 files changed, 68 insertions, 0 deletions
diff --git a/docs/hacking/devenv.rst b/docs/hacking/devenv.rst
new file mode 100644
index 0000000..d7ad415
--- /dev/null
+++ b/docs/hacking/devenv.rst
@@ -0,0 +1,68 @@
+.. _devenv:
+
+Setting a Development Environment
+=================================
+
+
+Convencience script
+~~~~~~~~~~~~~~~~~~~
+
+There is an automated script that runs, sequentially, all the commands in the
+section below. In debian-based systems, you can get a fully working development
+environment with::
+
+ make dev-bootstrap
+
+To activate the freshly created virtualenv the next time, you must use `pew`_::
+
+ pew workon bitmask
+
+.. note:: the bootstrap script is, at the moment, quite opinionated. for
+ instance, it installs and depends on pew, it checks out the
+ bitmask-dev repo under ~/leap folder, and it assumes you are using
+ zsh. if you think it should allow more freedom of choices, feel free
+ to open a pull request.
+
+.. _`pew`: https://pypi.python.org/pypi/pew
+
+Manual instructions
+-------------------
+
+Install the system-wide dependencies. For debian-based systems::
+
+ sudo apt install build-essential python-dev python-virtualenv \
+ libsqlcipher-dev libssl-dev libffi-dev \
+ python-pyqt5 python-pyqt5.qtwebkit
+
+If you are going to be running tests that involve creating a lot of OpenPGP
+keys, and specially in vms, the following is also recommended to speed up
+things::
+
+ sudo apt install haveged
+
+
+Clone the repo. The master branch has the latest code::
+
+ git clone https://0xacab.org/leap/bitmask-dev
+ cd bitmask-dev
+
+Create a virtualenv and activate it::
+
+ virtualenv venv
+ source venv/bin/activate
+
+By the way, if you plan to get into heavy development, you might want to
+consider using something like `pew`_, instead of the plain virtualenv.
+
+Now you should be able to install all the bitmask dependencies::
+
+ make dev-latest-all
+
+You can also install some dependencies that are going to be useful during
+development::
+
+ pip install -r pkg/requirements-dev.pip
+
+What next?
+-----------
+Check out the Bitmask Architecture.