Only generate one documentation file per class. (googleapis#6272)

Speeds up BigQuery documentation generation by only generating one file per class instead of one file per method and attribute.
nomtrosk · Oct 19, 2018 · a74dc33 · a74dc33
1 parent 05dea1b
commit a74dc33
Showing 1 changed file with 28 additions and 27 deletions.
diff --git a/third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/class.rst b/third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/class.rst
@@ -2,34 +2,35 @@
 
 .. currentmodule:: {{ module }}
 
-.. autoclass:: {{ objname }}
+{% block methods %}
+{% if methods %}
+.. rubric:: Methods
 
-   {% block methods %}
-   .. automethod:: __init__
-
-   {% if methods %}
-   .. rubric:: Methods
-
-   {# Customized from original by adding toctree. This generates docs for the
-   listed functions. #}
-   .. autosummary::
-      :toctree: .
-   {% for item in methods %}
-      {% if item != '__init__' %}
-      ~{{ name }}.{{ item }}
-      {% endif %}
-   {%- endfor %}
+.. autosummary::
+{% for item in methods %}
+   {% if item != '__init__' %}
+   ~{{ name }}.{{ item }}
    {% endif %}
-   {% endblock %}
+{%- endfor %}
+{% endif %}
+{% endblock %}
 
-   {% block attributes %}
-   {% if attributes %}
-   .. rubric:: Attributes
+{% block attributes %}
+{% if attributes %}
+.. rubric:: Attributes
 
-   .. autosummary::
-      :toctree: .
-   {% for item in attributes %}
-      ~{{ name }}.{{ item }}
-   {%- endfor %}
-   {% endif %}
-   {% endblock %}
+.. autosummary::
+{% for item in attributes %}
+   ~{{ name }}.{{ item }}
+{%- endfor %}
+{% endif %}
+{% endblock %}
+
+.. raw:: html
+
+    <p>
+    <hr>
+    <p>
+
+.. autoclass:: {{ objname }}
+   :members: