init project

Signed-off-by: inhere <in.798@qq.com>

Author: inhere

.gitignore

@@ -0,0 +1,12 @@
+.idea/
+.phpintel/
+vendor/
+!README.md
+!.gitkeep
+composer.lock
+*.swp
+*.log
+*.zip
+*.pid
+*.patch
+.DS_Store

LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 inhere
+
+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.

composer.json

@@ -0,0 +1,33 @@
+{
+  "name": "toolkit/extlib",
+  "type": "library",
+  "description": "some useful http client library of the php",
+  "keywords": [
+    "library",
+    "tool",
+    "http",
+    "curl"
+  ],
+  "homepage": "https://github.com/php-toolkit/extlib",
+  "license": "MIT",
+  "authors": [
+    {
+      "name": "inhere",
+      "email": "in.798@qq.com",
+      "homepage": "https://github.com/inhere"
+    }
+  ],
+  "require": {
+    "php": ">7.1.0",
+    "toolkit/cli-utils": "^1.0",
+    "toolkit/stdlib": "^1.0"
+  },
+  "autoload": {
+    "psr-4": {
+      "Toolkit\\Extlib\\": "src/"
+    }
+  },
+  "suggest": {
+    "php-comp/http-message": "Very lightweight PSR-7 implements http message component"
+  }
+}

phpunit.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="test/boot.php"
+         colors="false"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         stopOnFailure="false"
+>
+    <testsuites>
+        <testsuite name="php-comp http-client Test Suite">
+            <directory>test</directory>
+        </testsuite>
+    </testsuites>
+
+    <filter>
+        <whitelist>
+            <directory suffix=".php">src</directory>
+        </whitelist>
+    </filter>
+</phpunit>

src/Concern/NameAliasTrait.php

@@ -0,0 +1,86 @@
+<?php declare(strict_types=1);
+/**
+ * Created by PhpStorm.
+ * User: inhere
+ * Date: 2017-02-28
+ * Time: 9:20
+ */
+
+namespace Toolkit\Extlib\Concern;
+
+use InvalidArgumentException;
+
+/**
+ * Class NameAliasTrait
+ *
+ * @package Inhere\Console\Concern
+ */
+trait NameAliasTrait
+{
+    /**
+     * @var array
+     */
+    private $aliases = [];
+
+    /**
+     * set name alias(es)
+     *
+     * @param string       $name
+     * @param string|array $alias
+     * @param bool         $validate
+     */
+    public function setAlias(string $name, $alias, bool $validate = false): void
+    {
+        foreach ((array)$alias as $aliasName) {
+            if (!isset($this->aliases[$aliasName])) {
+                $this->aliases[$aliasName] = $name;
+            } elseif ($validate) {
+                $oldName = $this->aliases[$aliasName];
+                throw new InvalidArgumentException("Alias '{$aliasName}' has been registered by '{$oldName}', cannot assign to the '{$name}'");
+            }
+        }
+    }
+
+    /**
+     * Get real name by alias
+     *
+     * @param string $alias
+     *
+     * @return mixed
+     */
+    public function resolveAlias(string $alias): string
+    {
+        return $this->aliases[$alias] ?? $alias;
+    }
+
+    /**
+     * @param string $alias
+     *
+     * @return bool
+     */
+    public function hasAlias(string $alias): bool
+    {
+        return isset($this->aliases[$alias]);
+    }
+
+    /**
+     * @param string $name
+     *
+     * @return array
+     */
+    public function getAliases(string $name = ''): array
+    {
+        if ($name) {
+            $aliases = [];
+            foreach ($this->aliases as $alias => $n) {
+               if ($name === $n) {
+                   $aliases[] = $alias;
+               }
+            }
+
+            return $aliases;
+        }
+
+        return $this->aliases;
+    }
+}

src/Concern/SimpleEventAwareTrait.php

