openstack/openstacksdk
Code Issues Proposed changes

Database service - reindentation of the docstrings

Browse Source 
Change-Id: I1aa073f1a49db5d5a4dd0cff154cd30e2090d8f1
This commit is contained in:
Thomas Bucaioni 2021-11-05 10:58:12 +01:00
parent ef587c9a02
commit b48d0b8c96
2 changed files with 93 additions and 93 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

146
openstack/database/v1/_proxy.py
View File

@ -23,10 +23,10 @@ class Proxy(proxy.Proxy):
"""Create a new database from attributes """Create a new database from attributes
:param instance: This can be either the ID of an instance :param instance: This can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
:param dict attrs: Keyword arguments which will be used to create :param dict attrs: Keyword arguments which will be used to create
a :class:`~openstack.database.v1.database.Database`, a :class:`~openstack.database.v1.database.Database`,
comprised of the properties on the Database class. comprised of the properties on the Database class.
:returns: The results of server creation :returns: The results of server creation
:rtype: :class:`~openstack.database.v1.database.Database` :rtype: :class:`~openstack.database.v1.database.Database`
@ -39,16 +39,16 @@ class Proxy(proxy.Proxy):
"""Delete a database """Delete a database
:param database: The value can be either the ID of a database or a :param database: The value can be either the ID of a database or a
:class:`~openstack.database.v1.database.Database` instance. :class:`~openstack.database.v1.database.Database` instance.
:param instance: This parameter needs to be specified when :param instance: This parameter needs to be specified when
an ID is given as `database`. an ID is given as `database`.
It can be either the ID of an instance It can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
:param bool ignore_missing: When set to ``False`` :param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.ResourceNotFound` will be :class:`~openstack.exceptions.ResourceNotFound` will be
raised when the database does not exist. raised when the database does not exist.
When set to ``True``, no exception will be set when When set to ``True``, no exception will be set when
attempting to delete a nonexistent database. attempting to delete a nonexistent database.
:returns: ``None`` :returns: ``None``
""" """
@ -62,12 +62,12 @@ class Proxy(proxy.Proxy):
:param name_or_id: The name or ID of a database. :param name_or_id: The name or ID of a database.
:param instance: This can be either the ID of an instance :param instance: This can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
:param bool ignore_missing: When set to ``False`` :param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.ResourceNotFound` will be :class:`~openstack.exceptions.ResourceNotFound` will be
raised when the resource does not exist. raised when the resource does not exist.
When set to ``True``, None will be returned when When set to ``True``, None will be returned when
attempting to find a nonexistent resource. attempting to find a nonexistent resource.
:returns: One :class:`~openstack.database.v1.database.Database` or None :returns: One :class:`~openstack.database.v1.database.Database` or None
""" """
instance = self._get_resource(_instance.Instance, instance) instance = self._get_resource(_instance.Instance, instance)
@ -79,10 +79,10 @@ class Proxy(proxy.Proxy):
"""Return a generator of databases """Return a generator of databases
:param instance: This can be either the ID of an instance :param instance: This can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
instance that the interface belongs to. instance that the interface belongs to.
:param kwargs query: Optional query parameters to be sent to limit :param kwargs query: Optional query parameters to be sent to limit
the resources being returned. the resources being returned.
:returns: A generator of database objects :returns: A generator of database objects
:rtype: :class:`~openstack.database.v1.database.Database` :rtype: :class:`~openstack.database.v1.database.Database`
@ -94,16 +94,16 @@ class Proxy(proxy.Proxy):
"""Get a single database """Get a single database
:param instance: This parameter needs to be specified when :param instance: This parameter needs to be specified when
an ID is given as `database`. an ID is given as `database`.
It can be either the ID of an instance It can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
:param database: The value can be the ID of a database or a :param database: The value can be the ID of a database or a
:class:`~openstack.database.v1.database.Database` :class:`~openstack.database.v1.database.Database`
instance. instance.
:returns: One :class:`~openstack.database.v1.database.Database` :returns: One :class:`~openstack.database.v1.database.Database`
:raises: :class:`~openstack.exceptions.ResourceNotFound` :raises: :class:`~openstack.exceptions.ResourceNotFound`
when no resource can be found. when no resource can be found.
""" """
return self._get(_database.Database, database) return self._get(_database.Database, database)
@ -112,10 +112,10 @@ class Proxy(proxy.Proxy):
:param name_or_id: The name or ID of a flavor. :param name_or_id: The name or ID of a flavor.
:param bool ignore_missing: When set to ``False`` :param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.ResourceNotFound` will be :class:`~openstack.exceptions.ResourceNotFound` will be
raised when the resource does not exist. raised when the resource does not exist.
When set to ``True``, None will be returned when When set to ``True``, None will be returned when
attempting to find a nonexistent resource. attempting to find a nonexistent resource.
:returns: One :class:`~openstack.database.v1.flavor.Flavor` or None :returns: One :class:`~openstack.database.v1.flavor.Flavor` or None
""" """
return self._find(_flavor.Flavor, name_or_id, return self._find(_flavor.Flavor, name_or_id,
@ -125,11 +125,11 @@ class Proxy(proxy.Proxy):
"""Get a single flavor """Get a single flavor
:param flavor: The value can be the ID of a flavor or a :param flavor: The value can be the ID of a flavor or a
:class:`~openstack.database.v1.flavor.Flavor` instance. :class:`~openstack.database.v1.flavor.Flavor` instance.
:returns: One :class:`~openstack.database.v1.flavor.Flavor` :returns: One :class:`~openstack.database.v1.flavor.Flavor`
:raises: :class:`~openstack.exceptions.ResourceNotFound` :raises: :class:`~openstack.exceptions.ResourceNotFound`
when no resource can be found. when no resource can be found.
""" """
return self._get(_flavor.Flavor, flavor) return self._get(_flavor.Flavor, flavor)
@ -137,7 +137,7 @@ class Proxy(proxy.Proxy):
"""Return a generator of flavors """Return a generator of flavors
:param kwargs query: Optional query parameters to be sent to limit :param kwargs query: Optional query parameters to be sent to limit
the resources being returned. the resources being returned.
:returns: A generator of flavor objects :returns: A generator of flavor objects
:rtype: :class:`~openstack.database.v1.flavor.Flavor` :rtype: :class:`~openstack.database.v1.flavor.Flavor`
@ -148,8 +148,8 @@ class Proxy(proxy.Proxy):
"""Create a new instance from attributes """Create a new instance from attributes
:param dict attrs: Keyword arguments which will be used to create :param dict attrs: Keyword arguments which will be used to create
a :class:`~openstack.database.v1.instance.Instance`, a :class:`~openstack.database.v1.instance.Instance`,
comprised of the properties on the Instance class. comprised of the properties on the Instance class.
:returns: The results of server creation :returns: The results of server creation
:rtype: :class:`~openstack.database.v1.instance.Instance` :rtype: :class:`~openstack.database.v1.instance.Instance`
@ -160,12 +160,12 @@ class Proxy(proxy.Proxy):
"""Delete an instance """Delete an instance
:param instance: The value can be either the ID of an instance or a :param instance: The value can be either the ID of an instance or a
:class:`~openstack.database.v1.instance.Instance` instance. :class:`~openstack.database.v1.instance.Instance` instance.
:param bool ignore_missing: When set to ``False`` :param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.ResourceNotFound` will be :class:`~openstack.exceptions.ResourceNotFound` will be
raised when the instance does not exist. raised when the instance does not exist.
When set to ``True``, no exception will be set when When set to ``True``, no exception will be set when
attempting to delete a nonexistent instance. attempting to delete a nonexistent instance.
:returns: ``None`` :returns: ``None``
""" """
@ -177,10 +177,10 @@ class Proxy(proxy.Proxy):
:param name_or_id: The name or ID of a instance. :param name_or_id: The name or ID of a instance.
:param bool ignore_missing: When set to ``False`` :param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.ResourceNotFound` will be :class:`~openstack.exceptions.ResourceNotFound` will be
raised when the resource does not exist. raised when the resource does not exist.
When set to ``True``, None will be returned when When set to ``True``, None will be returned when
attempting to find a nonexistent resource. attempting to find a nonexistent resource.
:returns: One :class:`~openstack.database.v1.instance.Instance` or None :returns: One :class:`~openstack.database.v1.instance.Instance` or None
""" """
return self._find(_instance.Instance, name_or_id, return self._find(_instance.Instance, name_or_id,
@ -190,12 +190,12 @@ class Proxy(proxy.Proxy):
"""Get a single instance """Get a single instance
:param instance: The value can be the ID of an instance or a :param instance: The value can be the ID of an instance or a
:class:`~openstack.database.v1.instance.Instance` :class:`~openstack.database.v1.instance.Instance`
instance. instance.
:returns: One :class:`~openstack.database.v1.instance.Instance` :returns: One :class:`~openstack.database.v1.instance.Instance`
:raises: :class:`~openstack.exceptions.ResourceNotFound` :raises: :class:`~openstack.exceptions.ResourceNotFound`
when no resource can be found. when no resource can be found.
""" """
return self._get(_instance.Instance, instance) return self._get(_instance.Instance, instance)
@ -203,7 +203,7 @@ class Proxy(proxy.Proxy):
"""Return a generator of instances """Return a generator of instances
:param kwargs query: Optional query parameters to be sent to limit :param kwargs query: Optional query parameters to be sent to limit
the resources being returned. the resources being returned.
:returns: A generator of instance objects :returns: A generator of instance objects
:rtype: :class:`~openstack.database.v1.instance.Instance` :rtype: :class:`~openstack.database.v1.instance.Instance`
@ -214,10 +214,10 @@ class Proxy(proxy.Proxy):
"""Update a instance """Update a instance
:param instance: Either the id of a instance or a :param instance: Either the id of a instance or a
:class:`~openstack.database.v1.instance.Instance` :class:`~openstack.database.v1.instance.Instance`
instance. instance.
:attrs kwargs: The attributes to update on the instance represented :attrs kwargs: The attributes to update on the instance represented
by ``value``. by ``value``.
:returns: The updated instance :returns: The updated instance
:rtype: :class:`~openstack.database.v1.instance.Instance` :rtype: :class:`~openstack.database.v1.instance.Instance`
@ -228,10 +228,10 @@ class Proxy(proxy.Proxy):
"""Create a new user from attributes """Create a new user from attributes
:param instance: This can be either the ID of an instance :param instance: This can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
:param dict attrs: Keyword arguments which will be used to create :param dict attrs: Keyword arguments which will be used to create
a :class:`~openstack.database.v1.user.User`, a :class:`~openstack.database.v1.user.User`,
comprised of the properties on the User class. comprised of the properties on the User class.
:returns: The results of server creation :returns: The results of server creation
:rtype: :class:`~openstack.database.v1.user.User` :rtype: :class:`~openstack.database.v1.user.User`
@ -243,16 +243,16 @@ class Proxy(proxy.Proxy):
"""Delete a user """Delete a user
:param user: The value can be either the ID of a user or a :param user: The value can be either the ID of a user or a
:class:`~openstack.database.v1.user.User` instance. :class:`~openstack.database.v1.user.User` instance.
:param instance: This parameter needs to be specified when :param instance: This parameter needs to be specified when
an ID is given as `user`. an ID is given as `user`.
It can be either the ID of an instance It can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
:param bool ignore_missing: When set to ``False`` :param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.ResourceNotFound` will be :class:`~openstack.exceptions.ResourceNotFound` will be
raised when the user does not exist. raised when the user does not exist.
When set to ``True``, no exception will be set when When set to ``True``, no exception will be set when
attempting to delete a nonexistent user. attempting to delete a nonexistent user.
:returns: ``None`` :returns: ``None``
""" """
@ -265,12 +265,12 @@ class Proxy(proxy.Proxy):
:param name_or_id: The name or ID of a user. :param name_or_id: The name or ID of a user.
:param instance: This can be either the ID of an instance :param instance: This can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
:param bool ignore_missing: When set to ``False`` :param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.ResourceNotFound` will be :class:`~openstack.exceptions.ResourceNotFound` will be
raised when the resource does not exist. raised when the resource does not exist.
When set to ``True``, None will be returned when When set to ``True``, None will be returned when
attempting to find a nonexistent resource. attempting to find a nonexistent resource.
:returns: One :class:`~openstack.database.v1.user.User` or None :returns: One :class:`~openstack.database.v1.user.User` or None
""" """
instance = self._get_resource(_instance.Instance, instance) instance = self._get_resource(_instance.Instance, instance)
@ -281,9 +281,9 @@ class Proxy(proxy.Proxy):
"""Return a generator of users """Return a generator of users
:param instance: This can be either the ID of an instance :param instance: This can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
:param kwargs query: Optional query parameters to be sent to limit :param kwargs query: Optional query parameters to be sent to limit
the resources being returned. the resources being returned.
:returns: A generator of user objects :returns: A generator of user objects
:rtype: :class:`~openstack.database.v1.user.User` :rtype: :class:`~openstack.database.v1.user.User`
@ -295,15 +295,15 @@ class Proxy(proxy.Proxy):
"""Get a single user """Get a single user
:param user: The value can be the ID of a user or a :param user: The value can be the ID of a user or a
:class:`~openstack.database.v1.user.User` instance. :class:`~openstack.database.v1.user.User` instance.
:param instance: This parameter needs to be specified when :param instance: This parameter needs to be specified when
an ID is given as `database`. an ID is given as `database`.
It can be either the ID of an instance It can be either the ID of an instance
or a :class:`~openstack.database.v1.instance.Instance` or a :class:`~openstack.database.v1.instance.Instance`
:returns: One :class:`~openstack.database.v1.user.User` :returns: One :class:`~openstack.database.v1.user.User`
:raises: :class:`~openstack.exceptions.ResourceNotFound` :raises: :class:`~openstack.exceptions.ResourceNotFound`
when no resource can be found. when no resource can be found.
""" """
instance = self._get_resource(_instance.Instance, instance) instance = self._get_resource(_instance.Instance, instance)
return self._get(_user.User, user) return self._get(_user.User, user)

40
openstack/workflow/v2/_proxy.py
View File

@ -21,8 +21,8 @@ class Proxy(proxy.Proxy):
"""Create a new workflow from attributes """Create a new workflow from attributes
:param dict attrs: Keyword arguments which will be used to create :param dict attrs: Keyword arguments which will be used to create
a :class:`~openstack.workflow.v2.workflow.Workflow`, a :class:`~openstack.workflow.v2.workflow.Workflow`,
comprised of the properties on the Workflow class. comprised of the properties on the Workflow class.
:returns: The results of workflow creation :returns: The results of workflow creation
:rtype: :class:`~openstack.workflow.v2.workflow.Workflow` :rtype: :class:`~openstack.workflow.v2.workflow.Workflow`
@ -33,11 +33,11 @@ class Proxy(proxy.Proxy):
"""Get a workflow """Get a workflow
:param workflow: The value can be the name of a workflow or :param workflow: The value can be the name of a workflow or
:class:`~openstack.workflow.v2.workflow.Workflow` instance. :class:`~openstack.workflow.v2.workflow.Workflow` instance.
:returns: One :class:`~openstack.workflow.v2.workflow.Workflow` :returns: One :class:`~openstack.workflow.v2.workflow.Workflow`
:raises: :class:`~openstack.exceptions.ResourceNotFound` when no :raises: :class:`~openstack.exceptions.ResourceNotFound` when no
workflow matching the name could be found. workflow matching the name could be found.
""" """
return self._get(_workflow.Workflow, *attrs) return self._get(_workflow.Workflow, *attrs)
@ -49,11 +49,11 @@ class Proxy(proxy.Proxy):
include: include:
* limit: Requests at most the specified number of items be * limit: Requests at most the specified number of items be
returned from the query. returned from the query.
* marker: Specifies the ID of the last-seen workflow. Use the * marker: Specifies the ID of the last-seen workflow. Use the
limit parameter to make an initial limited request and use limit parameter to make an initial limited request and use
the ID of the last-seen workflow from the response as the the ID of the last-seen workflow from the response as the
marker parameter value in a subsequent limited request. marker parameter value in a subsequent limited request.
:returns: A generator of workflow instances. :returns: A generator of workflow instances.
""" """
@ -63,8 +63,8 @@ class Proxy(proxy.Proxy):
"""Delete a workflow """Delete a workflow
:param value: The value can be either the name of a workflow or a :param value: The value can be either the name of a workflow or a
:class:`~openstack.workflow.v2.workflow.Workflow` :class:`~openstack.workflow.v2.workflow.Workflow`
instance. instance.
:param bool ignore_missing: When set to ``False`` :param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.ResourceNotFound` will :class:`~openstack.exceptions.ResourceNotFound` will
be raised when the workflow does not exist. be raised when the workflow does not exist.
@ -125,11 +125,11 @@ class Proxy(proxy.Proxy):
include: include:
* limit: Requests at most the specified number of items be * limit: Requests at most the specified number of items be
returned from the query. returned from the query.
* marker: Specifies the ID of the last-seen execution. Use the * marker: Specifies the ID of the last-seen execution. Use the
limit parameter to make an initial limited request and use limit parameter to make an initial limited request and use
the ID of the last-seen execution from the response as the the ID of the last-seen execution from the response as the
marker parameter value in a subsequent limited request. marker parameter value in a subsequent limited request.
:returns: A generator of execution instances. :returns: A generator of execution instances.
""" """
@ -139,13 +139,13 @@ class Proxy(proxy.Proxy):
"""Delete an execution """Delete an execution
:param value: The value can be either the name of a execution or a :param value: The value can be either the name of a execution or a
:class:`~openstack.workflow.v2.execute.Execution` :class:`~openstack.workflow.v2.execute.Execution`
instance. instance.
:param bool ignore_missing: When set to ``False`` :param bool ignore_missing: When set to ``False``
:class:`~openstack.exceptions.ResourceNotFound` will be :class:`~openstack.exceptions.ResourceNotFound` will be
raised when the execution does not exist. raised when the execution does not exist.
When set to ``True``, no exception will be set when When set to ``True``, no exception will be set when
attempting to delete a nonexistent execution. attempting to delete a nonexistent execution.
:returns: ``None`` :returns: ``None``
""" """