测试支持 (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[, ...])

如果两个 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)

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

assert_raises_regex(exception_class, ...)

除非在用参数 args 和关键字参数 kwargs 调用 callable 时抛出类 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 函数

指南#