Adding Rules named contructors

Author: nyamsprod

CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All Notable changes to `PHP Domain Parser` will be documented in this file
 
+## Next - TBD
+
+### Added
+
+- `Pdp\Rules::createFromPath` named constructor to returns a new instance from a path
+- `Pdp\Rules::createFromString` named constructor to returns a new instance from a string
+
+### Fixed
+
+- None
+
+### Deprecated
+
+- None
+
+### Removed
+
+- None
+
 ## 5.0.0 - 2017-12-13
 
 ### Added

src/Rules.php

@@ -30,6 +30,37 @@ final class Rules
      */
     private $rules;
 
+    /**
+     * Returns a new instance from a file path.
+     *
+     * @param string $path
+     *
+     * @return self
+     */
+    public static function createFromPath(string $path): self
+    {
+        if (!($resource = @fopen($path, 'r'))) {
+            throw new Exception(sprintf('`%s`: failed to open stream: No such file or directory', $path));
+        }
+
+        $content = stream_get_contents($resource);
+        fclose($resource);
+
+        return self::createFromString($content);
+    }
+
+    /**
+     * Returns a new instance from a string.
+     *
+     * @param string $content
+     *
+     * @return self
+     */
+    public static function createFromString(string $content): self
+    {
+        return new self((new Converter())->convert($content));
+    }
+
     /**
      * new instance.
      *
@@ -51,7 +82,7 @@ public function __construct(array $rules)
     public function resolve(string $domain = null, string $section = self::ALL_DOMAINS): Domain
     {
         if (!in_array($section, [self::PRIVATE_DOMAINS, self::ICANN_DOMAINS, self::ALL_DOMAINS], true)) {
-            throw new Exception(sprintf('%s is an unknown Domain section', $section));
+            throw new Exception(sprintf('%s is an unknown Public Suffix List section', $section));
         }
 
         if (!$this->isMatchable($domain)) {

tests/RulesTest.php

@@ -25,6 +25,18 @@ public function setUp()
         $this->rules = $manager->getRules();
     }
 
+    public function testCreateFromPath()
+    {
+        $rules = Rules::createFromPath(__DIR__.'/data/public_suffix_list.dat');
+        $this->assertInstanceOf(Rules::class, $rules);
+    }
+
+    public function testCreateFromPathThrowsException()
+    {
+        $this->expectException(Exception::class);
+        Rules::createFromPath('/foo/bar.dat');
+    }
+
     public function testNullWillReturnNullDomain()
     {
         $domain = $this->rules->resolve('COM');