openstack/deb-python-keystoneclient
Code Issues Proposed changes

Link to docstrings in using-api-v3

Browse Source 
The references to classes and modules were just the names and
didn't link to the docstrings for the class or module. With this
change, names are now links to the class or module.

Change-Id: I9c7c03e8221ca71c7fddc0682abadc7a78d371db
This commit is contained in:
Brant Knudson
2014-06-12 14:30:07 -05:00
parent 832d89681c
commit 03fbe590eb
1 changed files with 10 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
doc/source/using-api-v3.rst
View File

@@ -19,13 +19,13 @@ The main concepts in the Identity v3 API are:
* trusts * trusts
* users * users
The ``keystoneclient.v3.client`` API lets you query and make changes The :py:mod:`keystoneclient.v3.client` API lets you query and make changes
through ``managers``. For example, to manipulate a project (formerly through ``managers``. For example, to manipulate a project (formerly
called tenant), you interact with a called tenant), you interact with a
``keystoneclient.v3.projects.ProjectManager`` object. :py:class:`keystoneclient.v3.projects.ProjectManager` object.
You obtain access to managers through attributes of a You obtain access to managers through attributes of a
``keystoneclient.v3.client.Client`` object. For example, the :py:class:`keystoneclient.v3.client.Client` object. For example, the
``projects`` attribute of a ``Client`` object is a projects manager:: ``projects`` attribute of a ``Client`` object is a projects manager::
>>> from keystoneclient.v3 import client >>> from keystoneclient.v3 import client
@@ -33,10 +33,11 @@ You obtain access to managers through attributes of a
>>> keystone.projects.list() # List projects >>> keystone.projects.list() # List projects
While it is possible to instantiate a While it is possible to instantiate a
``keystoneclient.v3.client.Client`` object (as done above for :py:class:`keystoneclient.v3.client.Client` object (as done above for
clarity), the recommended approach is to use the discovery mechanism clarity), the recommended approach is to use the discovery mechanism
provided by the ``keystone.client.Client`` class. The appropriate provided by the :py:class:`keystoneclient.client.Client` class. The
class will be instantiated depending on the API versions available:: appropriate class will be instantiated depending on the API versions
available::
>>> from keystoneclient import client >>> from keystoneclient import client
>>> keystone = >>> keystone =
@@ -70,13 +71,14 @@ as the auth_url keyword argument::
>>> type(keystone) >>> type(keystone)
<class 'keystoneclient.v3.client.Client'> <class 'keystoneclient.v3.client.Client'>
Upon successful authentication, a ``keystoneclient.v3.client.Client`` Upon successful authentication, a :py:class:`keystoneclient.v3.client.Client`
object is returned (when using the Identity v3 API). Authentication and object is returned (when using the Identity v3 API). Authentication and
examples of common tasks are provided below. examples of common tasks are provided below.
You can generally expect that when the client needs to propagate an You can generally expect that when the client needs to propagate an
exception it will raise an instance of subclass of exception it will raise an instance of subclass of
``keystoneclient.exceptions.ClientException`` ``keystoneclient.exceptions.ClientException`` (see
:py:class:`keystoneclient.openstack.common.apiclient.exceptions.ClientException`)
Authenticating Authenticating
============== ==============