Struct veloren_server::settings::banlist::v1::Banlist

pub struct Banlist(pub(super) HashMap<Uuid, BanEntry>);

Tuple Fields

0: HashMap<Uuid, BanEntry>

Implementations

impl Banlist

pub fn ban_action( &mut self, data_dir: &Path, now: DateTime<Utc>, uuid: Uuid, username_when_performed: String, action: BanAction, overwrite: bool ) -> Option<Result<(), Error<Banlist>>>

Attempt to perform the ban action action for the user with UUID uuid and username username, starting from time now (the information about the banning party will be in the action record), with a settings file maintained at path root data_dir.

If trying to unban an already unbanned player, or trying to ban but the ban status would not immediately change, the “overwrite” boolean should also be set to true.

We try to detect duplicates (bans that would have no effect) and return None if such effects are encountered. Otherwise, we return Some(result), which works as follows.

If the ban was invalid for any reason, then neither the in-memory banlist nor the on-disk banlist are modified. If the ban entry is valid but the file encounters an error that prevents it from being atomically written to disk, we return an error but retain the change in memory. Otherwise, we complete successfully and atomically write the banlist to disk.

Note that the IO operation is only guaranteed atomic in the weak sense that either the whole page is written or it isn’t; we cannot guarantee that the data we read in order to modify the file was definitely up to date, so we could be missing information if the file was manually edited or a function edits it without going through the usual specs resources. So, please be careful with ad hoc modifications to the file while the server is running.

Panics if provided a ban action with info set to None, as info: None should only be used for legacy records.

TODO: Consider creating a new type specifically for the entry to avoid needing the precondition on info.

impl Banlist

pub(super) fn migrate(prev: Banlist) -> Self

One-off migration from the previous version. This must be guaranteed to produce a valid settings file as long as it is called with a valid settings file from the previous version.

pub(super) fn validate( &mut self ) -> Result<Version, <Banlist as EditableSetting>::Error>

Perform any needed validation on this banlist that can’t be done using parsing.

The returned version being “Old” indicates the loaded setting has been modified during validation (this is why validate takes &mut self).

Methods from Deref<Target = HashMap<Uuid, BanEntry>>

pub fn par_keys(&self) -> ParKeys<'_, K, V>

Visits (potentially in parallel) immutably borrowed keys in an arbitrary order.

pub fn par_values(&self) -> ParValues<'_, K, V>

Visits (potentially in parallel) immutably borrowed values in an arbitrary order.

pub fn par_eq(&self, other: &HashMap<K, V, S, A>) -> bool

Returns true if the map is equal to another, i.e. both maps contain the same keys mapped to the same values.

This method runs in a potentially parallel fashion.

pub fn allocator(&self) -> &A

Returns a reference to the underlying allocator.

pub fn hasher(&self) -> &S

Returns a reference to the map’s BuildHasher.

Examples

use hashbrown::HashMap;
use hashbrown::hash_map::DefaultHashBuilder;

let hasher = DefaultHashBuilder::default();
let map: HashMap<i32, i32> = HashMap::with_hasher(hasher);
let hasher: &DefaultHashBuilder = map.hasher();

pub fn capacity(&self) -> usize

Returns the number of elements the map can hold without reallocating.

This number is a lower bound; the HashMap<K, V> might be able to hold more, but is guaranteed to be able to hold at least this many.

Examples

use hashbrown::HashMap;
let map: HashMap<i32, i32> = HashMap::with_capacity(100);
assert_eq!(map.len(), 0);
assert!(map.capacity() >= 100);

pub fn keys(&self) -> Keys<'_, K, V>

An iterator visiting all keys in arbitrary order. The iterator element type is &'a K.

Examples

use hashbrown::HashMap;

let mut map = HashMap::new();
map.insert("a", 1);
map.insert("b", 2);
map.insert("c", 3);
assert_eq!(map.len(), 3);
let mut vec: Vec<&str> = Vec::new();

for key in map.keys() {
    println!("{}", key);
    vec.push(*key);
}

// The `Keys` iterator produces keys in arbitrary order, so the
// keys must be sorted to test them against a sorted array.
vec.sort_unstable();
assert_eq!(vec, ["a", "b", "c"]);

assert_eq!(map.len(), 3);

pub fn values(&self) -> Values<'_, K, V>

An iterator visiting all values in arbitrary order. The iterator element type is &'a V.

Examples

use hashbrown::HashMap;

let mut map = HashMap::new();
map.insert("a", 1);
map.insert("b", 2);
map.insert("c", 3);
assert_eq!(map.len(), 3);
let mut vec: Vec<i32> = Vec::new();

for val in map.values() {
    println!("{}", val);
    vec.push(*val);
}

// The `Values` iterator produces values in arbitrary order, so the
// values must be sorted to test them against a sorted array.
vec.sort_unstable();
assert_eq!(vec, [1, 2, 3]);

assert_eq!(map.len(), 3);

pub fn iter(&self) -> Iter<'_, K, V>

An iterator visiting all key-value pairs in arbitrary order. The iterator element type is (&'a K, &'a V).

Examples

use hashbrown::HashMap;

let mut map = HashMap::new();
map.insert("a", 1);
map.insert("b", 2);
map.insert("c", 3);
assert_eq!(map.len(), 3);
let mut vec: Vec<(&str, i32)> = Vec::new();

for (key, val) in map.iter() {
    println!("key: {} val: {}", key, val);
    vec.push((*key, *val));
}

// The `Iter` iterator produces items in arbitrary order, so the
// items must be sorted to test them against a sorted array.
vec.sort_unstable();
assert_eq!(vec, [("a", 1), ("b", 2), ("c", 3)]);

assert_eq!(map.len(), 3);

pub fn len(&self) -> usize

