Enum RolloutError 

#[non_exhaustive]
pub enum RolloutError {
    Under {
        total: u32,
    },
    Over {
        total: u32,
    },
    Gap {
        bucket: u8,
    },
    Overlap {
        bucket: u8,
    },
    InvalidRange {
        rollout: Rollout,
    },
}

Why a rollout set is not a valid traffic split.

Its own type rather than an Error: these are pure arithmetic checks with no engine involvement, and routing them through the engine error would attach retryability classification that means nothing here.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Under

Percentages sum to less than 100. The shortfall matches nothing, so that slice of traffic is silently dropped.

Fields

total: u32

What the percentages actually summed to.

Over

Percentages sum to more than 100. The excess pushes later entries past the end of the bucket space, where they can never match.

Fields

total: u32

What the percentages actually summed to.

Gap

No range in the set serves this bucket — traffic mapping to it matches nothing. Reported at the lowest such bucket.

Fields

bucket: u8

The unserved bucket.

Overlap

More than one range serves this bucket, so which workflow answers depends on ordering rather than on the rollout. Reported at the lowest such bucket.

Fields

bucket: u8

The doubly-served bucket.

InvalidRange

A range is inverted (bucket_end < bucket_start) or reaches past bucket 100. An empty range (bucket_end == bucket_start) is not this — that is a legitimate 0% entry.

Fields

rollout: Rollout

The offending range.

Trait Implementations

impl Clone for RolloutError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RolloutError

impl Debug for RolloutError

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

Formats the value using the given formatter.

impl Display for RolloutError

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

Formats the value using the given formatter.

impl Eq for RolloutError

impl Error for RolloutError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for RolloutError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RolloutError