Apply residuals when reading a table

[Fokko]

No description provided.

[corleyma]

lgtm, though I wonder if there's a good place to document this a little more (for future developers/for folks that use pyiceberg as reference implementation)

[Fokko]

@corleyma Good point, I think most of the docs around residuals are here:

iceberg-python/pyiceberg/expressions/visitors.py

Lines 1737 to 1751 in e9d35d5

	class ResidualVisitor(BoundBooleanExpressionVisitor[BooleanExpression], ABC):
	"""Finds the residuals for an Expression the partitions in the given PartitionSpec.
	A residual expression is made by partially evaluating an expression using partition values.
	For example, if a table is partitioned by day(utc_timestamp) and is read with a filter expression
	utc_timestamp > a and utc_timestamp < b, then there are 4 possible residuals expressions
	for the partition data, d:
	1. If d > day(a) and d &lt; day(b), the residual is always true
	2. If d == day(a) and d != day(b), the residual is utc_timestamp > a
	3. if d == day(b) and d != day(a), the residual is utc_timestamp < b
	4. If d == day(a) == day(b), the residual is utc_timestamp > a and utc_timestamp < b
	Partition data is passed using StructLike. Residuals are returned by residualFor(StructLike).
	"""

Any thoughts?