Merge pull request #352 from BCG-Gamma/dev/2.0.5

BUILD: release pytools 2.0.5

.gitignore

@@ -232,7 +232,7 @@ acs-*.bib
 # endnotes
 *.ent
 
-# fixme
+# fixme_
 *.lox
 
 # feynmf/feynmp
@@ -286,7 +286,7 @@ acs-*.bib
 
 # knitr
 *-concordance.tex
-# TODO Comment the next line if you want to keep your tikz graphics files
+# Comment the next line if you want to keep your tikz graphics files
 *.tikz
 *-tikzDictionary
 
@@ -358,7 +358,7 @@ pythontex-files-*/
 # todonotes
 *.tdo
 
-# easy-todo
+# easy-todo_
 *.lod
 
 # xmpincl

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/PyCQA/isort
-    rev: 5.10.1
+    rev: 5.12.0
     hooks:
       - id: isort
 
@@ -11,7 +11,7 @@ repos:
         language: python_venv
         language_version: python39
 
-  - repo: https://gitlab.com/pycqa/flake8
+  - repo: https://github.com/pycqa/flake8
     rev: 5.0.4
     hooks:
       - id: flake8
@@ -34,11 +34,11 @@ repos:
         exclude: condabuild/meta.yaml
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v0.971
+    rev: v1.2.0
     hooks:
       - id: mypy
         files: src|sphinx|test
         language: python_venv
         language_version: python39
         additional_dependencies:
-          - numpy~=1.22
+          - numpy~=1.24

README.rst

@@ -1,4 +1,4 @@
-.. image:: sphinx/source/_static/gamma_pytools_logo.png
+.. image:: sphinx/source/_images/gamma_pytools_logo.png
 
 |
 

RELEASE_NOTES.rst

@@ -2,17 +2,28 @@ Release Notes
 =============
 
 .. |mypy| replace:: :external+mypy:doc:`mypy <index>`
+.. |nbsp| unicode:: 0xA0
+   :trim:
 
 *pytools* 2.0
 -------------
 
 *pytools* 2 features enhanced visualisations together with additional API improvements,
 and is now subject to static type checking with |mypy|.
 
+2.0.5
+~~~~~
+
+- API: de-dent docstrings before processing them with the :obj:``.subsdoc`` decorator
+- FIX: in method :meth:`.AllTracker.resolve_forward_references`, unwrap functions before
+  accessing their ``__globals__`` attribute
+
+
 2.0.4
 ~~~~~
 
-- FIX: make :meth:`.MatplotStyle.get_renderer()` compatible with :mod:`matplotlib` 3.6
+- FIX: make :meth:`.MatplotStyle.get_renderer()` compatible with
+  :mod:`matplotlib` |nbsp| 3.6
 
 
 2.0.3
@@ -21,7 +32,7 @@ and is now subject to static type checking with |mypy|.
 - REFACTOR: rename arg of :meth:`.FittableMixin.fit` to ``__x``, so that |mypy|
   recognizes it as a positional-only argument, and that subclasses can change its
   name without breaking the API
-- FIX: make :class:`.ResolveTypeVariables` compatible with Python 3.9
+- FIX: make :class:`.ResolveTypeVariables` compatible with Python |nbsp| 3.9
 - FIX: recognise private (positional-only) arguments in :class:`.DocValidator`
 - DOC: show original names of private (positional-only) arguments in Sphinx
   documentation, not their substituted private names generated by Python
@@ -43,7 +54,7 @@ and is now subject to static type checking with |mypy|.
 - FIX: in class :class:`.AllTracker`, do not attempt to update forward references in
   imported objects
 - BUILD: update build scripts to support the stricter dependency resolver introduced by
-  *pip 20.3*, and to fix a compatibility issue with recent updates to nbsphinx
+  *pip* |nbsp| 20.3, and to fix a compatibility issue with recent updates to nbsphinx
 - BUILD: enable local sphinx builds in other FACET packages
 - DOC: simplify how the docs build manages existing documentation of previous versions
   in the Azure pipeline and the associated commands in `make.py`:
@@ -156,7 +167,7 @@ Additions and enhancements to dendrogram and matrix visualizations.
     to matrix objects
   - API: new attribute :attr:`.MatrixMatplotStyle.nan_substitute` specifies the value to
     look up in the colormap to determine the color of undefined matrix cells
-  - VIZ: :class:`.MatrixMatplotStyle` enforces a 1:1 aspect ratio for the row and
+  - VIZ: :class:`.MatrixMatplotStyle` enforces a 1:1 |nbsp| aspect ratio for the row and
     column axes, so that equal row and column widths represent equal weights
 
 - API: new public method :meth:`.Drawer.get_style_kwargs`, replacing the previously
