d9b3af523b
* Use an rst table instead of a raw html table * Rst is easier to read so we want to use it wherever possible * Fix the jinja2 filters which create links so that they do not include extraneous whitespace in the URL * Normalize description data before sending them to the templates
78 lines
3.2 KiB
Python
78 lines
3.2 KiB
Python
# coding: utf-8
|
|
# Copyright: (c) 2019, Ansible Project
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
# Make coding more python3-ish
|
|
from __future__ import (absolute_import, division, print_function)
|
|
__metaclass__ = type
|
|
|
|
import os
|
|
import os.path
|
|
import pathlib
|
|
|
|
import yaml
|
|
from jinja2 import Environment, FileSystemLoader
|
|
from ansible.module_utils.six import string_types
|
|
from ansible.module_utils._text import to_bytes
|
|
|
|
# Pylint doesn't understand Python3 namespace modules.
|
|
from ..change_detection import update_file_if_different # pylint: disable=relative-beyond-top-level
|
|
from ..commands import Command # pylint: disable=relative-beyond-top-level
|
|
from ..jinja2.filters import documented_type, rst_ify # pylint: disable=relative-beyond-top-level
|
|
|
|
|
|
DEFAULT_TEMPLATE_FILE = 'collections_galaxy_meta.rst.j2'
|
|
DEFAULT_TEMPLATE_DIR = pathlib.Path(__file__).parents[4] / 'docs/templates'
|
|
|
|
|
|
def normalize_options(options):
|
|
"""Normalize the options to make for easy templating"""
|
|
for opt in options:
|
|
if isinstance(opt['description'], string_types):
|
|
opt['description'] = [opt['description']]
|
|
|
|
|
|
class DocumentCollectionMeta(Command):
|
|
name = 'collection-meta'
|
|
|
|
@classmethod
|
|
def init_parser(cls, add_parser):
|
|
parser = add_parser(cls.name, description='Generate collection galaxy.yml documentation from shared metadata')
|
|
parser.add_argument("-t", "--template-file", action="store", dest="template_file",
|
|
default=DEFAULT_TEMPLATE_FILE,
|
|
help="Jinja2 template to use for the config")
|
|
parser.add_argument("-T", "--template-dir", action="store", dest="template_dir",
|
|
default=DEFAULT_TEMPLATE_DIR,
|
|
help="directory containing Jinja2 templates")
|
|
parser.add_argument("-o", "--output-dir", action="store", dest="output_dir", default='/tmp/',
|
|
help="Output directory for rst files")
|
|
parser.add_argument("collection_defs", metavar="COLLECTION-OPTION-DEFINITIONS.yml", type=str,
|
|
help="Source for collection metadata option docs")
|
|
|
|
@staticmethod
|
|
def main(args):
|
|
output_dir = os.path.abspath(args.output_dir)
|
|
template_file_full_path = os.path.abspath(os.path.join(args.template_dir, args.template_file))
|
|
template_file = os.path.basename(template_file_full_path)
|
|
template_dir = os.path.dirname(template_file_full_path)
|
|
|
|
with open(args.collection_defs) as f:
|
|
options = yaml.safe_load(f)
|
|
|
|
normalize_options(options)
|
|
|
|
env = Environment(loader=FileSystemLoader(template_dir),
|
|
variable_start_string="@{",
|
|
variable_end_string="}@",
|
|
trim_blocks=True)
|
|
env.filters['documented_type'] = documented_type
|
|
env.filters['rst_ify'] = rst_ify
|
|
|
|
template = env.get_template(template_file)
|
|
output_name = os.path.join(output_dir, template_file.replace('.j2', ''))
|
|
temp_vars = {'options': options}
|
|
|
|
data = to_bytes(template.render(temp_vars))
|
|
update_file_if_different(output_name, data)
|
|
|
|
return 0
|