Struct NetworkStore 

pub struct NetworkStore { /* private fields */ }

Persistent store for network configurations.

Implementations

impl NetworkStore

pub fn new(path: impl Into<PathBuf>) -> Self

Create a new store at the given path.

pub fn default_path() -> Result<Self>

Create a store at the default location (~/.a3s/networks.json).

pub fn load(&self) -> Result<HashMap<String, NetworkConfig>>

Load all networks from disk.

pub fn save(&self, networks: &HashMap<String, NetworkConfig>) -> Result<()>

Save all networks to disk (atomic write).

pub fn get(&self, name: &str) -> Result<Option<NetworkConfig>>

Get a single network by name.

pub fn with_write_lock<F, R, E>(&self, f: F) -> Result<R, E>

where F: FnOnce(&mut HashMap<String, NetworkConfig>) -> Result<R, E>, E: From<BoxError>,

Run f against the full networks map under the cross-process write lock (load-fresh → mutate → save). Use this to make a get-modify-update sequence atomic — e.g. allocate-an-IP-then-connect — so concurrent boots cannot assign duplicate IPs/MACs or silently lose each other’s endpoints. The map is saved only if f returns Ok.

The lock is held across the whole load/mutate/save; save is itself lock-free, so there is no re-entrant flock (which would self-deadlock).

pub fn create(&self, config: NetworkConfig) -> Result<()>

Create a new network. Returns error if name already exists.

pub fn remove(&self, name: &str) -> Result<NetworkConfig>

Remove a network by name. Returns the removed config or error if not found.

pub fn list(&self) -> Result<Vec<NetworkConfig>>

List all network names.

pub fn update(&self, config: &NetworkConfig) -> Result<()>

Update a network in-place (used for connect/disconnect).

Prefer with_write_lock for a get-modify-update sequence: update re-loads under the lock, but a caller that read the network before calling update decided its mutation on a possibly-stale snapshot.

pub fn path(&self) -> &Path

Get the store file path.

Trait Implementations

impl Debug for NetworkStore

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

Formats the value using the given formatter.

impl NetworkStoreBackend for NetworkStore

fn get(&self, name: &str) -> Result<Option<NetworkConfig>>

Get a network by name.

fn create(&self, config: NetworkConfig) -> Result<()>

Create a new network. Returns error if name already exists.

fn remove(&self, name: &str) -> Result<NetworkConfig>

Remove a network by name. Returns the removed config.

fn list(&self) -> Result<Vec<NetworkConfig>>

List all networks.

fn update(&self, config: &NetworkConfig) -> Result<()>

Update a network in-place (e.g., after connect/disconnect).