Enum RenameError 

pub enum RenameError {
    NotFound(String),
    InvalidName(String),
    Reserved(String),
    PostCondition(String),
}

Why a rename_with_cascade did not complete. Unlike CascadeError there is no Refused variant: rename rewrites HARD references to follow the new name rather than refusing, so the only failures are bad inputs and the post-condition bug-guard.

Variants

NotFound(String)

The source alias does not exist.

InvalidName(String)

The new alias is unusable: fails validate_alias_key, collides with an existing entry, or equals the current name. Carries the reason.

Reserved(String)

The source or target alias is reserved (the default agent).

PostCondition(String)

Bug guard: rewrite drifted from find_all_references and left a dangling reference to the OLD alias. The config WAS mutated (key swapped + refs rewritten) — the caller must NOT persist it. Unreachable while rewrite and the collect_* walks mirror each other (same sites, same trim split).

Trait Implementations

impl Debug for RenameError

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

Formats the value using the given formatter.

impl Display for RenameError

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

Formats the value using the given formatter.

impl Error for RenameError

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.