Struct Storage

pub struct Storage { /* private fields */ }

Reads and syncs with rooms.json in RIZ_STORAGE_PATH (env var)

Expected to be wrapped by a std::sync::Mutex, then wrapped with a actix_web::web::Data, and cloned to each request

NB: All &mut methods update the contents of rooms.json

Examples

use std::sync::Mutex;
use actix_web::web::Data;
use riz::Storage;

let storage = Data::new(Mutex::new(Storage::new()));

Implementations

impl Storage

pub fn new() -> Self

Create a new Stoage object (should only do this once)

pub fn new_room(&mut self, room: Room) -> Result<Uuid>

Create a new room

Errors

Error::InvalidIP if any light in the new room has an invalid IP address

pub fn new_light(&mut self, room: &Uuid, light: Light) -> Result<Uuid>

Create a new light in the room

pub fn read(&self, room: &Uuid) -> Option<Room>

Read a room by ID (returns clone)

pub fn update_room(&mut self, id: &Uuid, room: &Room) -> Result<()>

Updates non-light attributes (currently just name)

pub fn update_light( &mut self, id: &Uuid, light_id: &Uuid, light: &Light, ) -> Result<()>

Update non-lighting attributes of the light in the room (name, ip)

pub fn delete_room(&mut self, room: &Uuid) -> Result<()>

Remove a room

pub fn delete_light(&mut self, room: &Uuid, light: &Uuid) -> Result<()>

Remove a light in a room

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

List room IDs

pub fn process_reply(&mut self, resp: &LightingResponse)

Process the response of a lighting request

Trait Implementations

impl Debug for Storage

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

Formats the value using the given formatter.

impl Default for Storage

fn default() -> Storage

Returns the “default value” for a type.