mirror of
https://github.com/freeipa/ansible-freeipa.git
synced 2026-05-14 05:22:05 +00:00
Doc string improvements
This commit is contained in:
@@ -63,7 +63,7 @@ if six.PY3:
|
|||||||
|
|
||||||
|
|
||||||
def valid_creds(module, principal): # noqa
|
def valid_creds(module, principal): # noqa
|
||||||
"""Get valid credintials matching the princial, try GSSAPI first."""
|
"""Get valid credentials matching the princial, try GSSAPI first."""
|
||||||
if "KRB5CCNAME" in os.environ:
|
if "KRB5CCNAME" in os.environ:
|
||||||
ccache = os.environ["KRB5CCNAME"]
|
ccache = os.environ["KRB5CCNAME"]
|
||||||
module.debug('KRB5CCNAME set to %s' % ccache)
|
module.debug('KRB5CCNAME set to %s' % ccache)
|
||||||
@@ -127,7 +127,14 @@ def temp_kdestroy(ccache_dir, ccache_name):
|
|||||||
|
|
||||||
|
|
||||||
def api_connect(context=None):
|
def api_connect(context=None):
|
||||||
"""Create environment, initialize api and connect to ldap2."""
|
"""
|
||||||
|
Initialize IPA API with the provided context.
|
||||||
|
|
||||||
|
`context` can be any of:
|
||||||
|
* `server` (default)
|
||||||
|
* `ansible-freeipa`
|
||||||
|
* `cli_installer`
|
||||||
|
"""
|
||||||
env = Env()
|
env = Env()
|
||||||
env._bootstrap()
|
env._bootstrap()
|
||||||
env._finalize_core(**dict(DEFAULT_CONFIG))
|
env._finalize_core(**dict(DEFAULT_CONFIG))
|
||||||
@@ -159,7 +166,7 @@ def api_command_no_name(module, command, args):
|
|||||||
|
|
||||||
|
|
||||||
def api_check_param(command, name):
|
def api_check_param(command, name):
|
||||||
"""Return if param exists in command param list."""
|
"""Check if param exists in command param list."""
|
||||||
return name in api.Command[command].params
|
return name in api.Command[command].params
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -135,7 +135,7 @@ if six.PY3:
|
|||||||
|
|
||||||
def get_host_diff(ipa_host, module_host):
|
def get_host_diff(ipa_host, module_host):
|
||||||
"""
|
"""
|
||||||
Compare two host dicts and builds a dict of differences.
|
Build a dict with the differences from two host dicts.
|
||||||
|
|
||||||
:param ipa_host: the host structure seen from IPA
|
:param ipa_host: the host structure seen from IPA
|
||||||
:param module_host: the target host structure seen from the module params
|
:param module_host: the target host structure seen from the module params
|
||||||
@@ -188,7 +188,7 @@ def get_module_host(module):
|
|||||||
|
|
||||||
def ensure_host_present(module, api, ipahost):
|
def ensure_host_present(module, api, ipahost):
|
||||||
"""
|
"""
|
||||||
Ensure that the host exists in IPA and has the same attributes.
|
Ensure host exists in IPA and has the same attributes.
|
||||||
|
|
||||||
:param module: the ansible module
|
:param module: the ansible module
|
||||||
:param api: IPA api handle
|
:param api: IPA api handle
|
||||||
@@ -245,7 +245,7 @@ def ensure_host_present(module, api, ipahost):
|
|||||||
|
|
||||||
def ensure_host_absent(module, api, host):
|
def ensure_host_absent(module, api, host):
|
||||||
"""
|
"""
|
||||||
Ensure that the host does not exist in IPA.
|
Ensure host does not exist in IPA.
|
||||||
|
|
||||||
:param module: the ansible module
|
:param module: the ansible module
|
||||||
:param api: the IPA API handle
|
:param api: the IPA API handle
|
||||||
|
|||||||
Reference in New Issue
Block a user