{%- macro automodule(modname, options) -%}

.. automodule:: {{ modname }}

{%- for option in options %}

   :{{ option }}:

{%- endfor %}

{%- endmacro %}

{%- macro toctree(docnames) -%}

.. toctree::

   :maxdepth: {{ maxdepth }}

{% for docname in docnames %}

   {{ docname }}

{%- endfor %}

{%- endmacro %}

{%- if is_namespace %}

{{- pkgname | e | heading }}

{% else %}

{{- pkgname | e | heading }}

{% endif %}

{%- if modulefirst and not is_namespace %}

{{ automodule(pkgname, automodule_options) }}

{% endif %}

{{ toctree(subpackages) }}

{%- if submodules %}

{% if separatemodules %}

{{ toctree(submodules) }}

{% else %}

{%- for submodule in submodules %}

{% if show_headings %}

{{- submodule | e | heading(2) }}

{% endif %}

{{ automodule(submodule, automodule_options) }}

{% endfor %}

{%- endif %}

{%- endif %}

{%- if not modulefirst and not is_namespace %}

Module contents

---------------

{{ automodule(pkgname, automodule_options) }}

{% endif %}