Enum Error 

pub enum Error {
    Io {
        path: PathBuf,
        source: Error,
    },
    ConfigToml(Error),
    ConfigTomlSerialize(Error),
    Json(Error),
    Sexp(SexpError),
    Google(String),
    MultipleTabs,
    OrgParse(String),
    NotLinked,
    PathResolution(String),
    Auth(String),
}

Errors raised by org-gdocs library code.

Variants

Io

A filesystem operation failed for the given path.

Fields

path: PathBuf

Path the failing operation targeted.

source: Error

Underlying I/O error.

ConfigToml(Error)

The configuration file could not be parsed as TOML.

ConfigTomlSerialize(Error)

The configuration could not be serialized to TOML.

Json(Error)

A JSON value could not be (de)serialized.

JSON is confined to the forced external boundaries (the Google API wire format and OAuth credential/token files, OVR-1/A5); surfaces this crate owns use s-expressions and surface Error::Sexp instead.

Sexp(SexpError)

An s-expression (the ** Sync State block or the CLI↔Emacs envelope, A5) could not be parsed or did not match the expected shape.

Google(String)

A Google Docs or Drive API call failed — transport, protocol, or a non-success API response.

The generated client’s error type is mapped to its display string at the single seam in crate::google::client (F6) so it never leaks into this crate’s public surface (EI-1).

MultipleTabs

The target document exposes more than one tab, which is unsupported.

We operate only on the first/legacy tab (DI-6); a multi-tab document is reported rather than silently mis-indexed.

OrgParse(String)

The org body could not be parsed by tftio-kb.

NotLinked

The org file has no linked Google Doc (#+GDOC_ID:).

pull, clean, and open all require a document to have been created by a prior push; this is the branchable failure they surface when it has not.

PathResolution(String)

A required path could not be resolved (e.g. no home/config directory).

Auth(String)

OAuth authentication, token acquisition, or TLS setup failed.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<SexpError> for Error

fn from(source: SexpError) -> Self

Converts to this type from the input type.