Start breaking out templates

Author: lgarber-akamai

linodecli/documentation/templates/_macros.rst.j2

@@ -0,0 +1,11 @@
+{% macro group_action_subheading(title, description) %}
+
+.. rst-class:: action-subheading
+
+{{ title }}
+
+.. rst-class:: action-subheading-description
+
+{{ description }}
+
+{% endmacro %}

linodecli/documentation/templates/_roles.rst.j2

@@ -0,0 +1,7 @@
+.. role:: action-table-field-name
+.. role:: action-table-field-optional
+.. role:: action-table-field-required
+.. role:: action-table-field-type
+
+.. role:: json(code)
+    :language: JSON

linodecli/documentation/templates/group.rst.j2

@@ -1,218 +1,11 @@
-.. role:: action-table-field-name
-.. role:: action-table-field-optional
-.. role:: action-table-field-required
-.. role:: action-table-field-type
-
-.. role:: json(code)
-    :language: JSON
-
-{% macro action_details(action) %}
-{% set action_title = action.action[0] %}
-{% set action_title_format = "`%s <%s>`_" % (action_title, action.api_documentation_url) if action.api_documentation_url else action_title %}
-.. _commands_{{ action.command }}_{{ action.action[0] }}:
-
-{{ action_title_format }}
-{{ "-" * (action_title_format | length) }}
-{% if action.action | length > 1 %}
-
-*Aliases: {{ action[1:] | join(", ") }}*
-{% endif %}
-
-{% if action.deprecated %}
-.. warning::
-    This command is deprecated and may not be supported in the future.
-{% endif %}
-
-{{ action.description }}
-{% if action.usage %}
-
-.. rst-class:: action-subheading
-
-Usage
-
-.. rst-class:: action-subheading-description
-
-The format accepted by this command.
-
-..  code-block:: bash
-
-{{ action.usage | indent(first=True) }}
-
-{% endif %}
-{% if action.samples | length > 0 %}
-
-.. rst-class:: action-subheading
-
-Sample{% if action.samples | length > 1 %}s{% endif %}
-
-
-.. rst-class:: action-subheading-description
-
-Examples of how this command might be used.
-
-{% for sample in action.samples %}
-
-..  code-block:: bash
-
-{{ sample | indent(first=True) }}
-
-{% endfor %}
-{% endif %}
-{% if action.parameters | length > 0 %}
-
-.. rst-class:: action-subheading
-
-Parameters
-
-.. rst-class:: action-subheading-description
-
-Positional parameters used to define the resource this command should target.
-
-
-.. rst-class:: action-parameter-table
-
-..  list-table::
-    :header-rows: 1
-    :width: 100%
-    :widths: 1 1 98
-
-    * - Name
-      - Type
-      - Description
-
-{% for parameter in action.parameters %}
-    * - :action-table-field-name:`{{ parameter.name }}`
-      - :action-table-field-type:`{{ parameter.type }}`
-      - {% if parameter.description %}{{ parameter.description }}{% else %}N/A{% endif %}
-
-{% endfor %}
-{% endif %}
-{% if action.argument_sections | length > 0 %}
-
-.. rst-class:: action-subheading
-
-Arguments
-
-.. rst-class:: action-subheading-description
-
-Additional fields used to execute this request.
-
-{% for section in action.argument_sections %}
-{% if section.name | length > 0 %}
-.. _commands_{{ action.command }}_{{ action.action[0] }}_argument_sections_{{ section.name }}:
-
-.. rst-class:: action-section-header
-
-{{ section.name }}
-
-{% endif %}
-.. rst-class:: action-argument-section-table
-
-..  list-table::
-    :header-rows: 1
-    :width: 100%
-    :widths: 1 1 1 97
-
-    * - Name
-      - Required
-      - Type
-      - Description
-
-{% for argument in section.entries %}
-    * - :action-table-field-name:`\-\-{{ argument.path }}`
-    {% if argument.is_parent and argument.path in action.argument_sections_names %}
-        :ref:`(section) <commands_{{ action.command }}_{{ action.action[0] }}_argument_sections_{{ argument.path }}>`
-    {% endif %}
-      - {% if argument.required %}:action-table-field-required:`Yes`{% else %}:action-table-field-optional:`No`{% endif %}
-
-      - :action-table-field-type:`{{ argument.type }}`
-      - {% if argument.description %}{{ argument.description }}{% else %}N/A{% endif %}
-
-{% endfor %}
-{% endfor %}
-{% endif %}
-{% if action.filterable_attributes | length > 0 %}
-
-.. rst-class:: action-subheading
-
-Filterable Attributes
-
-.. rst-class:: action-subheading-description
-
-Arguments used to define a filter for response entries.
-
-.. rst-class:: action-filterable-field-table
-
-..  list-table::
-    :header-rows: 1
-    :width: 100%
-    :widths: 1 1 98
-
-    * - Name
-      - Type
-      - Description
-
-{% for attr in action.filterable_attributes %}
-    * - :action-table-field-name:`\-\-{{ attr.name }}`
-      - :action-table-field-type:`{{ attr.type }}`
-      - {% if attr.description %}{{ attr.description }}{% else %}N/A{% endif %}
-
-{% endfor %}
-{% endif %}
-{% if action.attribute_sections | length > 0%}
-
-.. rst-class:: action-subheading
-
-Result Attributes
-
-.. rst-class:: action-subheading-description
-
-The attributes returned by this command.
-
-.. rst-class:: action-attribute-table
-
-{% for section in action.attribute_sections %}
-{% if section.name | length > 0 %}
-.. _commands_{{ action.command }}_{{ action.action[0] }}_attribute_sections_{{ section.name }}:
-
-.. rst-class:: action-section-header
-
-{{ section.name }}
-
-{% endif %}
-.. rst-class:: action-attribute-section-table
-
-..  list-table::
-    :header-rows: 1
-    :width: 100%
-    :widths: 1 1 1 97
-
-    * - Name
-      - Type
-      - Example
-      - Description
-
-{% for attribute in section.entries %}
-    * - :action-table-field-name:`{{ attribute.name }}`
-    {% if attribute.name in action.attribute_sections_names %}
-        :ref:`(section) <commands_{{ action.command }}_{{ action.action[0] }}_attribute_sections_{{ attribute.path }}>`
-    {% endif %}
-      - :action-table-field-type:`{{ attribute.type }}`
-      - {% if attribute.example %}:json:`{{ attribute.example | tojson }}`{% else %}?{% endif %}
-
-      - {% if attribute.description %}{{ attribute.description }}{% else %}N/A{% endif %}
-
-{% endfor %}
-{% endfor %}
-{% endif %}
-{% endmacro %}
+{% import "group_action.rst.j2" as action_tmpl %}
 {{ pretty_name }}
 {{ "=" * (pretty_name | length) }}
 
 This section details {{ pretty_name[:-1] if pretty_name[-1] == "s" else pretty_name }}-related Linode CLI commands.
 
 {% for action in actions %}
-{{ action_details(action) }}
+{{ action_tmpl.render(action) }}
 
 {% if loop.index < (actions | length) - 1 %}
 ------------