Merge pull request #164 from bluescarni/pr/heyoka_updates

Updates for changes in the dtens API

doc/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line, and also
 # from the environment for the first two.
-SPHINXOPTS    ?= -nW --keep-going -j4
+SPHINXOPTS    ?= -nW --keep-going
 SPHINXBUILD   ?= sphinx-build
 SOURCEDIR     = .
 BUILDDIR      = _build

doc/_templates/custom-class-template.rst

@@ -0,0 +1,29 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :members:
+   :special-members: __init__
+
+   {% block methods %}
+   {% if methods %}
+   .. rubric:: {{ _('Methods') }}
+
+   .. autosummary::
+   {% for item in methods %}
+      ~{{ name }}.{{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: {{ _('Attributes') }}
+
+   .. autosummary::
+   {% for item in attributes %}
+      ~{{ name }}.{{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}

doc/_templates/custom-enum-template.rst

@@ -0,0 +1,6 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+

doc/api_exsys.rst

@@ -5,8 +5,30 @@ Expression system
 
 .. currentmodule:: heyoka
 
+Classes
+-------
+
 .. autosummary::
    :toctree: autosummary_generated
+   :template: custom-class-template.rst
 
    expression
+   dtens
+
+Functions
+---------
+
+.. autosummary::
+   :toctree: autosummary_generated
+
    make_vars
+   diff_tensors
+
+Enums
+-----
+
+.. autosummary::
+   :toctree: autosummary_generated
+   :template: custom-enum-template.rst
+
+   diff_args

doc/breaking_changes.rst

@@ -24,7 +24,9 @@ input arguments, turned out to be in practice confusing and a source of bugs.
 The affected APIs include:
 
 - :ref:`compiled functions <cfunc_tut>`, which now require the list of input
-  variables to be always supplied by the user.
+  variables to be always supplied by the user;
+- :func:`~heyoka.diff_tensors()`, which now requires an explicit list of differentiation
+  arguments to be always provided by the user.
 
 The tutorials and the documentation have been updated accordingly.
 

doc/changelog.rst

@@ -25,6 +25,10 @@ New
 Changes
 ~~~~~~~
 
+- **BREAKING**: it is now mandatory to supply a list of differentiation
+  arguments to :func:`~heyoka.diff_tensors()`
+  (`#164 <https://github.com/bluescarni/heyoka.py/pull/164>`__).
+  This is a :ref:`breaking change <bchanges_4_0_0>`.
 - **BREAKING**: :ref:`compiled functions <cfunc_tut>` now require
   the list of input variables to be always supplied by the user
   (`#162 <https://github.com/bluescarni/heyoka.py/pull/162>`__).

doc/conf.py

@@ -36,6 +36,7 @@
               "sphinx.ext.intersphinx",
               "sphinx.ext.autodoc",
               "sphinx.ext.autosummary",
+              "sphinx.ext.doctest",
               ]
 
 intersphinx_mapping = {

doc/index.md

@@ -104,7 +104,7 @@ examples_others
 :maxdepth: 2
 :caption: API reference
 
-api_integrators
 api_exsys
+api_integrators
 api_lagham
 ```