Sphinx doctest fails for a couple reasons. When running doctest
Sphinx seems to stringify types which is incompatible with equinox (cannot use stringified abstract annotations).
We set typing.GENERATING_DOCUMENTATION = True in conf.py to avoid expanding ArrayLike in the documentation (jaxtyping imports it as an Array instead). This change in imports lead to errors on isinstance checks.
Ideally doctest would be ran separately, outside a document generating context. At some point I might make the change to MKDocs, in which case another solution will need to be found for testing documentation anyway.
Sphinx doctest fails for a couple reasons. When running doctest
typing.GENERATING_DOCUMENTATION = Truein conf.py to avoid expandingArrayLikein the documentation (jaxtyping imports it as an Array instead). This change in imports lead to errors on isinstance checks.Ideally doctest would be ran separately, outside a document generating context. At some point I might make the change to MKDocs, in which case another solution will need to be found for testing documentation anyway.