spreadsheet-kit 0.10.1

Core spreadsheet automation primitives — shared types, edit normalization, and session traits for agent-facing surfaces
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

use crate::types::CellEdit;
use anyhow::{Result, bail};
use std::path::{Path, PathBuf};

pub trait SessionRuntime {
    type Handle;

    fn open(&self, workbook_path: &Path) -> Result<Self::Handle>;
    fn apply_edits(
        &self,
        handle: &Self::Handle,
        sheet_name: &str,
        edits: &[CellEdit],
    ) -> Result<()>;
    fn recalculate(&self, handle: &Self::Handle, timeout_ms: Option<u64>) -> Result<()>;
    fn save_as(&self, handle: &Self::Handle, output_path: &Path) -> Result<PathBuf>;
}

#[derive(Debug, Default, Clone)]
pub struct SessionRuntimeScaffold;

impl SessionRuntime for SessionRuntimeScaffold {
    type Handle = String;

    fn open(&self, _workbook_path: &Path) -> Result<Self::Handle> {
        bail!("session runtime is scaffold-only in this ticket")
    }

    fn apply_edits(
        &self,
        _handle: &Self::Handle,
        _sheet_name: &str,
        _edits: &[CellEdit],
    ) -> Result<()> {
        bail!("session runtime is scaffold-only in this ticket")
    }

    fn recalculate(&self, _handle: &Self::Handle, _timeout_ms: Option<u64>) -> Result<()> {
        bail!("session runtime is scaffold-only in this ticket")
    }

    fn save_as(&self, _handle: &Self::Handle, _output_path: &Path) -> Result<PathBuf> {
        bail!("session runtime is scaffold-only in this ticket")
    }
}