如何在 Sphinx 文档示例中获取旧版 NumPy repr？

Question

这个问题考虑了 NEP 51，它改变了 NumPy 的字符串表示形式。本文档描述了一些潜在的向后兼容性问题：

一个例外是带有文档的下游库，尤其是文档测试。由于许多值的表示会发生变化，因此在许多情况下必须更新文档......

可能有必要采用文档测试测试工具，以允许对新表示进行近似值检查。

但是，查看文档，我没有看到示例的输出有任何更改。

查看 NumPy 的文档，例如

numpy.sin

：

打印一个角度的正弦：

>>> np.sin(np.pi/2.)
1.0

但是使用最新的 NumPy，此示例显示

np.float64(1.0)

。

与 SciPy 的文档类似，例如

scipy.special.erfinv

：

>>> from scipy.special import erfinv, erf
>>> erfinv(0.5)
0.4769362762044699

但是使用最新的 NumPy，此示例显示

np.float64(0.4769362762044699)

。

我知道

numpy.set_printoptions

要更改此默认值：

>>> np.set_printoptions(legacy="1.25")
>>> np.sin(np.pi/2.)
1.0
>>> erfinv(0.5)
0.4769362762044699

但是，我没有看到它用于 NumPy 或 SciPy 的文档。

如何配置这些 Sphinx 文档来显示旧输出？

Answer 1

如何配置这些 Sphinx 文档来显示旧输出？

没有进行此类配置。示例输出被硬编码到 NumPy 文档字符串中。它们不是通过运行代码生成的。