From 5cf77ccd4df00a59c8cb8d4670f2964f021ae862 Mon Sep 17 00:00:00 2001
From: efkin <efkin@riseup.net>
Date: Mon, 13 Mar 2017 19:23:08 +0100
Subject: [docs] Define in details the testing environment

On debian stable the `python3-tox` and `python-tox` packages
come with a really old version of `pip` and `setup_tools`.
This makes unusable PEP496 that comes handy when dependencies
are "py-version-related".
As a workaround we can "inject" an upgraded version of `pip` just
before running `tox`.
---
 .gitignore                       |  1 +
 README.rst                       | 14 ++++++++++++--
 testing/requirements-testing.pip |  2 ++
 3 files changed, 15 insertions(+), 2 deletions(-)
 create mode 100644 testing/requirements-testing.pip

diff --git a/.gitignore b/.gitignore
index 1f278cbf..a8df15eb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -21,3 +21,4 @@ scripts/profiling/sync/profiles
 
 testing/htmlcov
 testing/.coverage
+testing/test-env
\ No newline at end of file
diff --git a/README.rst b/README.rst
index 11455880..d8713df6 100644
--- a/README.rst
+++ b/README.rst
@@ -47,10 +47,20 @@ Compatibility
 Tests
 -----
 
+System dependencies::
+
+  python3-venv
+
+Install local dependencies::
+
+  $ cd testing
+  $ pyvenv test-env
+  $ source test-env/bin/activate
+  $ pip3 install -U -r requirements-testing.pip
+
 Soledad tests use tox, and they live in the testing folder::
 
-  cd testing
-  tox
+  $ tox
 
 Note that to run CouchDB tests, be sure you have `CouchDB`_ installed on your
 system.
diff --git a/testing/requirements-testing.pip b/testing/requirements-testing.pip
new file mode 100644
index 00000000..a33c65ab
--- /dev/null
+++ b/testing/requirements-testing.pip
@@ -0,0 +1,2 @@
+pip
+tox
\ No newline at end of file
-- 
cgit v1.2.3