Struct MultiAccountState 

pub struct MultiAccountState<T> { /* private fields */ }

Account-partitioned state container.

Holds one T per account id. The default_account_id is pre-created at startup so unauthenticated requests (which fall back to --account-id) always have a state to land in.

Implementations

impl<T: AccountState> MultiAccountState<T>

pub fn new(default_account_id: &str, region: &str, endpoint: &str) -> Self

Create a new container, pre-populating the default account.

pub fn get_or_create(&mut self, account_id: &str) -> &mut T

Get or lazily create the state for account_id.

When a new account is created, AccountState::inherit_from is called with the default account’s state so services can propagate shared resources (e.g. body caches).

pub fn get_or_create_with<F>(&mut self, account_id: &str, init: F) -> &mut T

where F: FnOnce(&mut T),

Get or lazily create the state for account_id, then run init on the newly created state. The callback is only invoked when the account is freshly created, not on subsequent lookups.

pub fn get(&self, account_id: &str) -> Option<&T>

Read-only lookup. Returns None if the account has never been seen.

pub fn get_mut(&mut self, account_id: &str) -> Option<&mut T>

Mutable lookup without auto-creation.

pub fn iter(&self) -> impl Iterator<Item = (&str, &T)>

Iterate over all account states (read-only).

pub fn iter_mut(&mut self) -> impl Iterator<Item = (&str, &mut T)>

Iterate over all account states (mutable).

pub fn default_account_id(&self) -> &str

The default account id configured via --account-id.

pub fn default_mut(&mut self) -> &mut T

Mutable reference to the default account’s state (always exists).

pub fn default_ref(&self) -> &T

Reference to the default account’s state (always exists).

pub fn reset(&mut self)

Reset all accounts back to empty state. The default account is recreated; all other accounts are dropped.

pub fn find_account<F>(&self, predicate: F) -> Option<&str>

where F: Fn(&T) -> bool,

Find the first account whose state satisfies predicate and return the account id. Useful for resolving globally-unique resources (e.g. S3 bucket names) back to their owning account.

pub fn account_count(&self) -> usize

Number of accounts with state.

pub fn region(&self) -> &str

Region shared by all accounts.

pub fn endpoint(&self) -> &str

Endpoint shared by all accounts.

Trait Implementations

impl<T: Clone> Clone for MultiAccountState<T>

fn clone(&self) -> MultiAccountState<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for MultiAccountState<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for MultiAccountState<T>

where T: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Serialize for MultiAccountState<T>

where T: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.