Crate gammaloop_api 

Rust facade for loading a GammaLoop state and driving its command session.

This crate owns GammaLoop’s persistent state, run-card, command, CLI, and Python-facing lifecycle. The numerical integrand and event contracts live in gammalooprs. Embedded Rust callers normally configure StateLoadOption, call StateLoadOption::load, and borrow a session::CliSession from the resulting LoadedState.

Loading is not a pure deserialization step: it initializes process-global services, configures tracing, can apply a boot card, and can remove the resolved state path when clean_state is selected. Dropping LoadedState does not save it. Commands decide whether to mutate the in-memory state, write an explicitly requested export, or return a save/quit request.

Embedded lifecycle

The following example is compile-checked but not run as a doctest because GammaLoop startup can require process-global Symbolica initialization and licensed features.

use std::ops::ControlFlow;

use gammaloop_api::{
    commands::CommandOutput, state::CommandHistory, StateLoadOption,
};

let temporary = tempfile::tempdir()?;
let mut loaded = StateLoadOption {
    state_folder: Some(temporary.path().join("state")),
    read_only_state: true,
    ..StateLoadOption::default()
}
.load()?;
assert!(loaded.state_load_summary.is_none());

let execution = {
    let mut session = loaded.cli_session();
    let command = CommandHistory::from_raw_string("display settings global")?;
    session.execute_command(command)?
};
assert!(matches!(execution.flow, ControlFlow::Continue(())));
assert!(matches!(execution.output, CommandOutput::None));

Modules

commands

Typed command definitions and command-execution results.

integrand_info

repl

session

Borrowed command-session access to a loaded GammaLoop state.

state

templates

tracing

Structs

CLISettings

LoadedState

Owned state and settings produced by StateLoadOption::load.

OneShot

Parsed

Repl

SessionSettings

StateLoadOption

Programmatic startup options for an embedded GammaLoop session.

StateLoadSummary

Diagnostic measurements available only when an existing manifested state was loaded.

StateSettings

Enums

Log

Functions

write_schemas