Struct ServiceIdentity 

pub struct ServiceIdentity { /* private fields */ }

A service installation, independent of its binary version or process ID.

Generate a UUID once per service and store its bytes in the consumer package. Never generate a new UUID at startup or per release. Also use a reverse-DNS name, for example ninja.kunobi.kache. Profiles separate installations such as stable and dev; instances allow multiple services within one profile. Each component is canonical lowercase ASCII to avoid aliases on case-insensitive filesystems.

Implementations

impl ServiceIdentity

pub fn new( id: [u8; 16], application: impl Into<String>, profile: impl Into<String>, instance: impl Into<String>, ) -> Result<Self>

Validate an identity without creating directories or changing permissions.

pub fn id(&self) -> &[u8; 16]

Package-owned UUID bytes, fixed across all versions of this service.

pub fn application(&self) -> &str

Application-owned name. It must remain stable across binary upgrades.

pub fn profile(&self) -> &str

Installation profile, such as stable or dev.

pub fn instance(&self) -> &str

Named service instance.

pub fn paths(&self, user_root: impl AsRef<Path>) -> Result<ServicePaths>

Derive disjoint paths below a private per-user runtime directory.

The caller secures the root and creates these directories. Prefixes avoid Windows device names; distinct components cannot alias through separators. No version is included, so an upgrader finds its predecessor’s resources.

Fails when the directory leaves no room for ServicePaths::control_socket in a Unix socket address; the error says how long it may be. Check the application’s own sockets with ServicePaths::sockets.

Trait Implementations

impl Clone for ServiceIdentity

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 ServiceIdentity

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

Formats the value using the given formatter.

impl Eq for ServiceIdentity

impl Hash for ServiceIdentity

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 ServiceIdentity

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ServiceIdentity