Enum AutoFillResult 

pub enum AutoFillResult {
    WouldChange {
        summary: String,
        destination: String,
        requested_destination: Option<String>,
        overwritten_cells: Vec<String>,
        destination_is_upper_bound: bool,
    },
    RefusedNotASpreadsheet {
        mime_type: String,
    },
    RefusedShortcut,
    RefusedNoVisibleParents,
    RefusedSheetNotFound {
        title: String,
        available: Vec<String>,
    },
    RefusedInvalidRange {
        detail: String,
    },
    RefusedDestinationPastGrid {
        requested_destination: String,
        row_count: Option<i64>,
        column_count: Option<i64>,
    },
    Blocked {
        decided_by: Option<DecidingRule>,
    },
    RefusedNoLease,
    RefusedLeaseExpired,
    RefusedLeaseWrongFile,
    RefusedLeaseStale,
    Changed {
        summary: String,
        destination: String,
        requested_destination: Option<String>,
        overwritten_cells: Vec<String>,
        destination_is_upper_bound: 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 destination, the source it extends (form B), the direction, and the alternate-series flag; the overwrite count and the two caveats are separate, tense-varying lines built by describe_lines, so this same string reads correctly under both Would … and Applied: ….

destination: String

The destination range’s A1 address, as autoFill will actually fill it — clamped to the sheet’s current extent when the computed/named destination runs past it (verified live, #1937: autoFill clips rather than growing the sheet). This is what the request log’s range records.

requested_destination: Option<String>

The unclamped destination, when it differs from destination — i.e. when clipping happened. None in the common case (destination inside the grid, or the sheet’s extent is unknown), so the JSON output carries no new key then.

overwritten_cells: Vec<String>

The non-blank cells within the destination that would be overwritten, as bare A1 addresses — never their values, unlike merge-cells’ own discarded_cells (ADR-0083 §6).

destination_is_upper_bound: bool

true for form A (--range): Sheets decides the source/ destination split itself, so overwritten_cells names every non-blank cell in the named range, an upper bound on what the fill will actually touch. false for form B, where the destination — and so this list — is exact.

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/range-or-source pair, --fill-length, or the resulting destination was invalid.

Fields

detail: String

What was wrong and why.

RefusedDestinationPastGrid

The destination lies wholly past the sheet’s current extent on some axis — clipping (see the module docs’ “The grid edge” section) would leave nothing to fill, and reporting Changed/WouldChange for a no-op would misstate what happened. Checked, and refused, before any lease is checked or batchUpdate is called — identically for --dry-run and a real run.

Fields

requested_destination: String

The unclamped destination A1 address that was requested.

row_count: Option<i64>

The sheet’s current row count, when known.

column_count: Option<i64>

The sheet’s current column count, when known.

Blocked

The folder write-permission gate refused it.

Fields

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.

destination: String

Same as Self::WouldChange.

requested_destination: Option<String>

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.

destination_is_upper_bound: 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 AutoFillResult

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 AutoFillResult

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

Formats the value using the given formatter.

impl Eq for AutoFillResult

impl PartialEq for AutoFillResult

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AutoFillResult

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 AutoFillResult