#263 Improve Rules public API

Author: nyamsprod

src/Rules.php

@@ -17,6 +17,7 @@
 
 use Pdp\Exception\CouldNotLoadRules;
 use Pdp\Exception\CouldNotResolvePublicSuffix;
+use Pdp\Exception\InvalidDomain;
 use function array_reverse;
 use function count;
 use function fclose;
@@ -104,7 +105,7 @@ public static function createFromPath(
 
         $resource = @fopen(...$args);
         if (false === $resource) {
-            throw new CouldNotLoadRules(sprintf('`%s`: failed to open stream: No such file or directory', $path));
+            throw new CouldNotLoadRules(sprintf('`%s`: failed to open stream: No such file or directory.', $path));
         }
 
         /** @var string $content */
@@ -193,7 +194,7 @@ public function getPublicSuffix($domain, string $section = self::ALL_DOMAINS): P
         }
 
         if (!$domain->isResolvable()) {
-            throw new CouldNotResolvePublicSuffix(sprintf('The domain `%s` can not contain a public suffix', $domain->getContent()));
+            throw new CouldNotResolvePublicSuffix(sprintf('The domain `%s` can not contain a public suffix.', $domain->getContent()));
         }
 
         return PublicSuffix::createFromDomain($domain->resolve($this->findPublicSuffix($domain, $section)));
@@ -262,9 +263,12 @@ public function privateResolve($domain): Domain
     }
 
     /**
-     * Returns PSL info for a given domain.
+     * Assert the domain is valid and is resolvable.
      *
      * @param mixed $domain
+     *
+     * @throws InvalidDomain               if the domain is invalid
+     * @throws CouldNotResolvePublicSuffix if the domain is not resolvable
      */
     private function validateDomain($domain): Domain
     {
@@ -273,7 +277,7 @@ private function validateDomain($domain): Domain
         }
 
         if (!$domain->isResolvable()) {
-            throw new CouldNotResolvePublicSuffix(sprintf('The domain `%s` can not contain a public suffix', $domain->getContent()));
+            throw new CouldNotResolvePublicSuffix(sprintf('The domain `%s` can not contain a public suffix.', $domain->getContent()));
         }
 
         return $domain;
@@ -298,7 +302,7 @@ private function validateSection(string $section): string
             return $section;
         }
 
-        throw new CouldNotResolvePublicSuffix(sprintf('%s is an unknown Public Suffix List section', $section));
+        throw new CouldNotResolvePublicSuffix(sprintf('%s is an unknown Public Suffix List section.', $section));
     }
 
     /**