Enum ProjectsEvent 

pub enum ProjectsEvent {
    DesignersPoll {
        open: usize,
    },
    DesignersProceed {
        sessions: Vec<DesignerSeen>,
    },
    DesignersSkipped,
    RunStarted {
        run_id: String,
        action: ProjectAction,
    },
    PreImageExported {
        bytes: usize,
    },
    TagsPreImageExported {
        provider: String,
        bytes: usize,
    },
    TagImportSent {
        provider: String,
        path: String,
        policy: &'static str,
        nodes: usize,
        carry: bool,
    },
    TagValuesCarried {
        provider: String,
        path: String,
        nodes: usize,
    },
    TagProviderSettingsApplied {
        provider: String,
        action: &'static str,
    },
    TagGroupsWritten {
        providers: Vec<String>,
        written: usize,
        deleted: usize,
    },
    TagImportAnswered {
        provider: String,
        clean: bool,
    },
    TagsVerified {
        provider: String,
        equal: bool,
    },
    ImportSent {
        overwrite: bool,
    },
    ImportAnswered,
    Verified {
        equal: bool,
    },
    RecordWritten,
    RecordFailed {
        code: String,
    },
    TagRecordWritten {
        provider: String,
    },
    TagRecordFailed {
        provider: String,
        code: String,
    },
    ChildrenSettling {
        children: Vec<String>,
    },
    ChildChecked {
        name: String,
        status: ChildStatus,
    },
    RollbackStarted {
        cause: RollbackCause,
    },
    ProjectRestored {
        equal: bool,
    },
    TagGroupsRestored {
        providers: Vec<String>,
    },
    TagProviderRestored {
        provider: String,
        action: &'static str,
    },
    RollbackVerified {
        equal: bool,
    },
    TagDeleteSent {
        provider: String,
        paths: Vec<String>,
        rollback: bool,
    },
    TagDeleteAnswered {
        provider: String,
        clean: bool,
        deleted: usize,
    },
    HostPreImageWritten {
        files: usize,
    },
    JournalWritten {
        state: &'static str,
    },
    JournalCleared,
    BackupWaitStarted {
        budget_s: u64,
    },
    BackupResync {
        ok: bool,
        code: Option<String>,
    },
    BackupVerdict {
        converged: bool,
        reason: Option<&'static str>,
    },
    Finished {
        outcome: ProjectOutcome,
    },
}

A step of a run, for the events log and the observer.

The fields are names, ids, counts and hashes only: never a project file, a secret or a gateway response body.

Variants

DesignersPoll

The Designer list was read under --designers wait (25-14). Heard as it happens and logged once the run directory exists.

Fields

open: usize

How many sessions were open at that read.

DesignersProceed

--designers proceed went ahead over these open sessions (D-15).

Fields

sessions: Vec<DesignerSeen>

(user, project, host) of each open session.

DesignersSkipped

The Designer check did not run: a record run does not touch the project.

RunStarted

The run directory exists and the run is about to start.

Fields

run_id: String

The run’s id.

action: ProjectAction

What the run will do.

PreImageExported

The live project was saved into the run directory.

Fields

bytes: usize

Size of the saved export.

TagsPreImageExported

An owned tag provider’s live export was saved into the run directory (export/tags/<P>.json) before any tag write (Phase 26).

Fields

provider: String

The provider.

bytes: usize

Size of the saved export.

TagImportSent

A tag import request is about to be sent.

Fields

provider: String

The provider.

path: String

The provider-relative parent path the nodes go below (empty at the provider root).

policy: &'static str

The collision policy, as the gateway spells it.

nodes: usize

How many planned nodes the body carries.

carry: bool

Whether live values were carried into the body (R3-CARRY).

TagValuesCarried

A fresh export of the provider was read right before a carried batch, and the live values of its nodes were put into the body (R3-CARRY, R3-RACE). Paths and counts only, never a value.

Fields

provider: String

The provider.

path: String

The provider-relative parent path of the batch.

nodes: usize

How many nodes had their values carried.

TagProviderSettingsApplied

An owned provider’s settings were created or modified and read back equal to the repo’s (26-10).

Fields

