counter 0.7.1

Simple package to count generic iterables
Documentation
use crate::Counter;

use num_traits::{One, Zero};

use std::hash::{BuildHasher, Hash};
use std::iter;
use std::ops::AddAssign;

impl<T, N, S> Counter<T, N, S>
where
    T: Hash + Eq,
    N: AddAssign + Zero + One,
    S: BuildHasher + Default,
{
    /// Create a new `Counter` initialized with the given iterable.
    #[deprecated = "prefer the `FromIterator`/`collect` interface"]
    pub fn init<I>(iterable: I) -> Self
    where
        I: IntoIterator<Item = T>,
    {
        Self::from_iter(iterable)
    }
}

impl<T, N, S> iter::FromIterator<T> for Counter<T, N, S>
where
    T: Hash + Eq,
    N: AddAssign + Zero + One,
    S: BuildHasher + Default,
{
    /// Produce a `Counter` from an iterator of items. This is called automatically
    /// by [`Iterator::collect()`].
    ///
    /// [`Iterator::collect()`]:
    /// https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.collect
    ///
    /// ```rust
    /// # use counter::Counter;
    /// # use std::collections::HashMap;
    /// let counter = "abbccc".chars().collect::<Counter<_>>();
    /// let expect = [('a', 1), ('b', 2), ('c', 3)].iter().cloned().collect::<HashMap<_, _>>();
    /// assert_eq!(counter.into_map(), expect);
    /// ```
    ///
    fn from_iter<I: IntoIterator<Item = T>>(iterable: I) -> Self {
        let mut counter = Counter::new();
        counter.update(iterable);
        counter
    }
}

impl<T, N> iter::FromIterator<(T, N)> for Counter<T, N>
where
    T: Hash + Eq,
    N: AddAssign + Zero,
{
    /// Creates a counter from `(item, count)` tuples.
    ///
    /// The counts of duplicate items are summed.
    /// ```rust
    /// # use counter::Counter;
    /// # use std::collections::HashMap;
    /// let counter = [('a', 1), ('b', 2), ('c', 3), ('a', 4)].iter()
    ///     .cloned().collect::<Counter<_>>();
    /// let expect = [('a', 5), ('b', 2), ('c', 3)].iter()
    ///     .cloned().collect::<HashMap<_, _>>();
    /// assert_eq!(counter.into_map(), expect);
    /// ```
    fn from_iter<I: IntoIterator<Item = (T, N)>>(iter: I) -> Self {
        let mut cnt = Counter::new();
        for (item, item_count) in iter {
            let entry = cnt.map.entry(item).or_insert_with(N::zero);
            *entry += item_count;
        }
        cnt
    }
}