Merge #418 #429

418: Add a stability specification to the docs for unique and unique_by r=jswrenn a=mulkieran



429: add caching to travis r=jswrenn a=meltinglava

This is so that the pipeline does not download and compile all the dependencies all the time. Its recompiles them when a new compiler is used.

Co-authored-by: mulhern <[email protected]>
Co-authored-by: Meltinglava <[email protected]>

Author: 3 people

.travis.yml

@@ -6,6 +6,7 @@ matrix:
     - rust: stable
     - rust: beta
     - rust: nightly
+cache: cargo # https://docs.travis-ci.com/user/languages/rust/#dependency-management
 branches:
   only:
     - master

src/lib.rs

@@ -1021,6 +1021,10 @@ pub trait Itertools : Iterator {
     /// Clones of visited elements are stored in a hash set in the
     /// iterator.
     ///
+    /// The iterator is stable, returning the non-duplicate items in the order
+    /// in which they occur in the adapted iterator. In a set of duplicate
+    /// items, the first item encountered is the item retained.
+    ///
     /// ```
     /// use itertools::Itertools;
     ///
@@ -1043,6 +1047,10 @@ pub trait Itertools : Iterator {
     /// with the keying function `f` by hash and equality.
     /// The keys are stored in a hash set in the iterator.
     ///
+    /// The iterator is stable, returning the non-duplicate items in the order
+    /// in which they occur in the adapted iterator. In a set of duplicate
+    /// items, the first item encountered is the item retained.
+    ///
     /// ```
     /// use itertools::Itertools;
     ///