Struct PivotMeltModal 

pub struct PivotMeltModal {

    pub active: bool,
    pub preview: ReshapePreview,
    pub active_tab: PivotMeltTab,
    pub focus: PivotMeltFocus,
    pub available_columns: Vec<String>,
    pub column_dtypes: HashMap<String, DataType>,
    pub picker: Option<PickerState>,
    pub attention: bool,
    pub index_columns: Vec<String>,
    pub pivot_column: Option<String>,
    pub value_column: Option<String>,
    pub aggregation: PivotAggregation,
    pub melt_index_columns: Vec<String>,
    pub melt_value_strategy: MeltValueStrategy,
    pub melt_pattern_input: TextInput,
    pub melt_type_filter: MeltTypeFilter,
    pub melt_explicit_list: Vec<String>,
    pub melt_variable_input: TextInput,
    pub melt_value_input: TextInput,
    /* private fields */
}

Fields

active: bool

preview: ReshapePreview

The live preview of the staged spec.

active_tab: PivotMeltTab

focus: PivotMeltFocus

available_columns: Vec<String>

Column names from current schema. Set when opening modal.

column_dtypes: HashMap<String, DataType>

Column name -> DataType. Set when opening.

picker: Option<PickerState>

The one Picker, open for the focused row; None while the form has the keys.

attention: bool

Set when Enter was pressed on an incomplete form: the spec line that names the gap re-accents instead of a modal repeating it. Any other key clears it.

index_columns: Vec<String>

pivot_column: Option<String>

value_column: Option<String>

aggregation: PivotAggregation

melt_index_columns: Vec<String>

melt_value_strategy: MeltValueStrategy

melt_pattern_input: TextInput

melt_type_filter: MeltTypeFilter

melt_explicit_list: Vec<String>

melt_variable_input: TextInput

melt_value_input: TextInput

Implementations

impl PivotMeltModal

pub fn new() -> Self

pub fn open(&mut self, history_limit: usize, theme: &Theme)

pub fn close(&mut self)

pub fn reset_form(&mut self)

pub fn row_order(&self) -> &'static [PivotMeltFocus]

The active tab’s rows, in Tab order. Melt’s value rows follow its strategy.

pub fn switch_tab(&mut self)

pub fn is_text_row(&self, focus: PivotMeltFocus) -> bool

Rows whose value is a text field rather than a picked choice.

pub fn is_choice_row(&self, focus: PivotMeltFocus) -> bool

Rows whose value steps through a short list: the aggregation, the melt strategy and its type.

pub fn is_picker_row(&self, focus: PivotMeltFocus) -> bool

Rows edited through the Picker: the column rows.

pub fn step_choice(&mut self, delta: i8)

←/→ (and Space) on a choice row: the next or previous value, wrapping. A new strategy changes which melt rows follow it.

pub fn step_picker_row(&mut self, delta: i8)

←/→ on a pick-one column row: the next or previous column, chosen at once. A row with nothing chosen yet starts at the first (→) or the last (←).

pub fn is_multi_row(&self, focus: PivotMeltFocus) -> bool

Rows where the Picker toggles several choices rather than picking one.

pub fn focused_text_input_mut(&mut self) -> Option<&mut TextInput>

The focused row’s text field, when it has one.

pub fn picker_items(&self) -> Vec<String>

What the focused row’s Picker offers: each row sees only its own pool, so narrowing one list can never silently empty another.

pub fn open_picker(&mut self)

Open the Picker for the focused row, cursor on the current choice.

pub fn picker_cancel(&mut self)

Esc in the Picker: it closes, and the toggles made since it opened go with it (a pick-one row changed nothing yet).

pub fn picker_choose(&mut self)

Enter in the Picker: a pick-one row takes the cursor’s item; a toggle row’s choices are already staged. Either way the Picker closes.

pub fn picker_toggle(&mut self)

Space in a toggle row’s Picker: flip the cursor’s column in or out.

pub fn is_marked(&self, item: &str) -> bool

Whether an item in the focused row’s Picker is currently chosen.

pub fn pivot_spec_line(&self, g: &Glyphs) -> Result<String, String>

The staged pivot as one line — index × columns → agg(values) — or what is still missing from it.

pub fn melt_spec_line(&self) -> Result<String, String>

The staged melt as one line, or what is still missing from it.

pub fn pivot_validation_error(&self) -> Option<String>

pub fn build_pivot_spec(&self) -> Option<PivotSpec>

pub fn melt_value_pool(&self) -> Vec<String>

pub fn melt_resolve_value_columns(&self) -> Result<Vec<String>, String>

pub fn melt_validation_error(&self) -> Option<String>

pub fn build_melt_spec(&self) -> Option<MeltSpec>

pub fn staged_spec(&self) -> Option<PreviewSpec>

The spec Enter would apply on the active tab, if it is complete.

Trait Implementations

impl Default for PivotMeltModal

fn default() -> Self

Returns the “default value” for a type.

impl Form for PivotMeltModal

fn fields(&self) -> Vec<(PivotMeltFocus, FieldKind)>

The tab bar, then the active tab’s rows. Melt’s value rows follow its strategy.

type Field = PivotMeltFocus

The modal’s name for a field.

fn focused(&self) -> PivotMeltFocus

fn set_focused(&mut self, field: PivotMeltFocus)

Put focus on field. Called only with a field of Form::fields; a modal that shows a text cursor in the focused field syncs it here.

fn text_edge(&self, _field: Self::Field) -> (bool, bool)

For a multiline field: whether its cursor is on the first line, and on the last, where ↑ and ↓ leave it.

fn list_row(&self, _field: Self::Field) -> bool

Whether field is a row of a list (a sort, a filter, a column) rather than a setting. A click on a list row only focuses it, so it can be picked to move or remove without changing it; a click on it once focused acts. A setting (a checkbox, a choice, a button) acts on the first click.

fn focused_kind(&self) -> Option<FieldKind>

The focused field’s kind; None when focus is on a field not shown.

fn focus(&mut self, field: Self::Field) -> bool

Focus field if the form shows it: a click on a row, or a modal moving focus itself. Returns whether it did.

fn move_focus(&mut self, delta: isize)

Move focus delta fields along, wrapping. A focus the form no longer shows counts from the top.

fn focus_next(&mut self)

fn focus_prev(&mut self)

fn settle_focus(&mut self)

After a change that hides fields: when the focused one went, focus the first field instead, so it never points at nothing.