Added PHPMatcher facade in order to simplify developers experience

Author: norberttech

README.md

@@ -19,6 +19,21 @@ composer require --dev "coduo/php-matcher"
 
 ## Basic usage
 
+### Using facade
+
+```php
+<?php
+
+use Coduo\PHPMatcher\PHPMatcher;
+
+if (!PHPMatcher::match("lorem ipsum dolor", "@string@")) {
+    echo PHPMatcher::getError(); // reason why value does not match pattern.
+}
+```
+
+
+### Using Factory
+
 ```php
 <?php
 

src/Coduo/PHPMatcher/PHPMatcher.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace Coduo\PHPMatcher;
+
+use Coduo\PHPMatcher\Factory\SimpleFactory;
+
+final class PHPMatcher
+{
+    /**
+     * @var Matcher|null
+     */
+    private static $matcher;
+
+    /**
+     * @param $value
+     * @param $pattern
+     * @return bool
+     */
+    public static function match($value, $pattern)
+    {
+        $matcher = self::createMatcher();
+     
+        return $matcher->match($value, $pattern);
+    }
+
+    /**
+     * @return null|string
+     */
+    public static function getError()
+    {
+        $matcher = self::createMatcher();
+        
+        return $matcher->getError();
+    }
+    
+    private static function createMatcher()
+    {
+        if (self::$matcher instanceof Matcher) {
+            return self::$matcher;
+        }
+        
+        $factory = new SimpleFactory();
+        self::$matcher = $factory->createMatcher();
+        
+        return self::$matcher;
+    }
+}

tests/Coduo/PHPMatcher/MatcherTest.php

@@ -5,6 +5,7 @@
 use Coduo\PHPMatcher\Lexer;
 use Coduo\PHPMatcher\Matcher;
 use Coduo\PHPMatcher\Parser;
+use Coduo\PHPMatcher\PHPMatcher;
 
 class MatcherTest extends \PHPUnit_Framework_TestCase
 {
@@ -13,8 +14,9 @@ class MatcherTest extends \PHPUnit_Framework_TestCase
      */
     protected $matcher;
 
-    protected $arrayValue;
-
+    /**
+     * @var Matcher\CaptureMatcher
+     */
     protected $captureMatcher;
 
     public function setUp()
@@ -67,7 +69,7 @@ public function test_matcher_with_array_value()
             'data' => new \stdClass(),
         );
 
-        $expecation = array(
+        $expectation = array(
             'users' => array(
                 array(
                     'id' => '@integer@',
@@ -86,25 +88,17 @@ public function test_matcher_with_array_value()
             'data' => '@wildcard@',
         );
 
-        $this->assertTrue($this->matcher->match($value, $expecation), $this->matcher->getError());
+        $this->assertTrue($this->matcher->match($value, $expectation), $this->matcher->getError());
+        $this->assertTrue(PHPMatcher::match($value, $expectation), PHPMatcher::getError());
     }
 
     /**
-     * @dataProvider scalarValues
+     * @dataProvider scalarValueExamples
      */
     public function test_matcher_with_scalar_values($value, $pattern)
     {
         $this->assertTrue($this->matcher->match($value, $pattern));
-    }
-
-    public function scalarValues()
-    {
-        return array(
-            array('Norbert Orzechowicz', '@string@'),
-            array(6.66, '@double@'),
-            array(1, '@integer@'),
-            array(array('foo'), '@array@')
-        );
+        $this->assertTrue(PHPMatcher::match($value, $pattern));
     }
 
     public function test_matcher_with_json()
@@ -153,6 +147,7 @@ public function test_matcher_with_json()
         }';
 
         $this->assertTrue($this->matcher->match($json, $jsonPattern));
+        $this->assertTrue(PHPMatcher::match($json, $jsonPattern));
     }
 
     public function test_matcher_with_xml()
@@ -189,13 +184,15 @@ public function test_matcher_with_xml()
 XML;
 
         $this->assertTrue($this->matcher->match($xml, $xmlPattern));
+        $this->assertTrue(PHPMatcher::match($xml, $xmlPattern));
     }
 
     public function test_text_matcher()
     {
         $value = "lorem ipsum 1234 random text";
         $pattern = "@[email protected]('lo') ipsum @[email protected](10) random text";
         $this->assertTrue($this->matcher->match($value, $pattern));
+        $this->assertTrue(PHPMatcher::match($value, $pattern));
     }
 
 
@@ -206,6 +203,9 @@ public function test_error_when_json_value_does_not_match_json_pattern()
 
         $this->assertFalse($this->matcher->match($value, $pattern));
         $this->assertSame('"5" does not match "4".', $this->matcher->getError());
+
+        $this->assertFalse(PHPMatcher::match($value, $pattern));
+        $this->assertSame('"5" does not match "4".', PHPMatcher::getError());
     }
 
     public function test_matcher_with_captures()
@@ -220,13 +220,17 @@ public function test_matcher_with_captures()
     public function test_matcher_with_callback()
     {
         $this->assertTrue($this->matcher->match('test', function($value) { return $value === 'test';}));
+        $this->assertTrue(PHPMatcher::match('test', function($value) { return $value === 'test';}));
         $this->assertFalse($this->matcher->match('test', function($value) { return $value !== 'test';}));
+        $this->assertFalse(PHPMatcher::match('test', function($value) { return $value !== 'test';}));
     }
 
     public function test_matcher_with_wildcard()
     {
         $this->assertTrue($this->matcher->match('test', '@*@'));
+        $this->assertTrue(PHPMatcher::match('test', '@*@'));
         $this->assertTrue($this->matcher->match('test', '@wildcard@'));
+        $this->assertTrue(PHPMatcher::match('test', '@wildcard@'));
     }
 
     /**
@@ -235,8 +239,19 @@ public function test_matcher_with_wildcard()
     public function test_expanders($value, $pattern, $expectedResult)
     {
         $this->assertSame($expectedResult, $this->matcher->match($value, $pattern));
+        $this->assertSame($expectedResult, PHPMatcher::match($value, $pattern));
     }
 
+    public function scalarValueExamples()
+    {
+        return array(
+            array('Norbert Orzechowicz', '@string@'),
+            array(6.66, '@double@'),
+            array(1, '@integer@'),
+            array(array('foo'), '@array@')
+        );
+    }
+    
     public static function expanderExamples()
     {
         return array(