# RunQuery

## pub enum RunQuery

A query for searching runs, which can be composed into a tree with [`and`](https://dev.nominal.io/rust-client/ref/rust/nominal/core/enum.RunQuery.md#method.and "nominal::core::RunQuery::and"), [`or`](https://dev.nominal.io/rust-client/ref/rust/nominal/core/enum.RunQuery.md#method.or "nominal::core::RunQuery::or"), and [`not`](https://dev.nominal.io/rust-client/ref/rust/nominal/core/enum.RunQuery.md#method.not "nominal::core::RunQuery::not").

## Variants

### SearchText(String)

Fuzzy full-text search against title and description.

### SubstringMatch(String)

Case-insensitive substring match against the run name.

### Label(String)

Filter by label.

### Property(String, String)

Filter by property key and value.

### RunNumber(u32)

Filter by run number.

### StartTimeInclusive(DateTime<Utc>)

Filter runs whose start time is at or after this timestamp.

### EndTimeInclusive(DateTime<Utc>)

Filter runs whose end time is at or before this timestamp.

### And(Vec<RunQuery>)

All sub-queries must match.

### Or(Vec<RunQuery>)

At least one sub-query must match.

### Not(Box<RunQuery>)

Negates the sub-query.

## Implementations

### impl RunQuery

#### pub fn search_text(text: impl Into<String>) -> Self

#### pub fn substring_match(text: impl Into<String>) -> Self

#### pub fn label(label: impl Into<String>) -> Self

#### pub fn property(key: impl Into<String>, value: impl Into<String>) -> Self

#### pub fn run_number(n: u32) -> Self

#### pub fn start_time_inclusive(t: DateTime<Utc>) -> Self

#### pub fn end_time_inclusive(t: DateTime<Utc>) -> Self

#### pub fn and(queries: impl IntoIterator<Item = RunQuery>) -> Self

#### pub fn or(queries: impl IntoIterator<Item = RunQuery>) -> Self

#### pub fn not(query: RunQuery) -> Self

## Trait implementations

**Derived**: [`Debug`](https://doc.rust-lang.org/1.98.1/core/fmt/trait.Debug.html), [`Clone`](https://doc.rust-lang.org/1.98.1/core/clone/trait.Clone.html)

**Auto traits**: [`Send`](https://doc.rust-lang.org/1.98.1/core/marker/trait.Send.html), [`Sync`](https://doc.rust-lang.org/1.98.1/core/marker/trait.Sync.html), [`Unpin`](https://doc.rust-lang.org/1.98.1/core/marker/trait.Unpin.html), [`UnwindSafe`](https://doc.rust-lang.org/1.98.1/core/panic/unwind_safe/trait.UnwindSafe.html), [`RefUnwindSafe`](https://doc.rust-lang.org/1.98.1/core/panic/unwind_safe/trait.RefUnwindSafe.html)
