pyspiral 0.6.10__cp312-abi3-macosx_11_0_arm64.whl → 0.6.12__cp312-abi3-macosx_11_0_arm64.whl

spiral/expressions/refs.py

@@ -1,58 +0,0 @@
-import pyarrow as pa
-
-from spiral.expressions.base import Expr, ExprLike
-
-
-def ref(expr: ExprLike, field: str | None = None) -> Expr:
-    """Store binary values as references. This expression can only be used on write.
-
-    It is often better to store large cell values, such as bytes columns, that aren't used in filter expressions as
-    references. This enables more efficient scan pruning. Many of the Spiral's cell pushdown expressions work
-    over references.
-
-    Args:
-        expr: The expression to store as a reference.
-        field: If the expr evaluates into struct, the field name of that struct that should be referenced.
-            If `None`, the expr must evaluate into a type that supports referencing.
-    """
-    from spiral import _lib
-    from spiral.expressions import lift
-
-    expr = lift(expr)
-    return Expr(_lib.expr.refs.ref(expr.__expr__, field))
-
-
-def deref(expr: ExprLike | str, field: str | None = None) -> Expr:
-    """De-reference referenced values.
-
-    See `ref` for more information on Spiral's reference values. This expression is used to de-reference referenced
-    column back into their original form, e.g. binary.
-
-    Args:
-        expr: The expression to de-reference. A str is assumed to be the `se.aux` expression.
-        field: If the expr evaluates into struct, the field name of that struct that should be de-referenced.
-            If `None`, the expr must evaluate into a reference type.
-    """
-    from spiral import _lib
-    from spiral.expressions import aux, lift
-
-    if isinstance(expr, str):
-        expr = aux(
-            expr,
-            pa.struct([("__ref__", pa.struct([("id", pa.string()), ("begin", pa.uint64()), ("end", pa.uint64())]))]),
-        )
-
-    expr = lift(expr)
-    return Expr(_lib.expr.refs.deref(expr.__expr__, field=field))
-
-
-def nbytes(expr: ExprLike) -> Expr:
-    """Return the number of bytes in a reference.
-
-    Args:
-        expr: The ref expression to get the number of bytes from.
-    """
-    from spiral.expressions import lift
-
-    expr = lift(expr)
-    return expr["__ref__"]["end"] - expr["__ref__"]["begin"]