@@ -0,0 +1,204 @@
+<?php declare(strict_types=1);
+/**
+ * Created by PhpStorm.
+ * User: inhere
+ * Date: 2017-03-27
+ * Time: 16:17
+ */
+
+namespace Toolkit\Extlib\Concern;
+
+use function count;
+use function in_array;
+
+/**
+ * Class SimpleEventStaticTrait
+ *
+ * @package Inhere\Console\Concern
+ */
+trait SimpleEventAwareTrait
+{
+    /**
+     * set the supported events, if you need.
+     *  if it is empty, will allow register any event.
+     *
+     * @var array
+     */
+    protected static $supportedEvents = [];
+
+    /**
+     * registered Events
+     *
+     * @var array
+     * [
+     *  'event' => bool, // is once event
+     * ]
+     */
+    private static $events = [];
+
+    /**
+     * events and handlers
+     *
+     * @var array
+     * [
+     *  'event' => callable, // event handler
+     * ]
+     */
+    private static $eventHandlers = [];
+
+    /**
+     * register a event handler
+     *
+     * @param string   $event
+     * @param callable $handler
+     * @param bool     $once
+     */
+    public function on(string $event, callable $handler, bool $once = false): void
+    {
+        if (self::isSupportedEvent($event)) {
+            self::$eventHandlers[$event][] = $handler;
+
+            if (!isset(self::$events[$event])) {
+                self::$events[$event] = $once;
+            }
+        }
+    }
+
+    /**
+     * register a once event handler
+     *
+     * @param string   $event
+     * @param callable $handler
+     */
+    public function once(string $event, callable $handler): void
+    {
+        $this->on($event, $handler, true);
+    }
+
+    /**
+     * trigger event
+     *
+     * @param string $event
+     * @param mixed  ...$args
+     *
+     * @return bool
+     */
+    public function fire(string $event, ...$args): bool
+    {
+        if (!isset(self::$events[$event])) {
+            return false;
+        }
+
+        // call event handlers of the event.
+        /** @var mixed $return */
+        $return = true;
+        foreach ((array)self::$eventHandlers[$event] as $cb) {
+            $return = $cb(...$args);
+            // return FALSE to stop go on handle.
+            if (false === $return) {
+                break;
+            }
+        }
+
+        // is a once event, remove it
+        if (self::$events[$event]) {
+            return $this->off($event);
+        }
+
+        return (bool)$return;
+    }
+
+    /**
+     * remove event and it's handlers
+     *
+     * @param $event
+     *
+     * @return bool
+     */
+    public function off(string $event): bool
+    {
+        if ($this->hasEvent($event)) {
+            unset(self::$events[$event], self::$eventHandlers[$event]);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * @param string $event
+     *
+     * @return bool
+     */
+    public function hasEvent(string $event): bool
+    {
+        return isset(self::$events[$event]);
+    }
+
+    /**
+     * @param string $event
+     *
+     * @return bool
+     */
+    public function isOnce(string $event): bool
+    {
+        if ($this->hasEvent($event)) {
+            return self::$events[$event];
+        }
+
+        return false;
+    }
+
+    /**
+     * check $name is a supported event name
+     *
+     * @param string $event
+     *
+     * @return bool
+     */
+    public static function isSupportedEvent(string $event): bool
+    {
+        if (!$event || !preg_match('/[a-zA-z][\w-]+/', $event)) {
+            return false;
+        }
+
+        if ($ets = self::$supportedEvents) {
+            return in_array($event, $ets, true);
+        }
+
+        return true;
+    }
+
+    /**
+     * @return array
+     */
+    public static function getSupportEvents(): array
+    {
+        return self::$supportedEvents;
+    }
+
+    /**
+     * @param array $supportedEvents
+     */
+    public static function setSupportEvents(array $supportedEvents): void
+    {
+        self::$supportedEvents = $supportedEvents;
+    }
+
+    /**
+     * @return array
+     */
+    public static function getEvents(): array
+    {
+        return self::$events;
+    }
+
+    /**
+     * @return int
+     */
+    public static function countEvents(): int
+    {
+        return count(self::$events);
+    }
+}