Add "in" and "orIn" filters to XPath builder

Author: robgridley

src/XPath/Builder.php

@@ -165,6 +165,35 @@ public function get()
         return $this->find();
     }
 
+    /**
+     * Add an "in" filter.
+     *
+     * @param string $xpath
+     * @param array $values
+     * @param string $boolean
+     * @return self
+     */
+    public function in($xpath, array $values, $boolean = 'and')
+    {
+        return $this->filter(function ($builder) use ($xpath, $values) {
+            foreach ($values as $value) {
+                $builder->filter($xpath, '=', $value, 'or');
+            }
+        }, null, null, $boolean);
+    }
+
+    /**
+     * Add an "or in" filter.
+     *
+     * @param string $xpath
+     * @param array $values
+     * @return self
+     */
+    public function orIn($xpath, array $values)
+    {
+        return $this->in($xpath, $values, 'or');
+    }
+
     /**
      * Add a nested filter using a callback.
      *

tests/XPath/BuilderTest.php

@@ -75,6 +75,20 @@ public function testOrContains()
         $this->assertEquals((new Builder)->filter('@id', 99)->orContains('@name', 'Smith')->toXPath(), '@id = 99 or contains(@name, "Smith")');
     }
 
+    public function testInFilter()
+    {
+        $builder = new Builder;
+        $builder->in('@id', [1, 2, 5, 10]);
+        $this->assertEquals($builder->toXPath(), '(@id = 1 or @id = 2 or @id = 5 or @id = 10)');
+    }
+
+    public function testOrInFilter()
+    {
+        $builder = new Builder;
+        $builder->filter('@id', '<', 5)->in('@id', [1, 2, 5, 10]);
+        $this->assertEquals($builder->toXPath(), '@id < 5 and (@id = 1 or @id = 2 or @id = 5 or @id = 10)');
+    }
+
     public function testSorting()
     {
         $builder = new Builder;