Enum LocalReason 

pub enum LocalReason {
    Alias(&'static str),
    ProcessLifecycle,
    WritesRepository,
    SessionLocal,
    RendersCapability(&'static str),
}

Why a command belongs to the command line alone.

The variants are the four structural reasons this executable has, and there is no fifth for “not projected yet”: a read that belongs in the API and is missing from it is a defect, and a vocabulary that can express it politely is a vocabulary that will.

Variants

Alias(&'static str)

The command runs a default subcommand when none is given: it is that command’s other name, not an operation of its own. The target is the full command, as a person types it after majordomus.

ProcessLifecycle

What the command produces is a running process, not a value. There is nothing for a request/response projection to return, and the caller of such a projection would be asking the server to become a different server.

WritesRepository

The command writes into the repository. Every projection of the registry is read-only — that is the executable’s first promise — so a command that writes is offered to the person who runs the executable and to nobody over a network.

SessionLocal

The command answers about the working copy and the shell that invoked it. A caller over HTTP or MCP does not share either, so the same question asked over a socket would be a different question with the same name, which is worse than not asking it.

RendersCapability(&'static str)

The command renders, for a person at a terminal, the value the named capability answers. The operation is in the API; this is its terminal rendering. The domain logic is shared — the command and the capability read the same resolution — and only the shaping of the output is the command’s own.

Implementations

impl LocalReason

pub fn renders(self) -> Option<&'static str>

The capability this command renders, when it renders one.

use majordomus_cli::cli::local::LocalReason;
assert_eq!(LocalReason::RendersCapability("web.surfaces").renders(), Some("web.surfaces"));
assert_eq!(LocalReason::ProcessLifecycle.renders(), None);

pub fn aliases(self) -> Option<&'static str>

The command this one is another name for, when it is.

use majordomus_cli::cli::local::LocalReason;
assert_eq!(LocalReason::Alias("why list").aliases(), Some("why list"));
assert_eq!(LocalReason::SessionLocal.aliases(), None);

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

The short word a report and the generated reference show.

use majordomus_cli::cli::local::LocalReason;
assert_eq!(LocalReason::WritesRepository.as_str(), "writes_repository");
assert_eq!(LocalReason::Alias("why list").as_str(), "alias");

Trait Implementations

impl Clone for LocalReason

fn clone(&self) -> LocalReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for LocalReason

impl Debug for LocalReason

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

Formats the value using the given formatter.

impl Eq for LocalReason

impl PartialEq for LocalReason

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for LocalReason