Enum Phase 

pub enum Phase {
    Development,
    Integrate,
    Review,
    Release,
}

Which part of a change’s life an event belongs to.

Four phases over one change: the work is made (Development), it is brought together with the base it is going onto (Integrate), it is proposed and ruled on (Review), and what carries it is released (Release). A consumer reading a session under an attention budget names a phase rather than enumerating the kinds that happen to be in it — which is what makes a kind added later arrive in the read that already wanted it.

Spelled Phase rather than Lifecycle, because crate::Lifecycle is already where a session is in its life and the two are different questions: a session that has closed still has a change in review.

Variants

Development

The work is being made: the session, its clone, its lock, its commits, the repair of a branch that carried an incomplete step, and the push of the session’s own branch.

Integrate

The work is being brought together with the base: the host’s merge queue, the merge it completed, a base that moved out from under the publication, and a push of any branch but the session’s own.

Review

The change request is open and being ruled on: it was opened, its checks moved, and it merged.

Release

What carries the landed change is being released: a probe was run, a person acknowledged a release, and a landing was observed as released.

Implementations

impl Phase

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

The word this phase is spelled with, in a filter and in a rendering.

pub fn every() -> [Phase; 4]

Every phase, in the order a refusal lists them.

pub fn of(kind: EventKind) -> Option<Phase>

The phase an event of this kind belongs to, where the kind alone decides it.

None for exactly one kind, and it is not an omission: a Push of the session’s own branch is Development and a push of anything else — the base a local-direct squash lands on, the base a merge train advanced — is Integrate. Which of the two it was is a fact about the push rather than about the kind, so the producer stamps it and this answers that it cannot.

Trait Implementations

impl Clone for Phase

fn clone(&self) -> Phase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Phase

impl Debug for Phase

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Phase

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Phase

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

Formats the value using the given formatter.

impl Eq for Phase

impl Hash for Phase

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Phase

fn cmp(&self, other: &Phase) -> 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.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

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

Restrict a value to a certain range.

impl PartialEq for Phase

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Phase

fn partial_cmp(&self, other: &Phase) -> 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 Phase

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Phase