selection

Module: sidecar::selection

Contents

Enums

• SidecarCli - CLI-side selection (value of --sidecar).
• SidecarSelection - Final, resolved sidecar selection.

Functions

• resolve - Resolve the sidecar selection.

---

firma_run::sidecar::selection::SidecarCli

Enum

CLI-side selection (value of --sidecar).

Variants:

• Unset - Flag not passed.
• Local - --sidecar local.
• Remote(String) - --sidecar <tcp://...|unix:///...>.

Traits: Eq

Trait Implementations:

• Clone
  • fn clone(self: &Self) -> SidecarCli
• PartialEq
  • fn eq(self: &Self, other: &SidecarCli) -> bool
• Default
  • fn default() -> SidecarCli
• Debug
  • fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result

firma_run::sidecar::selection::SidecarSelection

Enum

Final, resolved sidecar selection.

Variants:

• Local - Autostart a per-run sidecar; the supervisor chooses the endpoint.
• Remote(crate::config::SidecarEndpoint) - Use the external sidecar at this endpoint; never autostart.

Traits: Eq

Trait Implementations:

• PartialEq
  • fn eq(self: &Self, other: &SidecarSelection) -> bool
• Serialize
  • fn serialize<__S>(self: &Self, __serializer: __S) -> _serde::__private228::Result<<__S as >::Ok, <__S as >::Error>
• Debug
  • fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result
• Clone
  • fn clone(self: &Self) -> SidecarSelection

firma_run::sidecar::selection::resolve

Function

Resolve the sidecar selection.

persisted_endpoint is the merged config-file / FIRMA_SIDECAR_ENDPOINT value (the hard-coded fallback default is NOT included — None means “nothing was explicitly configured”).

Errors

• [RunError::SidecarLocalNoAutostart] when --sidecar local is combined with --no-autostart.
• [RunError::MissingSidecar] when nothing is configured and --no-autostart forbids the local-autostart default.
• [RunError::ConfigValidation] when a Remote endpoint string fails to parse as a [SidecarEndpoint].

fn resolve(cli: &SidecarCli, no_autostart: bool, persisted_endpoint: Option<&str>) -> Result<SidecarSelection, crate::error::RunError>