测试支持#

所有 NumPy 测试脚本的通用测试支持。

这个单一模块应该在一个位置提供所有 NumPy 测试的通用功能,这样测试脚本就可以直接导入并立即使用。有关背景信息,请参阅测试指南

断言#

assert_allclose(actual, desired[, rtol, ...])

如果两个对象在所需容差范围内不相等,则引发 AssertionError。

assert_array_almost_equal_nulp(x, y[, nulp])

比较两个数组相对于它们的间距。

assert_array_max_ulp(a, b[, maxulp, dtype])

检查数组的所有项在最后一位的差异最多为 N 个单位。

assert_array_equal(actual, desired[, ...])

如果两个类数组对象不相等,则引发 AssertionError。

assert_array_less(x, y[, err_msg, verbose, ...])

如果两个类数组对象不按小于关系排序,则引发 AssertionError。

assert_equal(actual, desired[, err_msg, ...])

如果两个对象不相等,则引发 AssertionError。

assert_raises(assert_raises)

除非在调用可调用对象并传入参数 args 和关键字参数 kwargs 时抛出 exception_class 类的异常,否则失败。

assert_raises_regex(exception_class, ...)

除非在调用可调用对象并传入参数 args 和关键字参数 kwargs 时,抛出 exception_class 类的异常且其消息与 expected_regexp 匹配,否则失败。

assert_warns(warning_class, *args, **kwargs)

除非给定可调用对象抛出指定警告,否则失败。

assert_no_warnings(*args, **kwargs)

如果给定可调用对象产生任何警告,则失败。

assert_no_gc_cycles(*args, **kwargs)

如果给定可调用对象产生任何引用循环,则失败。

assert_string_equal(actual, desired)

测试两个字符串是否相等。

装饰器#

decorate_methods(cls, decorator[, testmatch])

将装饰器应用于类中所有匹配正则表达式的方法。

测试运行#

clear_and_catch_warnings([record, modules])

用于捕获警告并重置警告注册表的上下文管理器

measure(code_str[, times, label])

返回在调用者命名空间中执行代码的耗时。

rundocs([filename, raise_on_error])

运行给定文件中找到的 doctest。

suppress_warnings([forwarding_rule])

上下文管理器和装饰器,功能与 warnings.catch_warnings 大致相同。

测试自定义数组容器 (numpy.testing.overrides)#

当测试利用 __array_ufunc__/__array_function__ 的自定义数组容器实现时,这些函数会很有用。

allows_array_function_override(func)

确定 NumPy 函数是否可以通过 __array_function__ 重写

allows_array_ufunc_override(func)

确定函数是否可以通过 __array_ufunc__ 重写

get_overridable_numpy_ufuncs()

列出所有可通过 __array_ufunc__ 重写的 numpy ufunc

get_overridable_numpy_array_functions()

列出所有可通过 __array_function__ 重写的 numpy 函数

指南#