Struct DeviceAlias 

pub struct DeviceAlias {
    pub alias: String,
    pub serial: Option<String>,
    pub name: Option<String>,
    pub mac_address: Option<String>,
    pub macos_uuid: Option<String>,
    pub notes: Option<String>,
    pub created_at: Option<String>,
    pub updated_at: Option<String>,
}

A cross-platform device alias that can store multiple identifiers.

This allows identifying the same physical device across different platforms and machines, where the identifier format varies.

Example

use aranet_core::platform::DeviceAlias;

let alias = DeviceAlias::new("Living Room")
    .with_serial("SN123456")
    .with_name("Aranet4 12345")
    .with_mac("AA:BB:CC:DD:EE:FF");

// Get the best identifier for the current platform
let id = alias.resolve();

Fields

alias: String

User-friendly name for this device.

serial: Option<String>

Device serial number (most reliable cross-platform ID).

name: Option<String>

Device name (e.g., “Aranet4 12345”).

mac_address: Option<String>

Bluetooth MAC address (Linux/Windows).

macos_uuid: Option<String>

CoreBluetooth UUID (macOS only).

notes: Option<String>

Notes or description for this device.

created_at: Option<String>

When this alias was created.

updated_at: Option<String>

When this alias was last updated.

Implementations

impl DeviceAlias

pub fn new(alias: impl Into<String>) -> Self

Create a new device alias with the given user-friendly name.

pub fn with_serial(self, serial: impl Into<String>) -> Self

Set the device serial number.

pub fn with_name(self, name: impl Into<String>) -> Self

Set the device name.

pub fn with_mac(self, mac: impl Into<String>) -> Self

Set the MAC address (for Linux/Windows).

pub fn with_uuid(self, uuid: impl Into<String>) -> Self

Set the macOS UUID.

pub fn with_notes(self, notes: impl Into<String>) -> Self

Set notes for this device.

pub fn resolve(&self) -> Option<String>

Resolve the alias to a platform-appropriate identifier.

Resolution order:

1. On macOS: macos_uuid → name → serial
2. On Linux/Windows: mac_address → name → serial

Returns None if no suitable identifier is available.

pub fn matches(&self, identifier: &str) -> bool

Check if this alias matches a given identifier.

This checks against all stored identifiers (serial, name, MAC, UUID).

pub fn update_identifier(&mut self, identifier: &str)

Update the platform-specific identifier.

Call this after connecting to a device to update the alias with the current platform’s identifier.

Trait Implementations

impl Clone for DeviceAlias

fn clone(&self) -> DeviceAlias

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceAlias

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DeviceAlias

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DeviceAlias

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

where __S: Serializer,

Serialize this value into the given Serde serializer.