Struct SubjectUrn 

pub struct SubjectUrn(/* private fields */);

Tranche-1 seam-freeze G3 subject URN.

Promotes the CloudEvents subject envelope field from a free-form string (cell:<id> was the legacy convention) to a typed, validated URN of the form urn:<tool>:<kind>:<id>. See docs/seam-freeze-v1.md §3 G3 / §4.

0ryant-shell and tedit use the URN prefix as a routing key; CellOS emitters use cell_subject_urn for cell subjects. Other tools mint their own (urn:tsafe:lease:<id>, urn:tencrypt:cert:<id>, etc.).

Validation rules (see SubjectUrn::parse):

1. must start with the literal scheme urn:;
2. exactly four colon-separated segments — urn, <tool>, <kind>, <id> — where <id> may itself contain colons;
3. <tool>, <kind>, <id> must each be non-empty;
4. <tool> and <kind> are restricted to lowercase ASCII alphanumerics and - (charset [a-z0-9-]);
5. no ASCII control characters and no whitespace anywhere.

<id> is intentionally permissive on charset (so producers can carry existing IDs like ULIDs, UUIDs, or cell-<host>-<n>) but still must not contain ASCII control or whitespace.

Implementations

impl SubjectUrn

pub fn parse(s: impl Into<String>) -> Result<Self, SubjectUrnError>

Validate s and wrap it as a typed SubjectUrn. See the type-level documentation for the exact rules.

pub fn as_str(&self) -> &str

Borrow the validated URN as a &str.

pub fn into_inner(self) -> String

Consume the wrapper and return the owned string.

Trait Implementations

impl AsRef<str> for SubjectUrn

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for SubjectUrn

fn clone(&self) -> SubjectUrn

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubjectUrn

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

Formats the value using the given formatter.

impl Display for SubjectUrn

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

Formats the value using the given formatter.

impl Hash for SubjectUrn

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 PartialEq for SubjectUrn

fn eq(&self, other: &SubjectUrn) -> 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 Serialize for SubjectUrn

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for SubjectUrn

impl StructuralPartialEq for SubjectUrn