Testing#

断言函数#

testing.assert_frame_equal(left, right[, ...])

检查 left 和 right DataFrame 是否相等。

testing.assert_series_equal(left, right[, ...])

检查 left 和 right Series 是否相等。

testing.assert_index_equal(left, right[, ...])

检查 left 和 right Index 是否相等。

testing.assert_extension_array_equal(left, right)

检查 left 和 right ExtensionArrays 是否相等。

异常和警告#

errors.AbstractMethodError(class_instance[, ...])

引发此错误而不是 NotImplementedError 来表示抽象方法。

errors.AttributeConflictWarning

使用 HDFStore 时,索引属性冲突时会引发此警告。

errors.CategoricalConversionWarning

使用迭代器读取部分标记的 Stata 文件时会引发此警告。

errors.ChainedAssignmentError

尝试使用链式赋值进行设置时会引发此警告。

errors.ClosedFileError

尝试对已关闭的 HDFStore 文件执行操作时会引发此异常。

errors.CSSWarning

CSS 样式转换失败时会引发此警告。

errors.DatabaseError

执行具有错误语法或引发错误的 SQL 时会引发此错误。

errors.DataError

对非数值数据执行操作时会引发此异常。

errors.DtypeWarning

读取文件中某一列的不同数据类型时发出的警告。

errors.DuplicateLabelError

操作会引入重复标签时会引发此错误。

errors.EmptyDataError

pd.read_csv 中遇到空数据或标头时会引发此异常。

errors.IncompatibilityWarning

尝试在不兼容的 HDF5 文件上使用 where 条件时会引发此警告。

errors.IncompatibleFrequency

尝试在不同频率的 Periods 之间进行比较或运算时引发。

errors.IndexingError

尝试索引且维度不匹配时会引发此异常。

errors.InvalidColumnName

to_stata 列包含无效 stata 名称时会引发此警告。

errors.InvalidComparison

由 _validate_comparison_value 引发,指示无效的比较。

errors.InvalidIndexError

尝试使用无效的索引键时会引发此异常。

errors.InvalidVersion

找到无效版本,用户应参考 PEP 440。

errors.IntCastingNaNError

将带有 NaN 的数组转换为整数类型时(astype)会引发此异常。

errors.LossySetitemError

尝试对非无损的 np.ndarray 执行 __setitem__ 时引发。

errors.MergeError

合并数据时会引发此异常。

errors.NoBufferPresent

在 _get_data_buffer 中引发,表示没有请求的缓冲区。

errors.NullFrequencyError

freq 不能为 null 时引发此异常。

errors.NumbaUtilError

不支持的 Numba 引擎例程会引发此错误。

errors.NumExprClobberingError

尝试使用内置 numexpr 名称作为变量名时会引发此异常。

errors.OptionError

pandas.options 会引发此异常。

errors.OutOfBoundsDatetime

当日期时间超出可表示范围时引发。

errors.OutOfBoundsTimedelta

遇到无法表示的时间差值时引发。

errors.PandasChangeWarning

即将发生的任何更改都会引发此警告。

errors.Pandas4Warning

即将于 pandas 4.0 强制执行的更改会引发此警告。

errors.Pandas5Warning

即将于 pandas 5.0 强制执行的更改会引发此警告。

errors.PandasPendingDeprecationWarning

即将发生的属于 PendingDeprecationWarning 的更改会引发此警告。

errors.PandasDeprecationWarning

即将发生的属于 DeprecationWarning 的更改会引发此警告。

errors.PandasFutureWarning

即将发生的属于 FutureWarning 的更改会引发此警告。

errors.ParserError

解析文件内容时遇到错误会引发此异常。

errors.ParserWarning

读取未使用默认 'c' 解析器的文件时会引发此警告。

errors.PerformanceWarning

存在潜在性能影响时会引发此警告。

errors.PossibleDataLossError

尝试在已打开的 HDFStore 文件时引发此异常。

errors.PossiblePrecisionLoss

to_stata 列的值超出或等于 int64 时会引发此警告。

errors.PyperclipException

剪贴板功能不受支持时会引发此异常。

errors.PyperclipWindowsException(message)

Windows 剪贴板功能不受支持时会引发此异常。

errors.SpecificationError

函数 agg 的函数说明不正确时会引发此异常。

errors.UndefinedVariableError(name[, is_local])

queryeval 使用未定义变量名时会引发此异常。

errors.UnsortedIndexError

切片未进行字典排序的 MultiIndex 时会引发此错误。

errors.UnsupportedFunctionCall

尝试调用不支持的 numpy 函数时会引发此异常。

errors.ValueLabelTypeMismatch

to_stata 类别列包含非字符串值时会引发此警告。

Bug report function#

show_versions([as_json])

提供有用的信息,对 bug 报告很重要。

Test suite runner#

test([extra_args, run_doctests])

使用 pytest 运行 pandas 测试套件。