Show params in use for lookup and filter plugins (#18)

* Dedicated DOCUMENTATION for get_path

* Comment out cross collection example

* Remove sanity exception, unneeded

* Remove extra empty lines

* Dedicated DOCUMENTATION for index_of filter plugin

* Dedicated DOCUMENTATION for to_paths filter plugin

* Add rst docs for filter plugins, update README

* lint and pep8 fixes

* filter plugin doc update for wantlist

* Because doc keys are sorted, add example of options in use

* Update docs

Co-authored-by: cidrblock <brad@thethorntons.net>

docs/ansible.utils.get_path_filter.rst

@@ -19,6 +19,7 @@ Synopsis
 --------
 - Use a ``path`` to retreive a nested value from a ``var``
 - ``get_path`` is also available as a ``lookup plugin`` for convenience
+- Using the parameters below- ``var|ansible.utils.get_path(path, wantlist``)
 
 
 

docs/ansible.utils.get_path_lookup.rst

@@ -19,6 +19,7 @@ Synopsis
 --------
 - Use a ``path`` to retreive a nested value from a ``var``
 - ``get_path`` is also available as a ``filter plugin`` for convenience
+- Using the parameters below- ``lookup('ansible.utils.get_path', var, path, wantlist``)
 
 
 

docs/ansible.utils.index_of_filter.rst

@@ -20,6 +20,7 @@ Synopsis
 - This plugin returns the indicies of items matching some criteria in a list
 - When working with a list of dictionaries, the key to evaluate can be specified
 - ``index_of`` is also available as a ``lookup plugin`` for convenience
+- Using the parameters below- ``data|ansible.utils.index_of(test, value, key, fail_on_missing, wantlist``)
 
 
 

docs/ansible.utils.index_of_lookup.rst

@@ -20,6 +20,7 @@ Synopsis
 - This plugin returns the indicies of items matching some criteria in a list
 - When working with a list of dictionaries, the key to evaluate can be specified
 - ``index_of`` is also available as a ``filter plugin`` for convenience
+- Using the parameters below- ``lookup('ansible.utils.index_of', data, test, value, key, fail_on_missing, wantlist``)
 
 
 

docs/ansible.utils.to_paths_filter.rst

@@ -21,6 +21,7 @@ Synopsis
 - Paths are dot delimited whenever possible
 - Brakets are used for list indicies and keys that contain special characters
 - ``to_paths`` is also available as a ``lookup plugin`` for convenience
+- Using the parameters below- ``var|ansible.utils.to_paths(prepend, wantlist``)
 
 
 

docs/ansible.utils.to_paths_lookup.rst

@@ -21,6 +21,7 @@ Synopsis
 - Paths are dot delimited whenever possible
 - Brakets are used for list indicies and keys that contain special characters
 - ``to_paths`` is also available as a filter plugin
+- Using the parameters below- ``lookup('ansible.utils.to_paths', var, prepend, wantlist``)
 
 
 

plugins/filter/get_path.py

@@ -19,6 +19,7 @@ DOCUMENTATION = """
     description:
         - Use a C(path) to retreive a nested value from a C(var)
         - C(get_path) is also available as a C(lookup plugin) for convenience
+        - Using the parameters below- C(var|ansible.utils.get_path(path, wantlist))
     options:
       var:
         description:

plugins/filter/index_of.py

@@ -20,6 +20,7 @@ DOCUMENTATION = """
         - This plugin returns the indicies of items matching some criteria in a list
         - When working with a list of dictionaries, the key to evaluate can be specified
         - C(index_of) is also available as a C(lookup plugin) for convenience
+        - Using the parameters below- C(data|ansible.utils.index_of(test, value, key, fail_on_missing, wantlist))
     options:
       data:
         description:

plugins/filter/to_paths.py

@@ -22,6 +22,7 @@ DOCUMENTATION = """
         - Paths are dot delimited whenever possible
         - Brakets are used for list indicies and keys that contain special characters
         - C(to_paths) is also available as a C(lookup plugin) for convenience
+        - Using the parameters below- C(var|ansible.utils.to_paths(prepend, wantlist))
     options:
       var:
         description:

plugins/lookup/get_path.py

@@ -20,6 +20,7 @@ DOCUMENTATION = """
     description:
         - Use a C(path) to retreive a nested value from a C(var)
         - C(get_path) is also available as a C(filter plugin) for convenience
+        - Using the parameters below- C(lookup('ansible.utils.get_path', var, path, wantlist))
     options:
       var:
         description: The variable from which the value should be extraced

plugins/lookup/index_of.py

@@ -21,6 +21,7 @@ DOCUMENTATION = """
         - This plugin returns the indicies of items matching some criteria in a list
         - When working with a list of dictionaries, the key to evaluate can be specified
         - C(index_of) is also available as a C(filter plugin) for convenience
+        - Using the parameters below- C(lookup('ansible.utils.index_of', data, test, value, key, fail_on_missing, wantlist))
     options:
       data:
         description: A list of items to enumerate and test against

plugins/lookup/to_paths.py

@@ -22,6 +22,7 @@ DOCUMENTATION = """
         - Paths are dot delimited whenever possible
         - Brakets are used for list indicies and keys that contain special characters
         - C(to_paths) is also available as a filter plugin
+        - Using the parameters below- C(lookup('ansible.utils.to_paths', var, prepend, wantlist))
     options:
       var:
         description: The value of C(var) will be will be used.