测试支持 (numpy.testing)#

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

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

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 ufuncs。

get_overridable_numpy_array_functions()

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

指南#