pandera.api.polars.components.ColumnΒΆ
- class pandera.api.polars.components.Column(dtype=None, checks=None, nullable=False, unique=False, coerce=False, required=True, name=None, regex=False, title=None, description=None, default=None, metadata=None, drop_invalid_rows=False, **column_kwargs)[source]ΒΆ
Polars column schema component.
Create column validator object.
- Parameters:
dtype (
Union
[str
,type
,DataTypeClass
,None
]) β datatype of the column. The datatype for type-checking a dataframe. If a string is specified, then assumes one of the valid pandas string values: http://pandas.pydata.org/pandas-docs/stable/basics.html#dtypeschecks (
Union
[Check
,List
[Union
[Check
,Hypothesis
]],None
]) β checks to verify validity of the columnnullable (
bool
) β Whether or not column can contain null values.unique (
bool
) β whether column values should be uniquecoerce (
bool
) β If True, when schema.validate is called the column will be coerced into the specified dtype. This has no effect on columns wheredtype=None
.required (
bool
) β Whether or not column is allowed to be missingname (
Optional
[str
]) β column name in dataframe to validate. Names in the format β^{regex_pattern}$β are treated as regular expressions. During validation, this schema will be applied to any columns matching this pattern.regex (
bool
) β whether thename
attribute should be treated as a regex pattern to apply to multiple columns in a dataframe. If the name is a regular expression, this attribute will automatically be set to True.title (
Optional
[str
]) β A human-readable label for the column.description (
Optional
[str
]) β An arbitrary textual description of the column.default (
Optional
[Any
]) β The default value for missing values in the column.drop_invalid_rows (
bool
) β if True, drop invalid rows on validation.
- Raises:
SchemaInitError β if impossible to build schema from parameters
- Example:
>>> import pandas as pd >>> import pandera as pa >>> >>> >>> schema = pa.DataFrameSchema({ ... "column": pa.Column(str) ... }) >>> >>> schema.validate(pd.DataFrame({"column": ["foo", "bar"]})) column 0 foo 1 bar
See here for more usage details.
Attributes
BACKEND_REGISTRY
dtype
Get the pandas dtype
properties
Get column properties.
selector
Methods
Create column validator object.
Generate an example of a particular size.
Set the name of the schema.
Create a
hypothesis
strategy for generating a Column.Generate column data object for use by DataFrame strategy.
Validate a Column in a DataFrame object.
Alias for
validate
method.