Enum TextToColumnsResult 

pub enum TextToColumnsResult {
    WouldChange {
        summary: String,
        source: String,
        spill: Option<String>,
        width_upper_bound: usize,
        overwritten_cells: Vec<String>,
        past_grid_extent: bool,
    },
    RefusedNotASpreadsheet {
        mime_type: String,
    },
    RefusedShortcut,
    RefusedNoVisibleParents,
    RefusedSheetNotFound {
        title: String,
        available: Vec<String>,
    },
    RefusedInvalidRange {
        detail: String,
    },
    RefusedInvalidDelimiter {
        detail: String,
    },
    Blocked {
        operation: DriveOperation,
        decided_by: Option<DecidingRule>,
    },
    RefusedNoLease,
    RefusedLeaseExpired,
    RefusedLeaseWrongFile,
    RefusedLeaseStale,
    Changed {
        summary: String,
        source: String,
        spill: Option<String>,
        width_upper_bound: usize,
        overwritten_cells: Vec<String>,
        past_grid_extent: bool,
    },
    Failed {
        detail: String,
    },
}

What happened (or, under --dry-run, would happen).

Variants

WouldChange

--dry-run, and the gate would allow it.

Fields

summary: String

A human-readable, tense-neutral summary of the effect — also the request log’s fields_changed. Names the source, the delimiter, and the upper-bound width and spill span; the overwrite count and the grid-extent caveat are separate, tense-varying lines built by describe_lines, so this same string reads correctly under both Would … and Applied: ….

source: String

The source column’s A1 address.

spill: Option<String>

The spill span’s A1 address — the columns to the right of source a split of width_upper_bound columns would reach. None when the local split never produces more than one column, so nothing would be written beyond source.

width_upper_bound: usize

An upper bound on how many columns the split needs, computed locally with a naive, non-quote-aware split — never the server’s real answer, which this crate cannot predict. Under Delimiter::Auto it is an estimate rather than a bound, and the rendered output says so ([AUTO_DELIMITER_CAVEAT]).

overwritten_cells: Vec<String>

The non-blank cells within the spill span that would be overwritten, as bare A1 addresses — never their values, unlike merge-cells’ own discarded_cells (ADR-0083 §6). Always an upper bound: the API decides for itself how many columns the split needs, so some of the listed cells may not actually be touched — and under Delimiter::Auto it picks the separator too, which can reach cells this list does not name ([AUTO_DELIMITER_CAVEAT]).

past_grid_extent: bool

The spill span runs past the sheet’s current row/column count. Never a refusal (ADR-0083 §5) — it only earns the summary’s grid-extent caveat line.

RefusedNotASpreadsheet

The target is not a Google Sheet.

Fields

mime_type: String

The target’s actual MIME type.

RefusedShortcut

The target is a shortcut, which we do not follow.

RefusedNoVisibleParents

The target has no parents this account can see.

RefusedSheetNotFound

The named sheet does not exist in this workbook.

Fields

title: String

The title that was not found.

available: Vec<String>

The titles that do exist.

RefusedInvalidRange

The --sheet/--source pair, or the resolved range, was invalid — not fully bounded, or spanning more than one column.

Fields

detail: String

What was wrong and why.

RefusedInvalidDelimiter

--custom-delimiter was empty.

Fields

detail: String

What was wrong and why.

Blocked

The folder write-permission gate refused it.

Fields

operation: DriveOperation

Which of [GATE_OPERATIONS] denied first — the union gate refuses as soon as one of the two does, and which one it was is the only actionable part of the message.

decided_by: Option<DecidingRule>

The rule that decided the refusal, if any.

RefusedNoLease

No --lease was presented, and the deciding rule requires one (ADR-0080 §9).

RefusedLeaseExpired

The presented lease has expired, or was never a token this ledger knows about.

RefusedLeaseWrongFile

The presented lease is bound to a different file id.

RefusedLeaseStale

The file has moved since the lease’s recorded version — the staleness check (ADR-0080 §6).

Changed

The mutation succeeded.

Fields

summary: String

The same tense-neutral summary Self::WouldChange carries, built by the same call — which is why it reads correctly after the fact as well as before it.

source: String

Same as Self::WouldChange.

spill: Option<String>

Same as Self::WouldChange.

width_upper_bound: usize

Same as Self::WouldChange.

overwritten_cells: Vec<String>

Same as Self::WouldChange — read before the mutating call (the same read serves both paths), so this names what was overwritten, not a post-hoc guess.

past_grid_extent: bool

Same as Self::WouldChange.

Failed

An API or validation error.

Fields

detail: String

A human-readable summary of what failed.

Trait Implementations

impl Clone for TextToColumnsResult

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TextToColumnsResult

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for TextToColumnsResult

impl PartialEq for TextToColumnsResult

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for TextToColumnsResult

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TextToColumnsResult