openstack/python-keystoneclient
Code Issues Proposed changes

Merge "Docstring usability improvements"

Browse Source
This commit is contained in:
Jenkins
2015-02-02 18:04:18 +00:00
committed by Gerrit Code Review
parent e458873b92 3568acb617
commit ddbd92518c
2 changed files with 17 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
keystoneclient/__init__.py
View File

@@ -15,9 +15,15 @@
"""The python bindings for the OpenStack Identity (Keystone) project. """The python bindings for the OpenStack Identity (Keystone) project.
See :py:class:`keystoneclient.v3.client.Client` for the Identity V3 client. A Client object will allow you to communicate with the Identity server. The
recommended way to get a Client object is to use
:py:func:`keystoneclient.client.Client()`. :py:func:`~.Client()` uses version
discovery to create a V3 or V2 client depending on what versions the Identity
server supports and what version is requested.
See :py:class:`keystoneclient.v2_0.client.Client` for the Identity V2.0 client. Identity V2 and V3 clients can also be created directly. See
:py:class:`keystoneclient.v3.client.Client` for the V3 client and
:py:class:`keystoneclient.v2_0.client.Client` for the V2 client.
""" """

14
keystoneclient/client.py
View File

@@ -22,11 +22,15 @@ HTTPClient = httpclient.HTTPClient
def Client(version=None, unstable=False, session=None, **kwargs): def Client(version=None, unstable=False, session=None, **kwargs):
"""Factory function to create a new identity service client. """Factory function to create a new identity service client.
The returned client will be either a V3 or V2 client. Check the version
using the :py:attr:`~keystoneclient.v3.client.Client.version` property or
the instance's class (with instanceof).
:param tuple version: The required version of the identity API. If :param tuple version: The required version of the identity API. If
specified the client will be selected such that the specified the client will be selected such that the
major version is equivalent and an endpoint provides major version is equivalent and an endpoint provides
at least the specified minor version. For example to at least the specified minor version. For example to
specify the 3.1 API use (3, 1). specify the 3.1 API use ``(3, 1)``.
:param bool unstable: Accept endpoints not marked as 'stable'. (optional) :param bool unstable: Accept endpoints not marked as 'stable'. (optional)
:param session: A session object to be used for communication. If one is :param session: A session object to be used for communication. If one is
not provided it will be constructed from the provided not provided it will be constructed from the provided
@@ -34,11 +38,11 @@ def Client(version=None, unstable=False, session=None, **kwargs):
:type session: keystoneclient.session.Session :type session: keystoneclient.session.Session
:param kwargs: Additional arguments are passed through to the client :param kwargs: Additional arguments are passed through to the client
that is being created. that is being created.
:returns: New keystone client object :returns: New keystone client object.
(keystoneclient.v2_0.Client or keystoneclient.v3.Client). :rtype: :py:class:`keystoneclient.v3.client.Client` or
:py:class:`keystoneclient.v2_0.client.Client`
:raises keystoneclient.exceptions.DiscoveryFailure: if the server's :raises keystoneclient.exceptions.DiscoveryFailure: if the server's
response is invalid response is invalid.
:raises keystoneclient.exceptions.VersionNotAvailable: if a suitable client :raises keystoneclient.exceptions.VersionNotAvailable: if a suitable client
cannot be found. cannot be found.
""" """