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_parmethods for a tagged enum. - derive_
enum_ πdataframe - Derive
DataFrameRowfor an enum with#[dataframe(align)]. - enum_
elem_ πidents - The variables an expanded fieldβs elements are bound to, for the field at
posin 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
erfin row__iof variantvariant_name_str, read from the readerβs extracted columns. Withtake, 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 allClone. - expanded_
elem_ πprelude - Bind the elements of variant
viβs[T; N]/width = Nfields to the variablesenum_elem_identsnames, for a match arm whose pattern binds each field to itsbinding. Withborrowed_rowsthe 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 hiddento_dataframe_splitassociated method (body holder) plus theDataFrameRowSplitbridge impl that surfaces the publicrows.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
u8in every variant-field shape that reaches a column: a scalar orOption<u8>, a fixed array, or awidth/expand(padded) slice. Variant columns are NA in rows of the other variants, and R raw vectors have no NA. A plainVec<u8>stays an opaque list-column and is accepted.