qsv_docopt 1.10.0

Command line argument parsing.
Documentation
use std::{
    collections::hash_map::{Iter, Keys},
    fmt::Debug,
    hash::Hash,
    mem,
};

use ahash::AHashMap;

#[derive(Clone)]
pub struct SynonymMap<K, V> {
    vals: AHashMap<K, V>,
    syns: AHashMap<K, K>,
}

impl<K: Eq + Hash, V> Default for SynonymMap<K, V> {
    fn default() -> Self {
        Self::new()
    }
}

impl<K: Eq + Hash, V> SynonymMap<K, V> {
    pub fn new() -> SynonymMap<K, V> {
        SynonymMap {
            vals: AHashMap::new(),
            syns: AHashMap::new(),
        }
    }

    #[inline]
    pub fn insert_synonym(&mut self, from: K, to: K) -> bool {
        assert!(self.vals.contains_key(&to));
        self.syns.insert(from, to).is_none()
    }

    #[inline]
    pub fn keys(&self) -> Keys<'_, K, V> {
        self.vals.keys()
    }

    #[inline]
    pub fn iter(&self) -> Iter<'_, K, V> {
        self.vals.iter()
    }

    #[inline]
    pub fn synonyms(&self) -> Iter<'_, K, K> {
        self.syns.iter()
    }

    #[inline]
    pub fn find(&self, k: &K) -> Option<&V> {
        self.with_key(k, |k| self.vals.get(k))
    }

    #[inline]
    pub fn contains_key(&self, k: &K) -> bool {
        self.with_key(k, |k| self.vals.contains_key(k))
    }

    #[inline]
    pub fn len(&self) -> usize {
        self.vals.len()
    }

    #[inline]
    fn with_key<T, F>(&self, k: &K, with: F) -> T
    where
        F: FnOnce(&K) -> T,
    {
        if self.syns.contains_key(k) {
            with(&self.syns[k])
        } else {
            with(k)
        }
    }
}

impl<K: Eq + Hash + Clone, V> SynonymMap<K, V> {
    #[inline]
    pub fn resolve(&self, k: &K) -> K {
        self.with_key(k, std::clone::Clone::clone)
    }

    #[inline]
    pub fn get<'a>(&'a self, k: &K) -> &'a V {
        self.find(k).unwrap()
    }

    #[inline]
    pub fn find_mut<'a>(&'a mut self, k: &K) -> Option<&'a mut V> {
        if self.syns.contains_key(k) {
            self.vals.get_mut(&self.syns[k])
        } else {
            self.vals.get_mut(k)
        }
    }

    #[inline]
    pub fn swap(&mut self, k: K, mut new: V) -> Option<V> {
        // If `k` is a registered synonym, the stored value lives under the
        // canonical key in `self.vals`, not under the synonym itself.
        if let Some(canonical) = self.syns.get(&k).cloned() {
            let old = self.vals.get_mut(&canonical).unwrap();
            mem::swap(old, &mut new);
            Some(new)
        } else {
            self.vals.insert(k, new)
        }
    }

    #[inline]
    pub fn insert(&mut self, k: K, v: V) -> bool {
        self.swap(k, v).is_none()
    }
}

impl<K: Eq + Hash + Clone, V> FromIterator<(K, V)> for SynonymMap<K, V> {
    fn from_iter<T: IntoIterator<Item = (K, V)>>(iter: T) -> SynonymMap<K, V> {
        let mut map = SynonymMap::new();
        for (k, v) in iter {
            map.insert(k, v);
        }
        map
    }
}

impl<K: Eq + Hash + Debug, V: Debug> Debug for SynonymMap<K, V> {
    fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
        self.vals.fmt(f)?;
        write!(f, " (synonyms: {:?})", self.syns)
    }
}