blob: 71ae7c1145ce8f2a5f23d1a637930dfe384449fa (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
#!/usr/bin/python
from __future__ import (absolute_import, division, print_function)
__metaclass__ = type
DOCUMENTATION = r'''
---
module: randommodule
short_description: A random module
description:
- A random module.
- See O(foo.bar.baz#role:main:foo=bar) for how this is used in the P(foo.bar.baz#role)'s C(main) entrypoint.
author:
- Ansible Core Team
version_added: 1.0.0
deprecated:
alternative: Use some other module
why: Test deprecation
removed_in: '3.0.0'
options:
test:
description: Some text. Consider not using O(ignore:foo=bar).
type: str
version_added: 1.2.0
sub:
description: Suboptions. Contains O(sub.subtest), which can be set to V(123). You can use E(TEST_ENV) to set this.
type: dict
suboptions:
subtest:
description: A suboption. Not compatible to O(ansible.builtin.copy#module:path=c:\\foo\(1\).txt).
type: int
version_added: 1.1.0
# The following is the wrong syntax, and should not get processed
# by add_collection_to_versions_and_dates()
options:
subtest2:
description: Another suboption. Useful when P(ansible.builtin.shuffle#filter) is used with value V([a,b,\),d\\]).
type: float
version_added: 1.1.0
# The following is not supported in modules, and should not get processed
# by add_collection_to_versions_and_dates()
env:
- name: TEST_ENV
version_added: 1.0.0
deprecated:
alternative: none
why: Test deprecation
removed_in: '2.0.0'
version: '2.0.0'
extends_documentation_fragment:
- testns.testcol2.module
seealso:
- module: ansible.builtin.ping
- module: ansible.builtin.uri
description: Use this to fetch an URI
- module: testns.testcol.test
- module: testns.testcol.fakemodule
description: A fake module
- link: https://docs.ansible.com
name: Ansible docsite
description: See also the Ansible docsite.
- ref: foo_bar
description: Some foo bar.
'''
EXAMPLES = '''
'''
RETURN = r'''
z_last:
description: A last result.
type: str
returned: success
version_added: 1.3.0
m_middle:
description:
- This should be in the middle.
- Has some more data.
- Check out RV(m_middle.suboption) and compare it to RV(a_first=foo) and RV(community.general.foo#lookup:value).
type: dict
returned: success and 1st of month
contains:
suboption:
description: A suboption.
type: str
choices: [ARF, BARN, c_without_capital_first_letter]
version_added: 1.4.0
a_first:
description: A first result. Use RV(a_first=foo\(bar\\baz\)bam).
type: str
returned: success
'''
from ansible.module_utils.basic import AnsibleModule
def main():
module = AnsibleModule(
argument_spec=dict(),
)
module.exit_json()
if __name__ == '__main__':
main()
|