Merge pull request #14 from modulusphp/feature/extendable-feature

Feature/extendable feature

Author: donaldp

Exceptions/CannotAddMethodException.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Modulus\Support\Exceptions;
+
+use Exception;
+
+class CannotAddMethodException extends Exception
+{
+  /**
+   * $message
+   *
+   * @var string
+   */
+  protected $message = 'Function has already been added';
+
+  /**
+   * __construct
+   *
+   * @return void
+   */
+  public function __construct()
+  {
+    $args = debug_backtrace()[2];
+
+    foreach ($args as $key => $value) {
+      $this->{$key} = $value;
+    }
+  }
+}

Exceptions/CannotCallMethodException.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Modulus\Support\Exceptions;
+
+use Exception;
+
+class CannotCallMethodException extends Exception
+{
+  /**
+   * __construct
+   *
+   * @param string $message
+   * @return void
+   */
+  public function __construct(string $message)
+  {
+    $args = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT, 3)[1];
+
+    foreach ($args as $key => $value) {
+      $this->{$key} = $value;
+    }
+
+    $this->message = $message;
+  }
+}

Extendable.php

@@ -0,0 +1,104 @@
+<?php
+
+namespace Modulus\Support;
+
+use Closure;
+use Modulus\Support\Exceptions\CannotAddMethodException;
+use Modulus\Support\Exceptions\CannotCallMethodException;
+
+trait Extendable
+{
+  /**
+   * A list of custom functions
+   *
+   * @var array $functions
+   */
+  public static $functions = [];
+
+  /**
+   * A list of custom static functions
+   *
+   * @var array $staticFunctions
+   */
+  public static $staticFunctions = [];
+
+  /**
+   * Add custom function
+   *
+   * @param string $method
+   * @param Closure $closure
+   * @return mixed
+   */
+  public static function bind(string $method, Closure $closure)
+  {
+    $trace = debug_backtrace()[1];
+
+    if (
+      $trace['class'] == 'Modulus\Framework\Upstart\Prototype' &&
+      $trace['function'] == 'bind' &&
+      count($trace['args']) == 3
+    ) {
+      if (!array_key_exists($method, Self::$functions)) {
+        return Self::$functions[$method] = [$method => $closure];
+      }
+
+      throw new CannotAddMethodException;
+    }
+
+    throw new CannotCallMethodException('Call to ' . self::class . '::bind() is not allowed');
+  }
+
+  /**
+   * Add custom static function
+   *
+   * @param string $method
+   * @param Closure $closure
+   * @return mixed
+   */
+  public static function static(string $method, Closure $closure)
+  {
+    $trace = debug_backtrace()[1];
+
+    if (
+      $trace['class'] == 'Modulus\Framework\Upstart\Prototype' &&
+      $trace['function'] == 'static' &&
+      count($trace['args']) == 3
+    ) {
+      if (!array_key_exists($method, Self::$staticFunctions)) {
+        return Self::$staticFunctions[$method] = [$method => $closure];
+      }
+
+      throw new CannotAddMethodException;
+    }
+
+    throw new CannotCallMethodException('Call to ' . self::class . '::static() is not allowed');
+  }
+
+  /**
+   * Call custom function
+   *
+   * @param string $method
+   * @param array $args
+   * @return mixed
+   */
+  public function __call(string $method, array $args)
+  {
+    if (array_key_exists($method, Self::$functions)) {
+      return call_user_func_array(Self::$functions[$method][$method], array_merge([$this], $args));
+    }
+  }
+
+  /**
+   * Call custom static function
+   *
+   * @param string $method
+   * @param array $args
+   * @return mixed
+   */
+  public static function __callStatic(string $method, array $args)
+  {
+    if (array_key_exists($method, Self::$staticFunctions)) {
+      return call_user_func_array(Self::$staticFunctions[$method][$method], $args);
+    }
+  }
+}

File.php

@@ -4,11 +4,14 @@
 
 use Exception;
 use Modulus\Support\Config;
+use Modulus\Support\Extendable;
 use Modulus\Support\Exceptions\UnknownStorageException;
 use Modulus\Support\Exceptions\StorageUnusableException;
 
 class File
 {
+  use Extendable;
+
   /**
    * $info
    *

Filesystem.php

@@ -2,8 +2,12 @@
 
 namespace Modulus\Support;
 
+use Modulus\Support\Extendable;
+
 class Filesystem
 {
+  use Extendable;
+
   /**
    * Filesystem::PUBLIC
    */

composer.json

@@ -1,7 +1,7 @@
 {
   "name": "modulusphp/support",
   "description": "Support component for Modulus",
-  "version": "1.9.2.4",
+  "version": "1.9.3.0",
   "license": "MIT",
   "type": "package",
   "authors": [{