Extract types

Author: Sevavietl

.gitignore

@@ -1,2 +1,4 @@
-/vendor/
-composer.lock
+.idea
+vendor
+composer.lock
+build

.travis.yml

@@ -0,0 +1,18 @@
+language: php
+sudo: false
+php:
+- 7.1
+- 7.2
+
+before_install:
+- composer self-update
+
+install:
+- travis_retry composer install --no-interaction --prefer-source
+
+script:
+- vendor/bin/phpstan analyze src/ tests/ --level max
+- vendor/bin/phpunit --coverage-clover build/logs/clover.xml
+
+after_success:
+- travis_retry php vendor/bin/php-coveralls -v

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 Vsevolod Vietluzhskykh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,5 +1,10 @@
 # Overloaded Function
 
+[![Build Status](https://travis-ci.com/Sevavietl/OverloadedFunction.svg?branch=master)](https://travis-ci.com/Sevavietl/OverloadedFunction)
+[![Coverage Status](https://coveralls.io/repos/github/Sevavietl/OverloadedFunction/badge.svg)](https://coveralls.io/github/Sevavietl/OverloadedFunction)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PHPStan](https://img.shields.io/badge/PHPStan-enabled-brightgreen.svg?style=flat)](https://github.com/phpstan/phpstan)
+
 PHP actually does not support [function overloading](https://en.wikipedia.org/wiki/Function_overloading), as functions distinguished but name only.
 This is a class that helps to imulate function overloading in PHP.
 

composer.json

@@ -15,9 +15,14 @@
             "email": "sevavietl@gmail.com"
         }
     ],
-    "require": {},
+    "require": {
+        "php": ">=7.1",
+        "sevavietl/type-guard": "^0.1.1"
+    },
     "require-dev": {
-        "phpunit/phpunit": "^6.3"
+        "phpunit/phpunit": "^6.3",
+        "phpstan/phpstan": "^0.10.3",
+        "php-coveralls/php-coveralls": "^2.1"
     },
     "autoload": {
         "psr-4": {

phpunit.xml renamed to phpunit.xml.dist

@@ -9,6 +9,11 @@
          processIsolation="false"
          stopOnFailure="false"
          syntaxCheck="false">
+    <filter>
+        <whitelist processUncoveredFilesFromWhitelist="true">
+            <directory suffix=".php">./src</directory>
+        </whitelist>
+    </filter>
     <testsuites>
         <testsuite name="unit">
             <directory suffix="Test.php">tests/unit/</directory>

src/FunctionHasNoCasesException.php

@@ -2,7 +2,7 @@
 
 namespace Sevavietl\OverloadedFunction;
 
-class FunctionHasNoCasesException extends \DomainException
+final class FunctionHasNoCasesException extends \DomainException
 {
 
 }

src/OverloadedFunction.php

@@ -2,10 +2,11 @@
 
 namespace Sevavietl\OverloadedFunction;
 
-use Sevavietl\OverloadedFunction\Signature\Signature;
+use TypeGuard\Guard;
 
-class OverloadedFunction
+final class OverloadedFunction
 {
+    /** @var callable */
     private $func;
 
     public function __construct(array $cases)
@@ -17,7 +18,7 @@ public function __construct(array $cases)
         $this->prepareFunction($this->prepareCases($cases));
     }
 
-    private function prepareCases($cases)
+    private function prepareCases(array $cases): \SplObjectStorage
     {
         $_cases = new \SplObjectStorage;
 
@@ -28,19 +29,24 @@ private function prepareCases($cases)
         return $_cases;
     }
 
-    private function prepareFunction(\SplObjectStorage $cases)
+    private function prepareFunction(\SplObjectStorage $cases): void
     {
         $this->func = function (...$args) use ($cases) {
+            /** @var Guard $signature */
             foreach ($cases as $signature) {
                 if ($signature->match($args)) {
                     return $cases[$signature](...$args);
                 }
             }
 
-            throw new UnknownSignatureException("There is no function case for provided parameters.");
+            throw new UnknownSignatureException('There is no function case for provided parameters.');
         };   
     }
 
+    /**
+     * @param mixed ...$argv
+     * @return mixed
+     */
     public function __invoke(...$argv)
     {
         return ($this->func)(...$argv);

src/Signature.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Sevavietl\OverloadedFunction;
+
+use TypeGuard\Guard;
+
+final class Signature
+{
+    /** @var Guard[] */
+    private $guards;
+
+    public function __construct(string $stringRepresentation)
+    {
+        $this->parseStringRepresentation($stringRepresentation);
+    }
+
+    private function parseStringRepresentation(string $stringRepresentation): void
+    {
+        $paramTypes = array_filter(array_map('trim', explode(',', $stringRepresentation)));
+
+        $this->guards = array_map(function (string $paramType): Guard {
+            return new Guard($paramType);
+        }, $paramTypes);
+    }
+
+    public function match(array $params)
+    {
+        return array_reduce(
+            array_map(function (?Guard $guard, $param): bool {
+                if (null === $guard) {
+                    return false;
+                }
+
+                return $guard->match($param);
+            }, $this->guards, $params),
+            function ($carry, $result) {
+                return $carry && $result;
+            },
+            true
+        );
+    }
+}