Add validData method

gump.class.php

@@ -428,6 +428,31 @@ public function errors()
         return $this->errors;
     }
 
+    /**
+     * Perform data validation against the provided ruleset and return the valid data.
+     * 
+     * @param array  $data
+     * @param        $check_fields
+     * 
+     * @return array valid data.
+     */
+    public function validData(array $data, $check_fields = false)
+    {
+        $data = $this->run($data, $check_fields);
+
+        if ($data === false) {
+            return [];
+        }
+
+        $allowed = array_keys($this->validation_rules());
+
+        $validData = array_filter($data, function ($key) use ($allowed) {
+            return in_array($key, $allowed);
+        }, ARRAY_FILTER_USE_KEY);
+
+        return $validData;
+    }
+
     /**
      * Perform data validation against the provided ruleset.
      *

tests/ValidDataTest.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace Tests;
+
+/**
+ * Class ValidateTest
+ *
+ * @package Tests
+ */
+class ValidDataTest extends BaseTestCase
+{
+    public function testOnFailureReturnsEmptyArray()
+    {
+        $this->gump->validation_rules(array(
+            'field0' => 'required',
+        ));
+
+        $result = $this->gump->validData([
+            'field1' => 'somedata'
+        ]);
+
+        $this->assertEquals([], $result);
+    }
+
+    public function testOnSuccessReturnsOnlyValidDataWithFiltersApplied()
+    {
+        $this->gump->validation_rules(array(
+            'field0' => 'required|numeric',
+            'field1' => 'required',
+        ));
+
+        $this->gump->filter_rules(array(
+            'field0' => 'trim'
+        ));
+
+        $result = $this->gump->validData([
+            'field0' => ' 123 ',
+            'field1' => 'somedata',
+            'field2' => 'test'
+        ]);
+
+        $this->assertEquals([
+            'field0' => '123',
+            'field1' => 'somedata'
+        ], $result);
+    }
+}