Enum VersionChannel 

pub enum VersionChannel {
    Stable,
    Previous,
    Newest,
    Prod,
    PreProd,
    Staging,
    Canary,
    Test,
    Dev,
}

Available on crate feature serve only.

A named version channel — a pointer at one numeric version.

Versions are numeric builds; channels are the human-facing names a build is promoted into, like npm dist-tags. Three are derived (computed, never assignable):

• Self::Stable — the launched version, and what an unpinned request resolves to. Moved only by an explicit launch, so a newly registered build (a nightly, a feature branch) never drags existing callers with it.
• Self::Previous — the version launched before the current one, for a one-step rollback. Empty until a second launch has happened.
• Self::Newest — the highest version number, launched or not. The “run what I just pushed” selector for development and CI.

The rest are assignable environment pointers moved with promote. The set is deliberately closed: an open tag namespace becomes a second, unreviewable naming system in which a typo (prd) silently creates a channel nobody watches. Free-form labels belong on the run, not in the registry.

Variants

Stable

The launched version — the default for an unpinned request. Derived from the launch log; moved by launch, never by promote.

Previous

The previously launched version. Derived; the rollback target.

Newest

The highest registered version number, launched or not. Derived.

Prod

Production.

PreProd

Pre-production / release-candidate soak.

Staging

Staging.

Canary

A partial-traffic canary ahead of prod.

Test

QA / integration testing.

Dev

Day-to-day development.

Implementations

impl VersionChannel

pub const ALL: &'static [Self]

Every channel: the derived release pointers first, then the assignable environments in promotion order (dev → … → prod). Drives help text, error messages, and --tag completion.

pub const ASSIGNABLE: &'static [Self]

The channels a caller may promote. Excludes the three derived release pointers — stable moves via launch, and previous / newest are computed.

pub fn as_str(self) -> &'static str

pub fn is_derived(self) -> bool

Whether this channel is computed rather than assigned. A derived channel can never be the target of promote.

pub fn parse(raw: &str) -> CliResult<Self>

Parse a channel name. Case-insensitive, and -/_ separators are interchangeable, so pre-prod, pre_prod, PreProd, and preprod all name the same channel.

latest gets a bespoke error rather than the generic one: it is the most likely thing a newcomer types, and both plausible meanings exist under other names, so naming them is more useful than listing all nine.

Trait Implementations

impl Clone for VersionChannel

fn clone(&self) -> VersionChannel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for VersionChannel

impl Debug for VersionChannel

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

Formats the value using the given formatter.

impl Default for VersionChannel

fn default() -> VersionChannel

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for VersionChannel

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for VersionChannel

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

Formats the value using the given formatter.

impl Eq for VersionChannel

impl Ord for VersionChannel

fn cmp(&self, other: &VersionChannel) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for VersionChannel

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for VersionChannel

fn partial_cmp(&self, other: &VersionChannel) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for VersionChannel

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for VersionChannel