Struct RunOptions 

pub struct RunOptions {
    pub quiet: bool,
    pub include_drafts: bool,
    pub deploy_target: Option<String>,
    pub validate_only: bool,
    pub jobs: Option<usize>,
    pub max_memory_mb: Option<usize>,
    pub ai_fix: bool,
    pub ai_fix_dry_run: bool,
    pub incremental: bool,
    pub no_llm_cache: bool,
    pub isr: bool,
}

CLI-driven options that don’t live in SsgConfig itself.

Extracted from clap matches so the run pipeline can be unit-tested without going through Cli::build(). Internal: this is a CLI-implementation type, not part of the library surface. The containing module is pub(crate), so this pub is effectively crate-local — clippy’s redundant_pub_crate flagged the prior pub(crate) here. See API stability audit (Tier C) for context.

Fields

quiet: bool

Suppress banner and timing print-outs.

include_drafts: bool

Include draft files (skip the DraftPlugin filter).

deploy_target: Option<String>

Optional deploy target — netlify, vercel, cloudflare, github.

validate_only: bool

Validate content schemas only (no build).

jobs: Option<usize>

Number of parallel threads for Rayon (--jobs). None means use all available CPUs.

max_memory_mb: Option<usize>

Peak memory budget in MB for streaming compilation. None means use the default (512 MB).

ai_fix: bool

Run the agentic AI pipeline to audit and fix content.

ai_fix_dry_run: bool

Preview AI fixes without writing files.

incremental: bool

Use the cached dependency graph to skip work on unchanged sources (ssg build --incremental, issue #524).

no_llm_cache: bool

Disable the deterministic LLM inference cache (issue #528). Surfaces as --no-llm-cache on the CLI and is exported to LlmConfig::default via the SSG_NO_LLM_CACHE env var so any code path constructing an LlmConfig from defaults (CLI helpers, integration tests, plugin re-entrants) sees a consistent setting.

isr: bool

Emit ISR build manifest + raw KV payloads under dist/.ssg/ (issue #546). Off by default — when false the build is byte-identical to v0.0.43 (AC9).

Implementations

impl RunOptions

pub fn from_matches(matches: &ArgMatches) -> Self

Builds a RunOptions from a parsed clap::ArgMatches.

Examples

use ssg::cmd::Cli;
use ssg::pipeline::RunOptions;

let matches = Cli::build().get_matches_from(vec!["ssg", "--quiet"]);
let opts = RunOptions::from_matches(&matches);
assert!(opts.quiet);

pub fn from_subcommand_matches(sub_m: &ArgMatches) -> Self

Builds a RunOptions from subcommand-style matches.

The subcommand parser exposes a narrower flag set — --quiet, --drafts, --jobs, and on the build subcommand --max-memory. Anything else falls back to the defaults so downstream callers don’t have to special-case missing IDs.

Examples

use ssg::cmd::Cli;
use ssg::pipeline::RunOptions;

let matches = Cli::subcommand_app().get_matches_from(vec!["ssg", "build"]);
let sub_m = matches.subcommand_matches("build").unwrap();
let opts = RunOptions::from_subcommand_matches(sub_m);
assert!(!opts.quiet);

Trait Implementations

impl Clone for RunOptions

fn clone(&self) -> RunOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RunOptions

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

Formats the value using the given formatter.

impl Default for RunOptions

fn default() -> RunOptions

Returns the “default value” for a type.