From 203812621587a71c98f97730e67991b3653f6198 Mon Sep 17 00:00:00 2001 From: drebs Date: Fri, 6 Oct 2017 08:20:44 -0300 Subject: [doc] move compatibility notes from readme to documentation pages --- README.rst | 53 +++++++++++++++++++------------------- docs/development.rst | 1 + docs/development/compatibility.rst | 20 ++++++++++++++ 3 files changed, 48 insertions(+), 26 deletions(-) create mode 100644 docs/development/compatibility.rst diff --git a/README.rst b/README.rst index 335040f8..897b36e9 100644 --- a/README.rst +++ b/README.rst @@ -1,52 +1,50 @@ Soledad ================================================================== + *Synchronization Of Locally Encrypted Data Among Devices* +.. image:: https://badge.fury.io/py/leap.soledad.svg + :target: http://badge.fury.io/py/leap.soledad + Soledad is the part of LEAP that allows application data to be securely shared among devices. It provides, to other parts of the LEAP project, an API for data storage and sync. This software is under development. -From version ``0.9.7`` on, soledad is a single package, with extra dependencies -for the client and the server backends. +Installing +---------- -**leap.soledad** +Soledad is distributed as a single package, with extra dependencies for the +client and the server backends. To install the main package from `pypi +`_, do the following:: -.. image:: https://badge.fury.io/py/leap.soledad.svg - :target: http://badge.fury.io/py/leap.soledad -.. image:: https://img.shields.io/pypi/dm/leap.soledad.svg - :target: http://badge.fury.io/py/leap.soledad + pip install leap.soledad +To use Soledad Client, make sure to install client-specific dependencies:: -Installing extra dependencies ------------------------------ + pip install "leap.soledad[client]" -The client backend is based on sqlcipher:: +To use Soledad Server, also install server-specific dependencies:: - pip install ".[client]" + pip install "leap.soledad[server]" -The server depends on CouchDB:: +If you want to install from the repository, you can do so like this:: - pip install ".[server]" + git clone https://0xacab.org/leap/soledad + cd soledad/ + pip install . + pip install ".[client]" + pip install ".[server]" Compatibility ------------- -* Soledad Server >= 0.7.0 is incompatible with client < 0.7.0 because of - modifications on encrypted document MAC calculation. - -* Soledad Server >= 0.7.0 is incompatible with LEAP Platform < 0.6.1 because - that platform version implements ephemeral tokens databases and Soledad - Server needs to act accordingly. - -* Upgrades of Soledad Server < 0.9.0 to >= 0.9.0 need database migration - because older code used to use CouchDB's design documents, while newer code - got rid of that because it made everything cpu and memory hungry. See `the - documentation - `_ - for more information. +See the documentation page about `compatibility +`_ +for information about compatibility between different versions of Soledad +Server and Client and with the LEAP Plaform. Tests @@ -60,6 +58,9 @@ tests. Currently, some tests also depend on availability of a `CouchDB`_ server Once you have both *tox* and *CouchDB* installed in your system, just run the ``tox`` command in the root of the repository to get started running tests. +See the `documentation pages about tests +`_ for more details. + .. _dependency-on-couchdb: --------------------- diff --git a/docs/development.rst b/docs/development.rst index a7ff15aa..78d75ad2 100644 --- a/docs/development.rst +++ b/docs/development.rst @@ -11,4 +11,5 @@ should help you get started with development for Soledad. development/deprecation development/tests development/benchmarks + development/compatibility changelog diff --git a/docs/development/compatibility.rst b/docs/development/compatibility.rst new file mode 100644 index 00000000..a44499c2 --- /dev/null +++ b/docs/development/compatibility.rst @@ -0,0 +1,20 @@ +Compatibility +============= + +This page keeps notes about compatibility between different versions of Soledad +and between Soledad and other components of the `LEAP Platform +`_. + +* Upgrades of Soledad Server < 0.9.0 to >= 0.9.0 need database migration + because older code used to use CouchDB's design documents, while newer code + got rid of that because it made everything cpu and memory hungry. See `the + documentation + `_ + for more information. + +* Soledad Server >= 0.7.0 is incompatible with client < 0.7.0 because of + modifications on encrypted document MAC calculation. + +* Soledad Server >= 0.7.0 is incompatible with LEAP Platform < 0.6.1 because + that platform version implements ephemeral tokens databases and Soledad + Server needs to act accordingly. -- cgit v1.2.3