Struct ProviderDeviceIdentity 

pub struct ProviderDeviceIdentity { /* private fields */ }

Immutable runtime-control-plane binding of a provider to one physical target.

The target identity is opaque to the runtime and is canonicalized by the provider. It is not tenferro_tensor::DeviceId or tensor placement data. This immutable provider/target pair is the durable identity carried by runtime snapshots, execution locations, and transfer requests. Because this value appears in structured diagnostics and debug output, it accepts nonempty ASCII graphic text (no controls, whitespace, or Unicode confusables). Providers that need byte-level or Unicode identities must first canonicalize them into an escaped diagnostic-safe ASCII form. Equality, ordering, and hashing include both the provider and target.

Examples

use tenferro_runtime::{ProviderDeviceIdentity, ProviderId};

let identity = ProviderDeviceIdentity::new(ProviderId::new("tenferro.cuda")?, "device-0")?;
assert_eq!(identity.provider_id().as_str(), "tenferro.cuda");
assert_eq!(identity.target_identity(), "device-0");

Implementations

impl ProviderDeviceIdentity

pub fn new( provider_id: ProviderId, target_identity: impl Into<Arc<str>>, ) -> Result<Self, IdentityError>

Construct a provider binding from a validated provider and opaque target.

Errors

Returns IdentityError with IdentityKind::ProviderTarget when the provider-canonical target identity is empty or is not ASCII graphic text. Target text is deliberately diagnostic-safe; opaque provider-specific byte or Unicode identities must be encoded by the provider before construction.

Examples

use tenferro_runtime::{ProviderDeviceIdentity, ProviderId};

let identity = ProviderDeviceIdentity::new(
    ProviderId::new("tenferro.cpu")?,
    "host-0",
)?;
assert_eq!(identity.target_identity(), "host-0");

pub fn provider_id(&self) -> &ProviderId

Return the validated provider namespace.

Examples

use tenferro_runtime::{ProviderDeviceIdentity, ProviderId};

let provider = ProviderId::new("tenferro.cpu")?;
let identity = ProviderDeviceIdentity::new(provider.clone(), "host-0")?;
assert_eq!(identity.provider_id(), &provider);

pub fn target_identity(&self) -> &str

Return the provider-canonical opaque target identity.

Examples

use tenferro_runtime::{ProviderDeviceIdentity, ProviderId};

let identity = ProviderDeviceIdentity::new(ProviderId::new("tenferro.cpu")?, "host-0")?;
assert_eq!(identity.target_identity(), "host-0");

Trait Implementations

impl Clone for ProviderDeviceIdentity

fn clone(&self) -> ProviderDeviceIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderDeviceIdentity

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

Formats the value using the given formatter.

impl Hash for ProviderDeviceIdentity

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 Ord for ProviderDeviceIdentity

fn cmp(&self, other: &ProviderDeviceIdentity) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ProviderDeviceIdentity

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

fn partial_cmp(&self, other: &ProviderDeviceIdentity) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for ProviderDeviceIdentity

impl StructuralPartialEq for ProviderDeviceIdentity