provider: String

The provider.

action: &'static str

create or modify.

TagGroupsWritten

The owned providers’ tag-group units were committed, scanned and read back (26-10).

Fields

providers: Vec<String>

The providers whose groups changed, byte-sorted.

written: usize

Unit files written.

deleted: usize

Unit files deleted.

TagImportAnswered

The gateway answered a tag import.

Fields

provider: String

The provider.

clean: bool

Whether the answer reported no failure and no bad quality code.

TagsVerified

An owned provider was read back after the tag writes and compared with the repo and its pre-image.

Fields

provider: String

The provider.

equal: bool

Whether every repo node equals the export in configuration and every drift node its pre-image.

ImportSent

The import request is about to be sent.

Fields

overwrite: bool

True when the live project is replaced, false when it is created.

ImportAnswered

The gateway answered the import.

Verified

The project was read back and compared with the artifact.

Fields

equal: bool

Whether the canonical digests are equal.

RecordWritten

The release record was written.

RecordFailed

The release record could not be written.

Fields

code: String

The error’s slug.

TagRecordWritten

The tag record of an owned provider was written (26-08).

Fields

provider: String

The provider.

TagRecordFailed

The tag record of an owned provider could not be written.

Fields

provider: String

The provider.

code: String

The error’s slug.

ChildrenSettling

The sweep found projects that inherit from the deployed one and is reading their exports until they settle (D-06, K7).

Fields

children: Vec<String>

The children, byte-sorted.

ChildChecked

One child was compared with its release record.

Fields

name: String

The child’s name.

status: ChildStatus

How it compared.

RollbackStarted

The run failed after its first tag write and its automatic rollback starts (26-11).

Fields

cause: RollbackCause

Why.

ProjectRestored

The rollback imported the project’s pre-image again and read it back (26-11).

Fields

equal: bool

Whether it reads back as the pre-image.

TagGroupsRestored

The rollback put the run’s tag-group units back from its snapshot (26-11).

Fields

providers: Vec<String>

The providers whose groups the run changed, byte-sorted.

TagProviderRestored

The rollback put an owned provider’s settings back (modify) or deleted a provider the run created (delete) (26-11).

Fields

provider: String

The provider.

action: &'static str

modify or delete.

RollbackVerified

The rollback read the owned providers back and compared them with their pre-images (26-11).

Fields

equal: bool

Whether every node equals its pre-image.

TagDeleteSent

A tagDelete route call was sent (26-19): the provider and the provider-relative paths it named; rollback for the removal of what a failed run created.

Fields

provider: String

The provider.

paths: Vec<String>

The paths the call named, in request order.

rollback: bool

Whether the call is part of a rollback.

TagDeleteAnswered

The tagDelete route answered a call (26-19).

Fields

provider: String

The provider.

clean: bool

Every result was a clean delete.

deleted: usize

How many paths it removed.

HostPreImageWritten

The run’s pre-image was written to the gateway host (26-12): every file of the set, run.json last, before the first gateway write.

Fields

files: usize

How many files the set holds, run.json included.

JournalWritten

The host journal was written (26-12).

Fields

state: &'static str

applying or rolling_back.

JournalCleared

The host journal was cleared after a green run or a verified rollback (26-12).

BackupWaitStarted

The wait for the backup’s copy of the owned tags began (26-13).

Fields

budget_s: u64

The budget of one wait, in seconds.

BackupResync

The one resync request was sent to the master (26-13).

Fields

ok: bool

The request was accepted.

code: Option<String>

The error code when it was not.

BackupVerdict

The wait for the backup ended (26-13).

Fields

converged: bool

The backup holds the master’s owned tags.

reason: Option<&'static str>

Why not: unreachable, sync_exhausted, not_syncing or content_differs.

Finished

The run ended.

Fields

outcome: ProjectOutcome

How it ended.

Implementations

impl ProjectsEvent

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

The event name events.ndjson carries.

Trait Implementations

impl Clone for ProjectsEvent

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProjectsEvent

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

Formats the value using the given formatter.

impl Eq for ProjectsEvent

impl PartialEq for ProjectsEvent

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ProjectsEvent