Returns the number of elements in the map.

Examples

use hashbrown::HashMap;

let mut a = HashMap::new();
assert_eq!(a.len(), 0);
a.insert(1, "a");
assert_eq!(a.len(), 1);

pub fn is_empty(&self) -> bool

Returns true if the map contains no elements.

Examples

use hashbrown::HashMap;

let mut a = HashMap::new();
assert!(a.is_empty());
a.insert(1, "a");
assert!(!a.is_empty());

pub fn get<Q>(&self, k: &Q) -> Option<&V>

where Q: Hash + Equivalent<K> + ?Sized,

Returns a reference to the value corresponding to the key.

The key may be any borrowed form of the map’s key type, but Hash and Eq on the borrowed form must match those for the key type.

Examples

use hashbrown::HashMap;

let mut map = HashMap::new();
map.insert(1, "a");
assert_eq!(map.get(&1), Some(&"a"));
assert_eq!(map.get(&2), None);

pub fn get_key_value<Q>(&self, k: &Q) -> Option<(&K, &V)>

where Q: Hash + Equivalent<K> + ?Sized,

Returns the key-value pair corresponding to the supplied key.

The supplied key may be any borrowed form of the map’s key type, but Hash and Eq on the borrowed form must match those for the key type.

Examples

use hashbrown::HashMap;

let mut map = HashMap::new();
map.insert(1, "a");
assert_eq!(map.get_key_value(&1), Some((&1, &"a")));
assert_eq!(map.get_key_value(&2), None);

pub fn contains_key<Q>(&self, k: &Q) -> bool

where Q: Hash + Equivalent<K> + ?Sized,

Returns true if the map contains a value for the specified key.

The key may be any borrowed form of the map’s key type, but Hash and Eq on the borrowed form must match those for the key type.

Examples

use hashbrown::HashMap;

let mut map = HashMap::new();
map.insert(1, "a");
assert_eq!(map.contains_key(&1), true);
assert_eq!(map.contains_key(&2), false);

pub fn raw_entry(&self) -> RawEntryBuilder<'_, K, V, S, A>

Creates a raw immutable entry builder for the HashMap.

Raw entries provide the lowest level of control for searching and manipulating a map. They must be manually initialized with a hash and then manually searched.

This is useful for

• Hash memoization
• Using a search key that doesn’t work with the Borrow trait
• Using custom comparison logic without newtype wrappers

Unless you are in such a situation, higher-level and more foolproof APIs like get should be preferred.

Immutable raw entries have very limited use; you might instead want raw_entry_mut.

Examples

use core::hash::{BuildHasher, Hash};
use hashbrown::HashMap;

let mut map = HashMap::new();
map.extend([("a", 100), ("b", 200), ("c", 300)]);

fn compute_hash<K: Hash + ?Sized, S: BuildHasher>(hash_builder: &S, key: &K) -> u64 {
    use core::hash::Hasher;
    let mut state = hash_builder.build_hasher();
    key.hash(&mut state);
    state.finish()
}

for k in ["a", "b", "c", "d", "e", "f"] {
    let hash = compute_hash(map.hasher(), k);
    let v = map.get(&k).cloned();
    let kv = v.as_ref().map(|v| (&k, v));

    println!("Key: {} and value: {:?}", k, v);

    assert_eq!(map.raw_entry().from_key(&k), kv);
    assert_eq!(map.raw_entry().from_hash(hash, |q| *q == k), kv);
    assert_eq!(map.raw_entry().from_key_hashed_nocheck(hash, &k), kv);
}

Trait Implementations

impl Clone for Banlist

fn clone(&self) -> Banlist

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for Banlist

fn default() -> Banlist

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Banlist

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl EditableSetting for Banlist

type Error = BanError

Please use this error sparingly, since we ideally want to preserve forwards compatibility for all migrations. In particular, this error should be used to fail validation of the original settings file that cannot be caught with ordinary parsing, rather than used to signal errors that occurred during migrations.

type Legacy = Banlist

Into is expected to migrate directly to the latest version, which can be implemented using “chaining”. The use of Into here rather than TryInto is intended (together with the expected use of chaining) to prevent migrations from invalidating old save files without warning; there should always be a non-failing migration path from the oldest to latest format (if the migration path fails, we can panic).

type Setting = BanlistRaw

TryInto<(Version, Self)> is expected to migrate to the latest version from any older version, using “chaining” (see super::banlist for examples).

const FILENAME: &'static str = FILENAME

fn load(data_dir: &Path) -> Self

fn edit<R>( &mut self, data_dir: &Path, f: impl FnOnce(&mut Self) -> Option<R> ) -> Option<(R, Result<(), Error<Self>>)>

If the result of calling f is None,we return None (this constitutes an early return and lets us abandon the in-progress edit). For example, this can be used to avoid adding a new ban entry if someone is already banned and the user didn’t explicitly specify that they wanted to add a new ban record, even though it would be completely valid to attach one.

fn get_path(data_dir: &Path) -> PathBuf

impl From<Banlist> for Banlist

fn from(value: Banlist) -> Self

Legacy migrations can be migrated to the latest version through the process of “chaining” migrations, starting from next::Banlist.

Note that legacy files are always valid, which is why we implement From rather than TryFrom.

impl From<Banlist> for BanlistRaw

fn from(value: Banlist) -> Self

Converts to this type from the input type.

impl Serialize for Banlist

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Banlist> for Banlist

Pretty much every TryFrom implementation except that of the very last version should look exactly like this.

type Error = <Banlist as EditableSetting>::Error

The type returned in the event of a conversion error.

fn try_from(value: Banlist) -> Result<Banlist, Self::Error>

Performs the conversion.

impl Deref for Banlist

type Target = HashMap<Uuid, BanEntry>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.