Struct InitOptions 

pub struct InitOptions {
    pub tools: BTreeSet<String>,
    pub force: bool,
    pub update: bool,
    pub upgrade: bool,
}

Options that control template installation behavior.

Fields

tools: BTreeSet<String>

Selected tool ids.

force: bool

Overwrite existing files when true.

update: bool

When true, update managed files while preserving user-edited files.

In this mode, non-marker files that already exist are silently skipped instead of triggering an error. Marker-managed files still get their managed blocks updated. Adapter files, skills, and commands are overwritten as usual.

upgrade: bool

When true, perform a marker-scoped upgrade of prompt/template assets.

Only content between <!-- ITO:START --> and <!-- ITO:END --> markers is replaced from the embedded templates. All content outside the managed block is preserved exactly. When a marker-managed file is found to be missing valid Ito markers the file is left unchanged and actionable guidance is emitted rather than returning an error.

upgrade implies update semantics (user-owned files are preserved).

Implementations

impl InitOptions

pub fn new(tools: BTreeSet<String>, force: bool, update: bool) -> Self

Constructs an InitOptions configured for a standard (non-upgrade) installation.

The returned value has upgrade set to false. The force flag controls whether existing files may be overwritten, and update enables update semantics that merge managed marker blocks instead of unconditional replacement.

Examples

use std::collections::BTreeSet;
use ito_core::installers::InitOptions;
let tools = BTreeSet::from(["claude".to_string()]);
let opts = InitOptions::new(tools, true, false);
assert!(!opts.upgrade);
assert!(opts.force);
assert!(!opts.update);

pub fn new_upgrade(tools: BTreeSet<String>) -> Self

Constructs InitOptions configured for upgrade mode.

In upgrade mode the options enable update semantics and preserve user-owned files. The force flag is disabled and update and upgrade are enabled, so marker-managed files missing Ito markers are left unchanged with guidance rather than causing an error.

Examples

use std::collections::BTreeSet;
use ito_core::installers::InitOptions;
let opts = InitOptions::new_upgrade(BTreeSet::new());
assert!(opts.upgrade && opts.update && !opts.force);

pub fn with_upgrade(self) -> Self

Enable upgrade mode and its update semantics on this InitOptions.

When upgrade is enabled it implies update = true and force = false; this method sets all three fields so that force cannot override the non-destructive marker-scoped upgrade behavior.

Examples

use ito_core::installers::InitOptions;
let opts = InitOptions::new(std::collections::BTreeSet::new(), false, false)
    .with_upgrade();
assert!(opts.upgrade && opts.update && !opts.force);

Trait Implementations

impl Clone for InitOptions

fn clone(&self) -> InitOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InitOptions

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

Formats the value using the given formatter.

impl PartialEq for InitOptions

fn eq(&self, other: &InitOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for InitOptions

impl StructuralPartialEq for InitOptions