@@ -176,40 +187,40 @@ Additions and enhancements to dendrogram and matrix visualizations.
 1.2.5
 ~~~~~
 
-This is a maintenance release to catch up with *pytools* 1.1.10.
+This is a maintenance release to catch up with *pytools* |nbsp| 1.1.10.
 
 
 1.2.4
 ~~~~~
 
-This is a maintenance release to catch up with *pytools* 1.1.8.
+This is a maintenance release to catch up with *pytools* |nbsp| 1.1.8.
 
 
 1.2.3
 ~~~~~
 
 This release enhances support for generating Sphinx documentation, and catches up with
-*pytools* 1.1.7.
+*pytools* |nbsp| 1.1.7.
 
 - API: add sphinx processor :class:`.ResolveGenericClassParameters`
   to substitute generic type parameters introduced by base classes or via the
   ``self`` and ``cls`` special method arguments
 - API: add sphinx processor :class:`.AutodocProcessBases` to handle
-  `autodoc-process-bases` events (introduced in Sphinx 4.1)
+  `autodoc-process-bases` events (introduced in Sphinx |nbsp| 4.1)
 - API: function :func:`.validate_type` now accepts multiple alternative types to
   validate values against, in line with how :func:`isinstance` tests for multiple types
 
 
 1.2.2
 ~~~~~
 
-This is a maintenance release to catch up with *pytools* 1.1.5.
+This is a maintenance release to catch up with *pytools* |nbsp| 1.1.5.
 
 
 1.2.1
 ~~~~~
 
-This is a maintenance release to catch up with *pytools* 1.1.4.
+This is a maintenance release to catch up with *pytools* |nbsp| 1.1.4.
 
 
 1.2.0
@@ -247,7 +258,7 @@ This is a bugfix release to restore the GitHub release process.
 
 - BUILD: the ``make_base.py`` build script no longer imports the actual module to obtain
   the current package version, similarly as introduced for ``make.py`` in
-  *pytools* 1.1.7
+  *pytools* |nbsp| 1.1.7
 
 
 1.1.7
@@ -281,7 +292,7 @@ This is a bugfix release to restore the GitHub release process.
 1.1.4
 ~~~~~
 
-- BUILD: add support for :mod:`joblib` 1.0.*
+- BUILD: add support for :mod:`joblib` |nbsp| 1.0.*
 
 
 1.1.3
@@ -296,7 +307,8 @@ This is a bugfix release to restore the GitHub release process.
 1.1.2
 ~~~~~
 
-- Catch up with fixes and pipeline updates introduced by *pytools* 1.0.3 and 1.0.4
+- Catch up with fixes and pipeline updates introduced by *pytools* |nbsp| 1.0.3 and
+  |nbsp| 1.0.4
 - API: support inheriting class docstrings from superclasses using the
   :func:`.inheritdoc` decorator
 - API: new :func:`.subsdoc` decorator to replace text in docstrings
@@ -328,13 +340,13 @@ This is a bugfix release to restore the GitHub release process.
 1.0.6
 ~~~~~
 
-- FIX: back-port 1.1 bugfix for :meth:`.Expression.eq_`
+- FIX: back-port *pytools* |nbsp| 1.1 bugfix for :meth:`.Expression.eq_`
 
 
 1.0.5
 ~~~~~
 
-- FIX: back-port 1.1 bugfix for building multi-version documentation
+- FIX: back-port *pytools* |nbsp| 1.1 bugfix for building multi-version documentation
 
 
 1.0.4
@@ -352,8 +364,8 @@ minor fixes.
 - BUILD: add the ``bcg_gamma`` conda channel when building
 - BUILD: Enforce pre-release for minor and major releases
 - DOC: add pre-commit hook instructions to contribution guide
-- BUILD: update *flake8* to 3.9.0
-- BUILD: apply make_base.py changes from 1.1.x also on develop (adds more robust parsing
+- BUILD: update *flake8* to |nbsp| 3.9.0
+- BUILD: apply make_base.py changes from |nbsp| 1.1.x also on develop (adds more robust parsing
   of package versions)
 - FIX: version syntax adaptation with mixed ``=`` and ``>=``
 
@@ -369,7 +381,7 @@ minor fixes.
   :class:`~matplotlib.axes.Axes` object
 - FIX: preserve correct instance for subclasses of singleton classes
 - FIX: add a few missing type hints
-- BUILD: add support for :mod:`numpy` 1.20
+- BUILD: add support for :mod:`numpy` |nbsp| 1.20
 - BUILD: updates and changes to the CI/CD pipeline