fix docstrings

Author: funbringer

.travis.yml

@@ -6,7 +6,7 @@ services:
     - docker
 
 install:
-    - sed -e 's/${PYTHON_VERSION}/'${PYTHON_VERSION}/g -e 's/${PG_VERSION}/'${PG_VERSION}/g Dockerfile.tmpl > Dockerfile
+    - ./mk_dockerfile.sh
     - docker-compose build
 
 script:

mk_dockerfile.sh

@@ -0,0 +1,2 @@
+set -eu
+sed -e 's/${PYTHON_VERSION}/'${PYTHON_VERSION}/g -e 's/${PG_VERSION}/'${PG_VERSION}/g Dockerfile.tmpl > Dockerfile

testgres/api.py

@@ -7,21 +7,28 @@
 edit configuration files, start/stop cluster, execute queries. The
 typical flow may look like:
 
-    with get_new_node() as node:
-        node.init()
-        node.start()
-        result = node.psql('postgres', 'SELECT 1')
-        print(result)
-        node.stop()
+>>> with get_new_node() as node:
+...     node.init().start()
+...     result = node.safe_psql('postgres', 'select 1')
+...     print(result.decode('utf-8').strip())
+...     node.stop()
+<testgres.node.PostgresNode object at 0x...>
+1
+<testgres.node.PostgresNode object at 0x...>
 
     Or:
 
-    with get_new_node() as node1:
-        node1.init().start()
-        with node1.backup() as backup:
-            with backup.spawn_primary() as node2:
-                res = node2.start().execute('postgres', 'select 2')
-                print(res)
+>>> with get_new_node() as master:
+...     master.init().start()
+...     with master.backup() as backup:
+...         with backup.spawn_replica() as replica:
+...             replica = replica.start()
+...             master.execute('postgres', 'create table test (val int4)')
+...             master.execute('postgres', 'insert into test values (0), (1), (2)')
+...             replica.catchup()  # wait until changes are visible
+...             print(replica.execute('postgres', 'select count(*) from test'))
+<testgres.node.PostgresNode object at 0x...>
+[(3,)]
 
 Copyright (c) 2016, Postgres Professional
 """