Struct ShipperConfig 

pub struct ShipperConfig {

    pub schema_version: String,
    pub policy: PolicyConfig,
    pub verify: VerifyConfig,
    pub readiness: ReadinessConfig,
    pub output: OutputConfig,
    pub lock: LockConfig,
    pub retry: RetryConfig,
    pub flags: FlagsConfig,
    pub parallel: ParallelConfig,
    pub state_dir: Option<PathBuf>,
    pub registry: Option<RegistryConfig>,
    pub registries: MultiRegistryConfig,
    pub webhook: WebhookConfig,
    pub encryption: EncryptionConfigInner,
    pub storage: StorageConfigInner,
    pub rehearsal: RehearsalConfig,
}

Project-specific configuration loaded from .shipper.toml.

This is the root deserialization target for the config file. Each field corresponds to a TOML section (e.g. [retry] → RetryConfig).

Use ShipperConfig::load_from_workspace to discover and parse the file, then ShipperConfig::build_runtime_options to merge CLI overrides and produce the final RuntimeOptions.

Fields

schema_version: String

Schema version for the configuration file (e.g., shipper.config.v1)

policy: PolicyConfig

Publish policy configuration

verify: VerifyConfig

Verify mode configuration

readiness: ReadinessConfig

Readiness check configuration

output: OutputConfig

Output configuration

lock: LockConfig

Lock configuration

retry: RetryConfig

Retry configuration

flags: FlagsConfig

Flags configuration

parallel: ParallelConfig

Parallel publishing configuration

state_dir: Option<PathBuf>

Optional custom state directory

registry: Option<RegistryConfig>

Optional custom registry configuration (single registry)

registries: MultiRegistryConfig

Multiple registry configuration for multi-registry publishing

webhook: WebhookConfig

Webhook configuration for publish notifications

encryption: EncryptionConfigInner

Encryption configuration for state files

storage: StorageConfigInner

Storage configuration for cloud storage backends

rehearsal: RehearsalConfig

Rehearsal registry configuration — opt-in phase-2 proof before live dispatch. See issue #97.

This field parses the [rehearsal] TOML section. It is wired through to CLI overrides but not yet consumed by the engine — follow-on PRs under #97 add the phase-2 execution and the gate that refuses live dispatch unless rehearsal succeeded for the same plan_id.

Implementations

impl ShipperConfig

pub fn load_from_workspace(workspace_root: &Path) -> Result<Option<Self>>

Load configuration from workspace root by searching for .shipper.toml

Returns Ok(None) if no config file exists.

pub fn load_from_file(path: &Path) -> Result<Self>

Load configuration from a specific file path

pub fn validate(&self) -> Result<()>

Validate the configuration

pub fn build_runtime_options(&self, cli: CliOverrides) -> RuntimeOptions

Build RuntimeOptions by merging CLI overrides with config file values.

For Option fields: CLI value takes precedence; falls back to config. For bool flags: true if either CLI or config enables it (OR).

pub fn default_toml_template() -> String

Generate a default configuration file content as TOML string

Trait Implementations

impl Clone for ShipperConfig

fn clone(&self) -> ShipperConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ShipperConfig

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

Formats the value using the given formatter.

impl Default for ShipperConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ShipperConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ShipperConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.