ansible

Commit Graph

Author	SHA1	Message	Date
Felix Fontein	b398613120	Add support for plugin field in seealso. (#80212 )	2 years ago
Felix Fontein	fafb23094e	ansible-doc: fix broken seealso links in text output (#80280 ) * Fix broken URLs. * Also remove auto-generated description for modules outside ansible.builtin.	2 years ago
Felix Fontein	a2dc5fcc7d	Implement semantic markup support for Ansible documentation in ansible-doc. (#80242 )	2 years ago
Matt Clay	7495070b83	Clean up unused imports in integration tests (#79895 )	2 years ago
Matt Martz	56d142350d	Add support for importlib.resources (#78915 ) * Add support for importlib.resources * Remove the importlib.resources imports * return the correct data * Some code comments, and re-order for consistency * Disallow traversing packages below an individual collection * Add a traversable class for namespaces * Re-use variable * Utilize itertools.chain.from_iterable Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua> * Simplify logic to check for packages from ansible loaders Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua> * Just a generator expression, instead of a generator * docstrings * Add comment about find_spec for our namespaces * Add some initial unit tests for importlib.resources * normalize * Utilize importlib.resources for listing collections * collections_path is already in config, just use config * install uses a different default for collections_path * Remove unused import * Remove duplicate __truediv__ * Bring back TraversableResources * Apply some small suggestions from code review Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua> Co-authored-by: Matt Davis <6775756+nitzmahone@users.noreply.github.com> * Remove cross contamination between plugin loader code and CLI code * Remove unused import Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua> Co-authored-by: Matt Davis <6775756+nitzmahone@users.noreply.github.com>	2 years ago
Sloane Hertel	86b86398f0	add ansible_name/ansible_aliases attrs to plugin objects (#78700 ) * new _fqcn attribute to plugin objects * unbreak plugins in subdirs * Fix inadventent changes to _load_name and use existing vars * add plugin aliases and name property, and replace plugin._load_name where incorrect * Fix listing plugin names Fix listing legacy and builtin together test deprecated plugin documentation fix doc extensions remove sometimes inaccurate _load_name handling from plugin.name * Add tests for REJECT_EXTS and doc extensions Fix unpredictable collection redirects so non-fqcns in the redirect list are guaranteed to be legacy (instead of determined by the collections keyword) Move aliases and name properties to _update_object so all plugin types, including doc fragments, can use them * make legacy plugin names internally consistent * rename attributes to ansible_name and ansible_aliases	2 years ago
Brian Coca	4260b71cc7	refactor and fixes for doc parsing (#77719 ) * refactor and remove redundant code in documentation allow location and building api to be more accessible fix issues with displaying ansible.legacy and ansible.builtin ensure we don't x2 process tokens (some modules reference them also) fixes #77764 move to constants vs hardcoded more informative errors and comments now have actual filter/test plugins, which expose the filter/test functions moved filter/test loading/finding logic into jinja2pluginloader, removed dupe implementations added tests for case in which we unique by basename when listing Update lib/ansible/utils/plugin_docs.py Co-authored-by: Sloane Hertel <19572925+s-hertel@users.noreply.github.com>	2 years ago
Brian Coca	749a105956	ansible-doc stay 3.8 python compatible (#77682 ) pathlib with_stem will wait till 3.9 also add tests by listing filters	3 years ago
Matt Clay	f68c66a3ef	Remove collections compat from controller code.	3 years ago
Felix Fontein	a1ece49006	Add integration tests for add_collection_to_versions_and_dates(), and extend ansible-doc tests (#73601 ) * Add add_collection_to_versions_and_dates integration tests. * Add doc fragment tests with fragments from other collections. * Remove trailing whitespace (Python 2's json.dump inserts some). * Use ' ' instead of '\s'.	4 years ago
David Shrewsbury	3a18ef7159	Change role argspec file used by ansible-doc (#72927 ) * Change role argspec file used by ansible-doc This changes the file used for role argument specs from meta/argument_specs.yml to meta/main.yml. The argument specs are expected to be in that file under the top-level entry of `argument_spec`. * Switch to argument_specs	4 years ago
David Shrewsbury	570aed0913	ansible-doc role arg spec support (#72120 ) * Support listing roles in text and JSON * Change tests for unfrack'd playbook_dir var These tests were using '/tmp' for testing the setting of the playbook_dir var. Now that we unfrack that var, MacOS will change this to '/private/tmp' causing the tests to fail. We can choose a path that does not exist (since unfrack does not validate existence) so that we can guarantee unfracking will not change the value.	4 years ago
Brian Coca	e05c62547b	run playbook from collections (#67435 ) * fixes for collection playbooks - add fqcn invocation, also handles extensions - bring import_playbook into new normal - avoid adding collection playbooks to adjacency - deal with extensions or lack of em - added tests - fix bugs with multiple playbooks supplied - unicode/bytes/native fixes - fix modulenotfound for < py3.7 - tests	4 years ago
Felix Fontein	f4c89eab23	ansible-doc: include collection name in text output (#70401 ) * ansible-doc: include collection name in text output * Be more careful to not accidentally pass ansible.builtin for user-supplied modules.	4 years ago
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.	5 years ago
Brian Coca	23ab8f37df	fix a-doc listing plugins and add tests (#68600 ) * add docs listing tests * added collection module docs test * always safe_load * force 'type consistency' for uniquing paths * bytified * use our json encoder Co-Authored-By: Matt Clay <matt@mystile.com>	5 years ago

16 Commits (a81b787a0510098686cf0263dd8b90bd0189e951)