測試支援 (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 個最小單位 (Units in the Last Place)。

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)

除非給定的 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])

執行在給定檔案中找到的 doctest。

suppress_warnings([forwarding_rule])

情境管理器和裝飾器,功能與 warnings.catch_warnings 非常相似。

測試自訂陣列容器 (numpy.testing.overrides)#

當測試使用 __array_ufunc__/__array_function__ 的自訂陣列容器實作時,這些函數可能很有用。

allows_array_function_override(func)

判斷是否可以透過 __array_function__ 覆寫 NumPy 函數

allows_array_ufunc_override(func)

判斷是否可以透過 __array_ufunc__ 覆寫函數

get_overridable_numpy_ufuncs()

列出所有可透過 __array_ufunc__ 覆寫的 numpy ufunc

get_overridable_numpy_array_functions()

列出所有可透過 __array_function__ 覆寫的 numpy 函數

指南#