Struct GenerationSession 

pub struct GenerationSession { /* private fields */ }

A multi-period generation session with checkpoint/resume support.

The session decomposes the total requested time span into fiscal-year-aligned periods and generates each one sequentially, carrying forward balance and ID state between periods.

Implementations

impl GenerationSession

pub fn new( config: GeneratorConfig, output_path: PathBuf, ) -> Result<Self, SynthError>

Create a new session from a config and output path.

The total time span is decomposed into fiscal-year-aligned periods based on config.global.fiscal_year_months (defaults to period_months if not set, yielding a single period).

pub fn resume(path: &Path, config: GeneratorConfig) -> Result<Self, SynthError>

Resume a session from a .dss checkpoint file.

The config hash is verified against the checkpoint to ensure the config has not changed since the session was last saved.

pub fn save(&self, path: &Path) -> Result<(), SynthError>

Persist the current session state to a .dss file.

pub fn generate_next_period( &mut self, ) -> Result<Option<PeriodResult>, SynthError>

Generate the next period in the sequence.

Returns Ok(None) if all periods have been generated.

pub fn generate_all(&mut self) -> Result<Vec<PeriodResult>, SynthError>

Generate all remaining periods in the sequence.

pub fn generate_delta( &mut self, additional_months: u32, ) -> Result<Vec<PeriodResult>, SynthError>

Extend the session with additional months and generate them.

pub fn state(&self) -> &SessionState

Read-only access to the session state.

pub fn periods(&self) -> &[GenerationPeriod]

Read-only access to the period list.

pub fn remaining_periods(&self) -> usize

Number of periods that have not yet been generated.

Trait Implementations

impl Debug for GenerationSession

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

Formats the value using the given formatter.