From 54dfce3435b678dbbf41324d5bcc89fcf91e8de8 Mon Sep 17 00:00:00 2001 From: Jiri Kuncar <jiri.kuncar@gmail.com> Date: Fri, 27 Oct 2017 17:21:30 +0200 Subject: [PATCH] docs: fix references --- docs/app.rst | 5 +++-- docs/conf.py | 6 +++--- docs/driver.rst | 24 ++++++++++++------------ docs/glv.rst | 2 +- docs/goblin.driver.rst | 19 +++++++++---------- 5 files changed, 28 insertions(+), 28 deletions(-) diff --git a/docs/app.rst b/docs/app.rst index 22f0ade..dbf1bf4 100644 --- a/docs/app.rst +++ b/docs/app.rst @@ -37,7 +37,7 @@ Contents of `config.yml`:: max_inflight: 64 message_serializer: 'goblin.driver.GraphSONMessageSerializer' -Special :py:mod:`Goblin` App Configuration +Special :py:mod:`Goblin<goblin>` App Configuration -------------------------------------------------------------- :py:class:`Goblin<goblin.app.Goblin>` supports two additional configuration @@ -70,4 +70,5 @@ its values to produces a hashable id:: ... id_hash = functools.reduce(operator.xor, hashes, 0) ... return id_hash -Look for provider specific :py:mod:`Goblin` libraries in the near future! +Look for provider specific :py:mod:`Goblin<goblin>` libraries in the near +future! diff --git a/docs/conf.py b/docs/conf.py index 277fcf2..70f1ed9 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -18,11 +18,11 @@ # documentation root, use os.path.abspath to make it absolute, like shown here. # -import alabaster -import sys import os import shlex +import sys +import alabaster sys.path.insert(0, os.path.dirname(os.path.dirname(__file__))) @@ -39,7 +39,7 @@ extensions = [ 'sphinx.ext.autodoc', 'sphinx.ext.intersphinx', 'sphinx.ext.viewcode', - 'alabaster' + 'alabaster', ] # Add any paths that contain templates here, relative to this directory. diff --git a/docs/driver.rst b/docs/driver.rst index 6f7e9d6..c3e8637 100644 --- a/docs/driver.rst +++ b/docs/driver.rst @@ -1,13 +1,13 @@ Using the Driver ================ -Connecting to a :py:class:`Cluster<goblin.driver.cluster.Cluster>` ------------------------------------------------------------------- +Connecting to a :py:class:`Cluster<goblin.driver.Cluster>` +---------------------------------------------------------- To take advantage of the higher level features of the -:py:mod:`driver<goblin.driver>`, :py:mod:`Goblin` provides the -:py:class:`Cluster<goblin.driver.cluster.Cluster>` object. -:py:class:`Cluster<goblin.driver.cluster.Cluster>` is used to create multi-host +:py:mod:`driver<goblin.driver>`, :py:mod:`~goblin.app.Goblin` provides the +:py:class:`Cluster<goblin.driver.Cluster>` object. +:py:class:`Cluster<goblin.driver.Cluster>` is used to create multi-host clients that leverage connection pooling and sharing. Its interface is based on the TinkerPop Java driver:: @@ -18,19 +18,19 @@ on the TinkerPop Java driver:: ... print(msg) >>> await cluster.close() # Close all connections to all hosts -And that is it. While :py:class:`Cluster<goblin.driver.cluster.Cluster>` +And that is it. While :py:class:`Cluster<goblin.driver.Cluster>` is simple to learn and use, it provides a wide variety of configuration options. -Configuring :py:class:`Cluster<goblin.driver.cluster.Cluster>` +Configuring :py:class:`Cluster<goblin.driver.Cluster>` -------------------------------------------------------------- Configuration options can be set on -:py:class:`Cluster<goblin.driver.cluster.Cluster>` in one of two ways, either +:py:class:`Cluster<goblin.driver.Cluster>` in one of two ways, either passed as keyword arguments to -:py:meth:`open<goblin.driver.cluster.Cluster.open>`, or stored in a configuration -file and passed to the :py:meth:`open<goblin.driver.cluster.Cluster.open>` +:py:meth:`open<goblin.driver.Cluster.open>`, or stored in a configuration +file and passed to the :py:meth:`open<goblin.driver.Cluster.open>` using the kwarg `configfile`. Configuration files can be either YAML or JSON -format. Currently, :py:class:`Cluster<goblin.driver.cluster.Cluster>` +format. Currently, :py:class:`Cluster<goblin.driver.Cluster>` uses the following configuration: +-------------------+----------------------------------------------+-------------+ @@ -70,7 +70,7 @@ uses the following configuration: +-------------------+----------------------------------------------+-------------+ |message_serializer |String denoting the class used for message |'classpath' | | |serialization, currently only supports | | -| |basic GraphSONMessageSerializer | | +| |basic GraphSONMessageSerializer | | +-------------------+----------------------------------------------+-------------+ diff --git a/docs/glv.rst b/docs/glv.rst index 6bddf24..30e3b93 100644 --- a/docs/glv.rst +++ b/docs/glv.rst @@ -1,7 +1,7 @@ Using Graph (GLV) ================= -:py:mod:`Goblin` provides access to the underlying :py:mod:`aiogremlin` +:py:mod:`~goblin.app.Goblin` provides access to the underlying :py:mod:`aiogremlin` asynchronous version of the Gremlin-Python Gremlin Language Variant (GLV) that is bundled with Apache TinkerPop beginning with the 3.2.2 release. Traversals are generated using the class diff --git a/docs/goblin.driver.rst b/docs/goblin.driver.rst index 8536488..98197d5 100644 --- a/docs/goblin.driver.rst +++ b/docs/goblin.driver.rst @@ -1,13 +1,12 @@ goblin.driver package ===================== -Contains aliases to classes from :py:mod:`aiogremlin`: - -- :py:class:`Cluster<aiogremlin.driver.cluster.Cluster>` -- :py:class:`Graph<aiogremlin.structure.graph.Graph>` -- :py:class:`DriverRemoteConnection<aiogremlin.remote.driver_remote_connection.DriverRemoteConnection>` -- :py:class:`Client<aiogremlin.driver.client.Client>` -- :py:class:`Connection<aiogremlin.driver.connection.Connection>` -- :py:class:`ConnectionPool<aiogremlin.driver.pool.ConnectionPool>` -- :py:class:`GremlinServer<aiogremlin.driver.server.GremlinServer>` -- :py:class:`GraphSONMessageSerializer<gremlin_python.driver.serializer.GraphSONMessageSerializer>` +Contains aliases to classes from `aiogremlin`: + +.. automodule:: goblin.driver + +.. autoclass:: goblin.driver.Cluster + :members: + +.. autoclass:: goblin.driver.Connection + :members: -- GitLab