Struct CommandSpec 

pub struct CommandSpec {
    pub description: Option<String>,
    pub run: Option<String>,
    pub path: Option<String>,
    pub docker: Option<String>,
    pub ddp: Option<DdpConfig>,
    pub training: Option<TrainingConfig>,
    pub output: Option<OutputConfig>,
    pub options: BTreeMap<String, Value>,
}

A command at any nesting level. Three mutually-exclusive kinds are recognised at resolve time:

• Path (path set, or by default when the map is empty/null): the command is a pointer to a child fdl.yml. By convention the path is ./<command-name>/ when omitted.
• Run (run set): the command is a self-contained shell script that is executed as-is. Optional docker: service routes it through docker compose.
• Preset: neither path nor run is set. The command merges its ddp / training / output / options fields over the enclosing CommandConfig defaults and invokes that config’s entry:.

Fields

description: Option<String>

run: Option<String>

Inline shell command. Mutex with path.

path: Option<String>

Pointer to a child directory containing its own fdl.yml. Absolute or relative to the declaring config’s directory. Mutex with run. None + no other fields = “use the convention path ./<command-name>/”.

docker: Option<String>

Docker compose service for run-kind commands.

ddp: Option<DdpConfig>

Preset overrides. Only consulted when neither run nor path is set.

training: Option<TrainingConfig>

output: Option<OutputConfig>

options: BTreeMap<String, Value>

Implementations

impl CommandSpec

pub fn kind(&self) -> Result<CommandKind, String>

Classify this command. Returns an error when both run and path are declared — always a mistake, caught loudly rather than silently picking one. Also rejects docker: without run:: the docker service wraps the inline run-script, so pairing it with a path: pointer or a preset entry is always silent-noop territory.

pub fn resolve_path(&self, name: &str, parent_dir: &Path) -> PathBuf

Resolve the effective directory for a Path-kind command declared in parent_dir. Applies the ./<name>/ convention when path is unset.

Trait Implementations

impl Clone for CommandSpec

fn clone(&self) -> CommandSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandSpec

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

Formats the value using the given formatter.

impl Default for CommandSpec

fn default() -> CommandSpec

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CommandSpec

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.