Bugfix/1616: Polars data container validation

[cstabnick]

Adds support for polars data container validation in custom dtypes
Adds test demonstrating positive and negative case

[cosmicBboy]

Thanks for the contribution! See inline comments.

You can also set up pre-commit to make sure these pass:
https://pandera--1618.org.readthedocs.build/en/1618/CONTRIBUTING.html#set-up-pre-commit

[cosmicBboy]

the type needs to be PolarsData no?

[cstabnick]

Ah, was following how I saw other dtypes take the parameter in.

pandera/pandera/engines/polars_engine.py

Lines 370 to 371 in 612d25c

	data_container: Optional[PolarsDataContainer] = None,
	) -> Union[bool, Iterable[bool]]:

It looks like when it needs to be treated as PolarsData, it may be wrapped in the class. Think I'm going to handle mypy error similar to

pandera/pandera/engines/polars_engine.py

Lines 632 to 635 in 612d25c

	def coerce(self, data_container: PolarsDataContainer) -> pl.LazyFrame:
	"""Coerce data container to the data type."""
	if isinstance(data_container, pl.LazyFrame):
	data_container = PolarsData(data_container)

[cstabnick]

Decided not to take this approach due to it just being for a specific test, updated to PolarsData

[cosmicBboy]

mypy error here should be fixed if data_container type is fixed

[cstabnick]

Updated, precommit passes now

[cosmicBboy]

mypy error:

tests/polars/test_polars_components.py:206: error: Missing return statement  [return]

due to lack of return statement in the outer if statement.

[cstabnick]

Updated, pre commit now passes mypy and pylint

[cosmicBboy]

key is really only used once in the function body: I'd recommend just using data_container.key

[cstabnick]

Updated

[codecov]

Codecov Report

Attention: Patch coverage is 0% with 1 lines in your changes are missing coverage. Please review.

Project coverage is 83.09%. Comparing base (4df61da) to head (959a45c).
Report is 84 commits behind head on main.

Files	Patch %	Lines
pandera/backends/polars/components.py	0.00%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #1623       +/-   ##
===========================================
- Coverage   94.29%   83.09%   -11.20%     
===========================================
  Files          91      116       +25     
  Lines        7024     8538     +1514     
===========================================
+ Hits         6623     7095      +472     
- Misses        401     1443     +1042     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[cosmicBboy]

lgtm! codecov error looks like a false positive.

thanks for the contribution, and congrats on your first PR to pandera @cstabnick !