From 55a9bf2e4b4dd33bb736fc698b598c37e342f551 Mon Sep 17 00:00:00 2001 From: Felix Hammerl Date: Wed, 10 Feb 2016 18:04:47 +0100 Subject: Add virtualenv and GPG workaround to guide --- README.md | 28 ++++++++++++++++++++-------- 1 file changed, 20 insertions(+), 8 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 2abf95b3..832a3dcd 100644 --- a/README.md +++ b/README.md @@ -26,22 +26,34 @@ $ cd pixelated-user-agent $ vagrant up ``` -4) Log into the VM: +4) Set up your python virtualenv + +``` +$ pip install virtualenv setuptools +$ cd ~ +$ virtualenv pixelated +$ virtualenv -p [PATH/TO/YOUR/PYTHON/EXECUTABLE] pixelated +$ source ~/.virtualenv/pixelated/bin/activate +``` + +5) There's a bug in a LEAP library that can't handle symlinks to your local GPG installation. To fix it, add the path to your GPG binary to your $PATH so that it is found before the symlink in `/usr/local/bin` (or similar) + +6) Log into the VM: ``` $ vagrant ssh ``` -5) Setup the project (downloads a few hundred more megabytes): +7) Setup the project (downloads a few hundred more megabytes): ``` $ cd /vagrant/service $ ./go setup ``` -6) Register with a LEAP provider. You can create a developer account at our [Dev Provider](https://dev.pixelated-project.org/). Please contact us at team@pixelated-project.org for an invite code. +8) Register with a LEAP provider. You can create a developer account at our [Dev Provider](https://dev.pixelated-project.org/). Please contact us at team@pixelated-project.org for an invite code. -7) Run the user agent: +9) Run the user agent: ``` $ pixelated-user-agent --host 0.0.0.0 @@ -56,11 +68,11 @@ Type your password: ******** (the one you created in previous step) ``` -8) Connect to the provider using your credentials. If the user agent starts up successfully, you will not see any other output. +10) Connect to the provider using your credentials. If the user agent starts up successfully, you will not see any other output. -9) Go to [localhost:3333](http://localhost:3333/). You should see a loading screen for a few seconds, then your inbox. If it sticks on the loading screen, check your terminal for errors, then [get help](https://pixelated-project.org/faq/#contact-the-project). +11) Go to [localhost:3333](http://localhost:3333/). You should see a loading screen for a few seconds, then your inbox. If it sticks on the loading screen, check your terminal for errors, then [get help](https://pixelated-project.org/faq/#contact-the-project). -10) If you like console output, you can also run the tests to see if everything went according to plan. +12) If you like console output, you can also run the tests to see if everything went according to plan. To run the backend tests: @@ -83,7 +95,7 @@ To run the functional tests: (user-agent-venv)vagrant@jessie:/vagrant/service$ ./go functional ``` -11. You're all set! We've prepared [a couple of issues labeled "Beginner"](https://github.com/pixelated/pixelated-user-agent/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+label%3ABeginners+) that are a good place to dive into the project. Happy Hacking! +13) You're all set! We've prepared [a couple of issues labeled "Beginner"](https://github.com/pixelated/pixelated-user-agent/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+label%3ABeginners+) that are a good place to dive into the project. Happy Hacking! # Further Notes -- cgit v1.2.3