Skip to main content

Module enum_expansion

Module enum_expansion 

Source
Expand description

Enum-specific DataFrame derive expansion.

Generates a companion struct where every column is Vec<Option<T>>, with None fill for fields absent in a given variant.

Re-exportsΒ§

use proc_macro2::TokenStream; πŸ”’
use quote::ToTokens; πŸ”’
use quote::format_ident; πŸ”’
use quote::quote; πŸ”’
use syn::DeriveInput; πŸ”’
use syn::Fields; πŸ”’
use super::ColumnRegistry; πŸ”’
use super::DataFrameAttrs; πŸ”’
use super::EnumAutoExpandVecData; πŸ”’
use super::EnumExpandedFixedData; πŸ”’
use super::EnumExpandedVecData; πŸ”’
use super::EnumMapFieldData; πŸ”’
use super::EnumResolvedField; πŸ”’
use super::EnumSingleFieldData; πŸ”’
use super::EnumStructFieldData; πŸ”’
use super::FieldTypeKind; πŸ”’
use super::ResolvedColumn; πŸ”’
use super::SPELL_TYPES_ALIKE; πŸ”’
use super::VariantInfo; πŸ”’
use super::VariantShape; πŸ”’
use super::borrowed_string_column; πŸ”’
use super::classify_field_type; πŸ”’
use super::column_local; πŸ”’
use super::column_str; πŸ”’
use super::companion_debug_clone; πŸ”’
use super::companion_lifetime_marker; πŸ”’
use super::conditional_where; πŸ”’
use super::datetime_column_ty; πŸ”’
use super::datetime_feature_assertions; πŸ”’
use super::expanded_elem_idents; πŸ”’
use super::field_is_borrowed_ref; πŸ”’
use super::fixed_array_elems; πŸ”’
use super::from_rows_par_override; πŸ”’
use super::is_bare_reader_scalar_ty; πŸ”’
use super::is_datetime_ty; πŸ”’
use super::is_raw_scalar_ty; πŸ”’
use super::is_reader_scalar_ty; πŸ”’
use super::list_column_fn; πŸ”’
use super::option_payload; πŸ”’
use super::owned_elems_iter; πŸ”’
use super::parallel_columns_impl; πŸ”’
use super::parse_field_attrs; πŸ”’
use super::raw_na_column_error; πŸ”’
use super::same_column_type; πŸ”’
use super::width_elems; πŸ”’
use crate::naming; πŸ”’
use crate::type_inspect::type_display; πŸ”’
use std::collections::HashMap; πŸ”’

FunctionsΒ§

build_enum_reader πŸ”’
Build the try_from_dataframe / try_from_dataframe_par methods for a tagged enum.
derive_enum_dataframe πŸ”’
Derive DataFrameRow for an enum with #[dataframe(align)].
enum_elem_idents πŸ”’
The variables an expanded field’s elements are bound to, for the field at pos in its variant: by position, since all of a variant’s fields are bound before any column is filled.
enum_field_reader_capable πŸ”’
Check whether an enum field is reader-capable.
enum_reader_field_value πŸ”’
The value of field erf in row __i of variant variant_name_str, read from the reader’s extracted columns. With take, each cell is moved out of its column: the sequential reader owns the columns and visits each row once. Without it, the cell is cloned: the parallel reader shares the columns across threads, and reads only scalar columns, which are all Clone.
expanded_elem_prelude πŸ”’
Bind the elements of variant vi’s [T; N] / width = N fields to the variables enum_elem_idents names, for a match arm whose pattern binds each field to its binding. With borrowed_rows the arm matches a borrowed row, so each binding is a reference and every element is cloned.
generate_split_method πŸ”’
Generate the split representation for an enum DataFrameRow: the hidden to_dataframe_split associated method (body holder) plus the DataFrameRowSplit bridge impl that surfaces the public rows.into_dataframe_split() verb (IntoDataFrameSplit).
option_scalar_in_variant_error πŸ”’
Error for an Option<scalar> field inside an enum variant (#1437).
raw_variant_column_error πŸ”’
Reject u8 in every variant-field shape that reaches a column: a scalar or Option<u8>, a fixed array, or a width / expand (padded) slice. Variant columns are NA in rows of the other variants, and R raw vectors have no NA. A plain Vec<u8> stays an opaque list-column and is accepted.