Enum Condition 

pub enum Condition {
    ElementFound {
        scope: String,
        selector: SelectorPath,
    },
    ElementEnabled {
        scope: String,
        selector: SelectorPath,
    },
    ElementVisible {
        scope: String,
        selector: SelectorPath,
    },
    ElementHasText {
        scope: String,
        selector: SelectorPath,
        pattern: TextMatch,
    },
    ElementHasChildren {
        scope: String,
        selector: SelectorPath,
    },
    WindowWithAttribute {
        title: Option<TitleMatch>,
        automation_id: Option<String>,
        pid: Option<u32>,
        process: Option<String>,
    },
    ProcessRunning {
        process: String,
    },
    WindowClosed {
        anchor: String,
    },
    WindowWithState {
        anchor: String,
        state: WindowState,
    },
    DialogPresent {
        scope: String,
    },
    DialogAbsent {
        scope: String,
    },
    ForegroundIsDialog {
        scope: String,
        title: Option<TitleMatch>,
    },
    FileExists {
        path: String,
    },
    Always,
    ExecSucceeded,
    EvalCondition {
        expr: String,
    },
    TabWithAttribute {
        scope: String,
        title: Option<TextMatch>,
        url: Option<TextMatch>,
    },
    TabWithState {
        scope: String,
        expr: String,
    },
    AllOf {
        conditions: Vec<Condition>,
    },
    AnyOf {
        conditions: Vec<Condition>,
    },
    Not {
        condition: Box<Condition>,
    },
}

Custom Deserialize via TryFrom<serde_yaml::Value> to work around the serde limitation that #[serde(tag)] + #[serde(flatten)] don’t compose in serde_yaml. We hand-roll the mapping from a YAML map to enum variants.

Variants

ElementFound

Fields

scope: String

selector: SelectorPath

ElementEnabled

Fields

scope: String

selector: SelectorPath

ElementVisible

Fields

scope: String

selector: SelectorPath

ElementHasText

Fields

scope: String

selector: SelectorPath

pattern: TextMatch

ElementHasChildren

Fields

scope: String

selector: SelectorPath

WindowWithAttribute

Any application window matches the given attribute filters. YAML: type: WindowWithAttribute + at least one of:

• flat title fields: exact, contains, starts_with
• automation_id: <string> (exact match on UIA AutomationId / AXIdentifier)
• pid: <u32> (exact process ID match) Optional process: <name> restricts to a specific process (case-insensitive, no .exe).

Fields

title: Option<TitleMatch>

automation_id: Option<String>

pid: Option<u32>

process: Option<String>

ProcessRunning

True when any application window belongs to a process whose name (without .exe) matches process (case-insensitive). YAML: type: ProcessRunning + process: <name>.

Fields

process: String

WindowClosed

True when the window anchored to anchor is no longer open. If the anchor was mounted with a PID (AnchorDef::session_pid), the check is done at the process level (no window for that PID exists). Otherwise it falls back to attempting re-resolution of the anchor.

Fields

anchor: String

WindowWithState

True when the anchor’s window is in the given state.

Fields

anchor: String

state: WindowState

DialogPresent

Fields

scope: String

DialogAbsent

Fields

scope: String

ForegroundIsDialog

Fields

scope: String

title: Option<TitleMatch>

FileExists

True when the file at path exists on disk. path supports {output.*} substitution via apply_output.

Fields

path: String

Always

Always evaluates to true immediately. Use as expect on steps where success is guaranteed by the action itself (e.g. Capture, NoOp).

ExecSucceeded

True when the most recent Exec action exited with code 0. Fails (step times out) if the process exited non-zero.

EvalCondition

Evaluates a boolean expression against the current output, locals, and params. The expression must return a Bool (use a comparison operator). Example: "count % 10 == 0", "score >= param.threshold"

Fields

expr: String

TabWithAttribute

True when the browser tab anchored to scope matches the given attribute filters. YAML: type: TabWithAttribute + at least one of:

• title: TextMatch against the tab’s current title.
• url: TextMatch against the tab’s current URL. scope must name a mounted Tab anchor.

Fields

scope: String

title: Option<TextMatch>

url: Option<TextMatch>

TabWithState

True when the JS expression expr evaluates to a truthy value in the browser tab scope. YAML: type: TabWithState + scope (Tab anchor) + expr (JS expression string). Example: expr: "document.readyState === 'complete'"

Fields

scope: String

expr: String

AllOf

Fields

conditions: Vec<Condition>

AnyOf

Fields

conditions: Vec<Condition>

Not

Fields

condition: Box<Condition>

Implementations

impl Condition

pub fn apply_output( &self, locals: &HashMap<String, String>, output: &Output, ) -> Self

Return a clone with all {output.<key>} tokens substituted in pattern strings.

pub fn scope_name(&self) -> Option<&str>

pub fn describe(&self) -> String

pub fn evaluate<D: Desktop>( &self, dom: &mut ShadowDom<D>, desktop: &D, locals: &HashMap<String, String>, params: &HashMap<String, String>, output: &Output, ) -> Result<bool, AutomataError>

Trait Implementations

impl Clone for Condition

fn clone(&self) -> Condition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Condition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Condition

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Condition

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn json_schema(sg: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

impl TryFrom<Value> for Condition

type Error = String

The type returned in the event of a conversion error.

fn try_from(v: Value) -> Result<Self, String>

Performs the conversion.