forked from ansible/ansible
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add ansible-doc tests for documentation containing YAML anchors (ansi…
…ble#70436) Co-authored-by: Tadej Borovšak <[email protected]>
- Loading branch information
Showing
3 changed files
with
131 additions
and
0 deletions.
There are no files selected for viewing
71 changes: 71 additions & 0 deletions
71
test/integration/targets/ansible-doc/library/test_docs_yaml_anchors.py
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,71 @@ | ||
#!/usr/bin/python | ||
from __future__ import absolute_import, division, print_function | ||
__metaclass__ = type | ||
|
||
|
||
DOCUMENTATION = ''' | ||
--- | ||
module: test_docs_yaml_anchors | ||
short_description: Test module with YAML anchors in docs | ||
description: | ||
- Test module | ||
author: | ||
- Ansible Core Team | ||
options: | ||
at_the_top: &toplevel_anchor | ||
description: | ||
- Short desc | ||
default: some string | ||
type: str | ||
last_one: *toplevel_anchor | ||
egress: | ||
description: | ||
- Egress firewall rules | ||
type: list | ||
elements: dict | ||
suboptions: &sub_anchor | ||
port: | ||
description: | ||
- Rule port | ||
type: int | ||
required: true | ||
ingress: | ||
description: | ||
- Ingress firewall rules | ||
type: list | ||
elements: dict | ||
suboptions: *sub_anchor | ||
''' | ||
|
||
EXAMPLES = ''' | ||
''' | ||
|
||
RETURN = ''' | ||
''' | ||
|
||
|
||
from ansible.module_utils.basic import AnsibleModule | ||
|
||
|
||
def main(): | ||
module = AnsibleModule( | ||
argument_spec=dict( | ||
at_the_top=dict(type='str', default='some string'), | ||
last_one=dict(type='str', default='some string'), | ||
egress=dict(type='list', elements='dict', options=dict( | ||
port=dict(type='int', required=True), | ||
)), | ||
ingress=dict(type='list', elements='dict', options=dict( | ||
port=dict(type='int', required=True), | ||
)), | ||
), | ||
) | ||
|
||
module.exit_json() | ||
|
||
|
||
if __name__ == '__main__': | ||
main() |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
49 changes: 49 additions & 0 deletions
49
test/integration/targets/ansible-doc/test_docs_yaml_anchors.output
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,49 @@ | ||
> TEST_DOCS_YAML_ANCHORS (library/test_docs_yaml_anchors.py) | ||
|
||
Test module | ||
|
||
OPTIONS (= is mandatory): | ||
|
||
- at_the_top | ||
Short desc | ||
[Default: some string] | ||
type: str | ||
|
||
- egress | ||
Egress firewall rules | ||
[Default: (null)] | ||
elements: dict | ||
type: list | ||
|
||
SUBOPTIONS: | ||
|
||
= port | ||
Rule port | ||
|
||
type: int | ||
|
||
- ingress | ||
Ingress firewall rules | ||
[Default: (null)] | ||
elements: dict | ||
type: list | ||
|
||
SUBOPTIONS: | ||
|
||
= port | ||
Rule port | ||
|
||
type: int | ||
|
||
- last_one | ||
Short desc | ||
[Default: some string] | ||
type: str | ||
|
||
|
||
AUTHOR: Ansible Core Team | ||
|
||
EXAMPLES: | ||
|
||
|
||
|