Use Sphinx notation for class references

Author: zilder

LICENSE

@@ -1,6 +1,6 @@
 testgres is released under the PostgreSQL License, a liberal Open Source license, similar to the BSD or MIT licenses.
 
-Copyright (c) 2016-2017, Postgres Professional
+Copyright (c) 2016-2018, Postgres Professional
 
 Permission to use, copy, modify, and distribute this software and its documentation for any purpose, without fee, and without a written agreement is hereby granted, provided that the above copyright notice and this paragraph and the following two paragraphs appear in all copies.
 

docs/source/testgres.rst

@@ -17,22 +17,6 @@ testgres.backup
     :undoc-members:
     :show-inheritance:
 
-testgres.cache
---------------
-
-.. automodule:: testgres.cache
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-testgres.config
----------------
-
-.. automodule:: testgres.config
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
 testgres.connection
 -------------------
 
@@ -41,30 +25,6 @@ testgres.connection
     :undoc-members:
     :show-inheritance:
 
-testgres.consts
----------------
-
-.. automodule:: testgres.consts
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-testgres.decorators
--------------------
-
-.. automodule:: testgres.decorators
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-testgres.defaults
------------------
-
-.. automodule:: testgres.defaults
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
 testgres.enums
 --------------
 
@@ -81,35 +41,10 @@ testgres.exceptions
     :undoc-members:
     :show-inheritance:
 
-testgres.logger
----------------
-
-.. automodule:: testgres.logger
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
 testgres.node
 -------------
 
 .. automodule:: testgres.node
     :members:
     :undoc-members:
     :show-inheritance:
-
-testgres.utils
---------------
-
-.. automodule:: testgres.utils
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: testgres
-    :members:
-    :undoc-members:
-    :show-inheritance:

testgres/backup.py

@@ -43,7 +43,7 @@ def __init__(self,
         Create a new backup.
 
         Args:
-            node: PostgresNode we're going to backup.
+            node: :class:`.PostgresNode` we're going to backup.
             base_dir: where should we store it?
             username: database user name.
             xlog_method: none | fetch | stream (see docs)
@@ -137,7 +137,7 @@ def spawn_primary(self, name=None, destroy=True):
             destroy: should we convert this backup into a node?
 
         Returns:
-            New instance of PostgresNode.
+            New instance of :class:`.PostgresNode`.
         """
 
         # Prepare a data directory for this node
@@ -166,7 +166,7 @@ def spawn_replica(self, name=None, destroy=True, slot=None):
             destroy: should we convert this backup into a node?
 
         Returns:
-            New instance of PostgresNode.
+            New instance of :class:`.PostgresNode`.
         """
 
         # Build a new PostgresNode

testgres/enums.py

@@ -4,7 +4,7 @@
 
 class XLogMethod(Enum):
     """
-    Available WAL methods for NodeBackup
+    Available WAL methods for :class:`.NodeBackup`
     """
 
     none = 'none'
@@ -14,7 +14,7 @@ class XLogMethod(Enum):
 
 class IsolationLevel(Enum):
     """
-    Transaction isolation level for NodeConnection
+    Transaction isolation level for :class:`.NodeConnection`
     """
 
     ReadUncommitted = 'read uncommitted'

testgres/node.py

@@ -177,7 +177,7 @@ def auxiliary_pids(self):
     def auxiliary_processes(self):
         """
         Returns a list of auxiliary processes.
-        Each process is represented by ProcessProxy object.
+        Each process is represented by :class:`.ProcessProxy` object.
         """
 
         def is_aux(process):
@@ -189,7 +189,7 @@ def is_aux(process):
     def child_processes(self):
         """
         Returns a list of all child processes.
-        Each process is represented by ProcessProxy object.
+        Each process is represented by :class:`.ProcessProxy` object.
         """
 
         # get a list of postmaster's children
@@ -388,7 +388,7 @@ def init(self, initdb_params=None, **kwargs):
             allow_streaming: should this node add a hba entry for replication?
 
         Returns:
-            This instance of PostgresNode.
+            This instance of :class:`.PostgresNode`
         """
 
         # initialize this PostgreSQL node
@@ -416,7 +416,7 @@ def default_conf(self,
             log_statement: one of ('all', 'off', 'mod', 'ddl').
 
         Returns:
-            This instance of PostgresNode.
+            This instance of :class:`.PostgresNode`.
         """
 
         postgres_conf = os.path.join(self.data_dir, PG_CONF_FILE)
@@ -510,7 +510,7 @@ def append_conf(self, line, filename=PG_CONF_FILE):
             filename: config file (postgresql.conf by default).
 
         Returns:
-            This instance of PostgresNode.
+            This instance of :class:`.PostgresNode`.
         """
 
         config_name = os.path.join(self.data_dir, filename)
@@ -524,7 +524,7 @@ def status(self):
         Check this node's status.
 
         Returns:
-            An instance of NodeStatus.
+            An instance of :class:`.NodeStatus`.
         """
 
         try:
@@ -574,7 +574,7 @@ def start(self, params=[]):
             params: additional arguments for pg_ctl.
 
         Returns:
-            This instance of PostgresNode.
+            This instance of :class:`.PostgresNode`.
         """
 
         # yapf: disable
@@ -605,7 +605,7 @@ def stop(self, params=[]):
             params: additional arguments for pg_ctl.
 
         Returns:
-            This instance of PostgresNode.
+            This instance of :class:`.PostgresNode`.
         """
 
         # yapf: disable
@@ -630,7 +630,7 @@ def restart(self, params=[]):
             params: additional arguments for pg_ctl.
 
         Returns:
-            This instance of PostgresNode.
+            This instance of :class:`.PostgresNode`.
         """
 
         # yapf: disable
@@ -661,7 +661,7 @@ def reload(self, params=[]):
             params: additional arguments for pg_ctl.
 
         Returns:
-            This instance of PostgresNode.
+            This instance of :class:`.PostgresNode`.
         """
 
         # yapf: disable
@@ -713,7 +713,7 @@ def cleanup(self, max_attempts=3):
             max_attempts: how many times should we try to stop()?
 
         Returns:
-            This instance of PostgresNode.
+            This instance of :class:`.PostgresNode`.
         """
 
         self._try_shutdown(max_attempts)
@@ -1063,7 +1063,7 @@ def pgbench_init(self, **kwargs):
         Sets initialize=True.
 
         Returns:
-            This instance of PostgresNode.
+            This instance of :class:`.PostgresNode`.
         """
 
         self.pgbench_run(initialize=True, **kwargs)
@@ -1132,7 +1132,7 @@ def connect(self, dbname=None, username=None, password=None):
             password: user's password.
 
         Returns:
-            An instance of NodeConnection.
+            An instance of :class:`.NodeConnection`.
         """
 
         return NodeConnection(node=self,