mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
a1c21f8400
Previously it also built the MANPAGES target requiring asciidoc and libxml, before starting a 'make docs' in docsite. Also change the #! line in hacking/dump_playbook_attributes.py to not specify python2... yet.
48 lines
1.6 KiB
Python
Executable file
48 lines
1.6 KiB
Python
Executable file
#!/usr/bin/env python
|
|
|
|
import optparse
|
|
from jinja2 import Environment, FileSystemLoader
|
|
|
|
from ansible.playbook import Play
|
|
from ansible.playbook.block import Block
|
|
from ansible.playbook.role import Role
|
|
from ansible.playbook.task import Task
|
|
|
|
template_file = 'playbooks_directives.rst.j2'
|
|
oblist = {}
|
|
clist = []
|
|
class_list = [ Play, Role, Block, Task ]
|
|
|
|
p = optparse.OptionParser(
|
|
version='%prog 1.0',
|
|
usage='usage: %prog [options]',
|
|
description='Generate module documentation from metadata',
|
|
)
|
|
p.add_option("-T", "--template-dir", action="store", dest="template_dir", default="hacking/templates", help="directory containing Jinja2 templates")
|
|
p.add_option("-o", "--output-dir", action="store", dest="output_dir", default='/tmp/', help="Output directory for rst files")
|
|
|
|
(options, args) = p.parse_args()
|
|
|
|
for aclass in class_list:
|
|
aobj = aclass()
|
|
name = type(aobj).__name__
|
|
|
|
# build ordered list to loop over and dict with attributes
|
|
clist.append(name)
|
|
oblist[name] = {x: aobj.__dict__['_attributes'][x] for x in aobj.__dict__['_attributes'] if 'private' not in x or not x.private}
|
|
|
|
# loop is really with_ for users
|
|
if name == 'Task':
|
|
oblist[name]['with_<lookup_plugin>'] = True
|
|
|
|
# local_action is implicit with action
|
|
if 'action' in oblist[name]:
|
|
oblist[name]['local_action'] = True
|
|
|
|
env = Environment(loader=FileSystemLoader(options.template_dir), trim_blocks=True,)
|
|
template = env.get_template(template_file)
|
|
outputname = options.output_dir + template_file.replace('.j2','')
|
|
tempvars = { 'oblist': oblist, 'clist': clist }
|
|
|
|
with open( outputname, 'w') as f:
|
|
f.write(template.render(tempvars))
|