Add named unique() "bags"

src/Faker/Provider/Base.php

@@ -15,9 +15,9 @@ class Base
     protected $generator;
 
     /**
-     * @var \Faker\UniqueGenerator
+     * @var \Faker\UniqueGenerator[]
      */
-    protected $unique;
+    protected $unique = array();
 
     /**
      * @param \Faker\Generator $generator
@@ -566,20 +566,25 @@ public function optional($weight = 0.5, $default = null)
      * $faker->unique()->randomElement(array(1, 2, 3));
      * </code>
      *
+     * @param string  $bag        Defines separate lists of existsing values
      * @param boolean $reset      If set to true, resets the list of existing values
      * @param integer $maxRetries Maximum number of retries to find a unique value,
      *                                       After which an OverflowException is thrown.
      * @throws \OverflowException When no unique value can be found by iterating $maxRetries times
      *
      * @return UniqueGenerator A proxy class returning only non-existing values
      */
-    public function unique($reset = false, $maxRetries = 10000)
+    public function unique($bag = null, $reset = false, $maxRetries = 10000)
     {
+        if (!is_string($bag)) {
+            return $this->unique('default', $bag, is_int($reset) ? $reset : 10000);
+        }
+
         if ($reset || !$this->unique) {
-            $this->unique = new UniqueGenerator($this->generator, $maxRetries);
+            $this->unique[$bag] = new UniqueGenerator($this->generator, $maxRetries);
         }
 
-        return $this->unique;
+        return $this->unique[$bag];
     }
 
     /**