ansible/lib/ansible/parsing
Felix Fontein 8d93ba9120
Plugin/module docs: parse return values, add collection names in them (version_added_collection), and format them nicely in ansible-doc (#69796)
* Tag return value docs if they are a dict (and not str/None).

* Try to parse return docs as YAML.

* Properly dump return values in ansible-doc.

* Adjust plugin formatter.

* Add changelog fragment.

* Don't add 'default' for return values.

* Fix plugin_formatter.

* Only try to parse return docs if they are still a string.

* Add tests.

* Warn if RETURN cannot be parsed.

* Adjust tests. Also test for warning.

* if -> elif (otherwise EXAMPLE will be parsed too).

* Always parse return documentation, and fail if it is invalid YAML.

* Polishing.

* Mostly re-enable ansible-doc tests.

Listing from the local collection seems to be somewhat broken. I assume this
is why the test was disabled.

* Lint and make tests work with Python 2.

* Keep FQCNs in plugins (not modules), i.e. restore previous state.
2020-06-11 11:03:43 -07:00
..
utils preserve json parsing error (#58461) 2020-05-01 15:03:07 -04:00
vault Make AnsibleVaultEncryptedUnicode work more like a string (#67823) 2020-06-08 16:30:14 -05:00
yaml Make AnsibleVaultEncryptedUnicode work more like a string (#67823) 2020-06-08 16:30:14 -05:00
__init__.py
ajson.py Properly JSON encode AnsibleUnsafe, using a pre-processor (#60602) 2019-08-26 09:08:22 -05:00
dataloader.py Spelling: dependant -> dependent (#69661) 2020-05-22 11:24:25 +05:30
mod_args.py support hard coded module_defaults.yml groups for collections (#69919) 2020-06-09 15:38:57 -07:00
plugin_docs.py Plugin/module docs: parse return values, add collection names in them (version_added_collection), and format them nicely in ansible-doc (#69796) 2020-06-11 11:03:43 -07:00
quoting.py
splitter.py core: Handle empty extra vars in cli (#61831) 2019-09-12 15:43:41 -04:00