测试支持#

所有 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[, ...])

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

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

如果两个 array_like 对象不按小于号排序,则引发 AssertionError。

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

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

assert_raises(assert_raises)

除非 callable 在使用参数 args 和关键字参数 kwargs 调用时抛出 exception_class 类的异常,否则失败。

assert_raises_regex(exception_class, ...)

除非 callable 在使用参数 args 和关键字参数 kwargs 调用时抛出 exception_class 类且消息与 expected_regexp 匹配的异常,否则失败。

assert_warns(warning_class, *args, **kwargs)

除非给定的 callable 抛出指定的警告,否则失败。

assert_no_warnings(*args, **kwargs)

如果给定的 callable 产生任何警告,则失败。

assert_no_gc_cycles(*args, **kwargs)

如果给定的 callable 产生任何引用循环,则失败。

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])

运行给定文件中的 doctests。

suppress_warnings([forwarding_rule, _warn])

上下文管理器和装饰器,功能与 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 ufuncs

get_overridable_numpy_array_functions()

列出所有可以通过 __array_function__ 覆盖的 NumPy 函数

指南#