diff options
author | 2018-09-19 21:36:58 +0200 | |
---|---|---|
committer | 2018-09-19 22:09:10 +0200 | |
commit | c15b02890d9717c5afa62debfbc81678db5e79a3 (patch) | |
tree | 8c7b8178baa41dd4f2b0c9891224736f5edcf46e /docs/setup.md | |
parent | Remove headers after compilation. (diff) |
Add Markdown lint.
Diffstat (limited to 'docs/setup.md')
-rw-r--r-- | docs/setup.md | 36 |
1 files changed, 26 insertions, 10 deletions
diff --git a/docs/setup.md b/docs/setup.md index 16fb44d3..d6e5a7bf 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -1,41 +1,55 @@ # Setup -Setting up the Python site for local development is quick and easy using `pip`. -Alternatively, you can set it up using Docker. Both of these methods are documented here. + +Setting up the Python site for local development +is quick and easy using `pip`. +Alternatively, you can set it up using Docker. +Both of these methods are documented here. ## PostgreSQL setup -Install PostgreSQL according to its documentation. Then, create databases and users: + +Install PostgreSQL according to its documentation. +Then, create databases and users: + ```sql $ psql -qd postgres postgres=# CREATE USER pysite WITH CREATEDB; postgres=# CREATE DATABASE pysite OWNER pysite; ``` -Using different databases for development and tests is recommended because Django + +Using different databases for development +and tests is recommended because Django will expect an empty database when running tests. Now that PostgreSQL is set up, simply set the proper database URL in your environment variables: + ```sh -$ export DATABASE_URL=postgres://pysite@localhost/pysite +export DATABASE_URL=postgres://pysite@localhost/pysite ``` + A simpler approach to automatically configuring this might come in the near future - if you have any suggestions, please let us know! ## Development with Docker + To quickly set up the site locally, you can use Docker. -You will need Docker itself and `docker-compose` - you can omit the latter if you want to -use PostgreSQL on your host. Refer to the docker documentation on how to install Docker. +You will need Docker itself and `docker-compose` - +you can omit the latter if you want to use PostgreSQL on +your host. Refer to the docker documentation on how to install Docker. If you want to set the site up using `docker-compose`, simply run + ```sh -$ docker-compose up +docker-compose up ``` + and it will do its magic. Otherwise, you need to set a bunch of environment variables (or pass them along to the container). You will also need to have a running PostgreSQL instance if you want to run on your host's PostgreSQL instance. - ## Development with `pip` + This is the recommended way if you wish to quickly test your changes and don't want the overhead that Docker brings. @@ -45,9 +59,11 @@ using pip and virtualenv](https://packaging.python.org/guides/installing-using-p from the Python Packaging User Guide. Enter the virtual environment. Now you can run + ```sh -$ pip install -e .[lint,test] +pip install -e .[lint,test] ``` + to install base dependencies along with lint and test dependencies. You can either use `python manage.py` directly, or you can use the console |