Adding pull support

Author: jenssegers

README.md

@@ -252,6 +252,13 @@ Add one or more items to an array.
     User::where('name', 'John')->push('items', 'boots');
     User::where('name', 'John')->push('items', array('sword', 'shield'));
 
+***Pull***
+
+Remove one or more values from an array.
+
+    User::where('name', 'John')->pull('items', 'boots');
+    User::where('name', 'John')->pull('items', array('sword', 'shield'));
+
 ### Query Caching
 
 You may easily cache the results of a query using the remember method:

src/Jenssegers/Mongodb/Builder.php

@@ -412,9 +412,9 @@ public function raw($expression = null)
     }
 
     /**
-     * Append a value to an array.
+     * Append one or more values to an array.
      *
-     * @param  string  $column
+     * @param  mixed   $column
      * @param  mixed   $value
      * @return int
      */
@@ -426,6 +426,7 @@ public function push($column, $value = null)
         }
         else if (is_array($value))
         {
+            // $pushAll depricated
             $query = array('$push' => array($column => array('$each' => $value)));
         }
         else
@@ -436,6 +437,31 @@ public function push($column, $value = null)
         return $this->performUpdate($query);
     }
 
+    /**
+     * Remove one or more values from an array.
+     *
+     * @param  mixed   $column
+     * @param  mixed   $value
+     * @return int
+     */
+    public function pull($column, $value = null)
+    {
+        if (is_array($column))
+        {
+            $query = array('$pull' => $column);
+        }
+        else if (is_array($value))
+        {
+            $query = array('$pullAll' => array($column => $value));
+        }
+        else
+        {
+            $query = array('$pull' => array($column => $value));
+        }
+
+        return $this->performUpdate($query);
+    }
+
     /**
      * Get a new instance of the query builder.
      *

tests/QueryTest.php

@@ -128,4 +128,24 @@ public function testPush()
 		$this->assertEquals('tag4', $user['tags'][3]);
 	}
 
+	public function testPull()
+	{
+		$user = array('name' => 'John Doe', 'tags' => array('tag1', 'tag2', 'tag3', 'tag4'));
+		$id = DB::collection('users')->insertGetId($user);
+
+		DB::collection('users')->where('_id', $id)->pull('tags', 'tag3');
+		$user = DB::collection('users')->find($id);
+
+		$this->assertTrue(is_array($user['tags']));
+		$this->assertEquals(3, count($user['tags']));
+		$this->assertEquals('tag4', $user['tags'][2]);
+
+		DB::collection('users')->where('_id', $id)->pull('tags', array('tag2', 'tag4'));
+		$user = DB::collection('users')->find($id);
+
+		$this->assertTrue(is_array($user['tags']));
+		$this->assertEquals(1, count($user['tags']));
+		$this->assertEquals('tag1', $user['tags'][0]);
+	}
+
 }