Merge pull request City-of-Helsinki#192 from City-of-Helsinki/feature…

…-document-testing

Add instructions how to configure database for tests

README.md

@@ -69,11 +69,31 @@ After this, everything but search endpoint (/search) is working. See [search](#s
 Running tests
 ------------
 Tests must be run using an user who can create (and drop) databases and write the directories
-your linkedevents installation resides in.
+your linkedevents installation resides in. Also the template database must include Postgis and
+HSTORE-extensions. If you are developing, you probably want to give those
+permissions to the database user configured in your development instance. Like so:
+
 ```bash
+# Change this if you have different DB user
+DATABASE_USER=linkedevents
+# Most likely you have a postgres system user that can log into postgres as DB postgres user
+sudo -u postgres psql << EOF
+ALTER USER "$DATABASE_USER" CREATEDB;
+\c template1
+CREATE EXTENSION IF NOT EXISTS postgis;
+CREATE EXTENSION IF NOT EXISTS hstore;
+EOF
+
+```
+
+Afterwards you can run the tests:
+```bash
+cd $INSTALL_BASE/linkedevents
 py.test events
 ```
 
+Note that search tests will fail unless you configure [search](#search)
+
 Requirements
 ------------