diff options
| author | Richard van der Hoff <richard@matrix.org> | 2016-12-12 11:46:46 +0000 |
|---|---|---|
| committer | Richard van der Hoff <richard@matrix.org> | 2016-12-12 11:46:46 +0000 |
| commit | 9240948346b86c5291b90169fea6e493337aab91 (patch) | |
| tree | 94993bd34deaf7c22b22d089f8c89854f5fea9e1 /README.rst | |
| parent | Merge pull request #1620 from matrix-org/erikj/concurrent_room_access (diff) | |
| parent | Merge pull request #1685 from matrix-org/rav/update_readme_for_tests (diff) | |
| download | synapse-9240948346b86c5291b90169fea6e493337aab91.tar.xz | |
Merge remote-tracking branch 'origin/master' into develop
Diffstat (limited to 'README.rst')
| -rw-r--r-- | README.rst | 17 |
1 files changed, 13 insertions, 4 deletions
diff --git a/README.rst b/README.rst index 0fb7a66cae..21bd63fd64 100644 --- a/README.rst +++ b/README.rst @@ -88,7 +88,12 @@ System requirements: - Python 2.7 - At least 1GB of free RAM if you want to join large public rooms like #matrix:matrix.org -Synapse is written in python but some of the libraries is uses are written in +Installing from source +---------------------- +(Prebuilt packages are available for some platforms - see `Platform-Specific +Instructions`_.) + +Synapse is written in python but some of the libraries it uses are written in C. So before we can install synapse itself we need a working C compiler and the header files for python C extensions. @@ -306,7 +311,7 @@ See https://github.com/vector-im/vector-web/issues/1977 and https://developer.github.com/changes/2014-04-25-user-content-security for more details. -Platform Specific Instructions +Platform-Specific Instructions ============================== Debian @@ -789,6 +794,10 @@ Then update the `users` table in the database:: Synapse Development =================== +Before setting up a development environment for synapse, make sure you have the +system dependencies (such as the python header files) installed - see +`Installing from source`_. + To check out a synapse for development, clone the git repo into a working directory of your choice:: @@ -801,7 +810,7 @@ to install using pip and a virtualenv:: virtualenv env source env/bin/activate python synapse/python_dependencies.py | xargs pip install - pip install setuptools_trial mock + pip install lxml mock This will run a process of downloading and installing all the needed dependencies into a virtual env. @@ -809,7 +818,7 @@ dependencies into a virtual env. Once this is done, you may wish to run Synapse's unit tests, to check that everything is installed as it should be:: - python setup.py test + PYTHONPATH="." trial tests This should end with a 'PASSED' result:: |