Merge branch 'main' of https://github.com/php-toolkit/extlib

Author: inhere

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: composer
+    directory: "/"
+    schedule:
+      interval: daily
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      # Check for updates to GitHub Actions every weekday
+      interval: "daily"

.github/workflows/php.yml

@@ -0,0 +1,45 @@
+name: Unit-tests
+
+on: [push]
+
+jobs:
+  test:
+    name: Test on php ${{ matrix.php}} and ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 10
+    strategy:
+      fail-fast: true
+      matrix:
+        php: [7.3, 7.4, 8.0] #
+        os: [ubuntu-latest, macOS-latest] # windows-latest,
+        include:
+          - os: 'ubuntu-latest'
+            php: '7.2'
+            phpunit: '8.5.13'
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      # usage refer https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        timeout-minutes: 5
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php}}
+          tools: pecl, php-cs-fixer, phpunit:${{ matrix.phpunit }}
+          extensions: mbstring, dom, fileinfo, mysql, openssl, igbinary, redis # , swoole-4.4.19 #optional, setup extensions
+          ini-values: post_max_size=56M, short_open_tag=On #optional, setup php.ini configuration
+          coverage: none #optional, setup coverage driver: xdebug, none
+
+      - name: Display Env
+        run: env
+
+      - name: Install dependencies
+        run: composer install --no-progress --no-suggest
+
+      # Add a test script to composer.json, for instance: "test": "vendor/bin/phpunit"
+      # Docs: https://getcomposer.org/doc/articles/scripts.md
+
+      - name: Run test suite
+        run: phpunit

.github/workflows/release.yml

@@ -0,0 +1,62 @@
+name: Tag-release
+
+on:
+  push:
+    tags:
+      - v*
+
+jobs:
+  release:
+    name: Test on php ${{ matrix.php}}
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    strategy:
+      fail-fast: true
+      matrix:
+        php: [7.3]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Set ENV for github-release
+        # https://docs.github.com/en/free-pro-team@latest/actions/reference/workflow-commands-for-github-actions#setting-an-environment-variable
+        run: |
+          echo "RELEASE_TAG=${GITHUB_REF:10}" >> $GITHUB_ENV
+          echo "RELEASE_NAME=$GITHUB_WORKFLOW" >> $GITHUB_ENV
+
+      # usage refer https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        timeout-minutes: 5
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php}}
+          tools: pecl, php-cs-fixer, phpunit
+          extensions: mbstring, dom, fileinfo, mysql, openssl # , swoole-4.4.19 #optional, setup extensions
+          ini-values: post_max_size=56M, short_open_tag=On #optional, setup php.ini configuration
+          coverage: none #optional, setup coverage driver: xdebug, none
+
+      - name: Install dependencies # eg: v1.0.3
+        run: |
+          tag1=${GITHUB_REF#refs/*/}
+          echo "release tag: ${tag1}"
+          composer install --no-progress --no-suggest
+
+      # Add a test script to composer.json, for instance: "test": "vendor/bin/phpunit"
+      # Docs: https://getcomposer.org/doc/articles/scripts.md
+
+      #      - name: Build phar and send to github assets
+      #        run: |
+      #          echo $RELEASE_TAG
+      #          echo $RELEASE_NAME
+      #          php -d phar.readonly=0 bin/kite phar:pack -o kite-${RELEASE_TAG}.phar --no-progress
+      #          php kite-${RELEASE_TAG}.phar -V
+
+      # https://github.com/actions/create-release
+      - uses: meeDamian/github-release@2.0
+        with:
+          gzip: false
+          token: ${{ secrets.GITHUB_TOKEN }}
+          tag: ${{ env.RELEASE_TAG }}
+          name: ${{ env.RELEASE_TAG }}
+#          files: kite-${{ env.RELEASE_TAG }}.phar

README.md

@@ -0,0 +1,21 @@
+# Extlib
+
+[![License](https://img.shields.io/packagist/l/toolkit/extlib.svg?style=flat-square)](LICENSE)
+[![Php Version](https://img.shields.io/badge/php-%3E=7.1.0-brightgreen.svg?maxAge=2592000)](https://packagist.org/packages/toolkit/extlib)
+[![Latest Stable Version](http://img.shields.io/packagist/v/toolkit/extlib.svg)](https://packagist.org/packages/toolkit/extlib)
+[![Actions Status](https://github.com/php-toolkit/extlib/workflows/Unit-tests/badge.svg)](https://github.com/php-toolkit/extlib/actions)
+
+Some useful extends library for php.
+
+## Install
+
+```bash
+composer require toolkit/extlib
+```
+
+## Usage
+
+
+## License
+
+MIT

composer.json

@@ -1,7 +1,7 @@
 {
   "name": "toolkit/extlib",
   "type": "library",
-  "description": "some useful http client library of the php",
+  "description": "Some useful extends library for php",
   "keywords": [
     "library",
     "tool",
@@ -20,6 +20,7 @@
   "require": {
     "php": ">7.1.0",
     "toolkit/cli-utils": "^1.0",
+    "toolkit/fsutil": "^1.0",
     "toolkit/stdlib": "^1.0"
   },
   "autoload": {

src/Contract/IOInterface.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+
+namespace Toolkit\Extlib\Contract;
+
+/**
+ * Interface IOInterface
+ * @package Toolkit\Extlib\Contract
+ */
+interface IOInterface extends InputInterface, OutputInterface
+{
+
+}

src/Contract/InputInterface.php

@@ -0,0 +1,32 @@
+<?php declare(strict_types=1);
+
+namespace Toolkit\Extlib\Contract;
+
+/**
+ * Interface InputInterface
+ * @package Toolkit\Extlib\Contract
+ */
+interface InputInterface
+{
+    /**
+     * @param int $length
+     *
+     * @return string
+     */
+    public function read(int $length): string;
+
+    /**
+     * @return string
+     */
+    public function readln(): string;
+
+    /**
+     * @return string
+     */
+    public function readAll(): string;
+
+    /**
+     * Whether the stream is an interactive terminal
+     */
+    public function isInteractive() : bool;
+}

src/Contract/OutputInterface.php

@@ -0,0 +1,35 @@
+<?php declare(strict_types=1);
+
+
+namespace Toolkit\Extlib\Contract;
+
+/**
+ * Class OutputInterface
+ *
+ * @package Toolkit\Extlib\Contract
+ */
+interface OutputInterface
+{
+    /**
+     * Write a message to output
+     *
+     * @param string $content
+     *
+     * @return int
+     */
+    public function write(string $content): int;
+
+    /**
+     * Write a message to output with newline
+     *
+     * @param string $content
+     *
+     * @return int
+     */
+    public function writeln(string $content): int;
+
+    /**
+     * Whether the stream is an interactive terminal
+     */
+    public function isInteractive() : bool;
+}

src/IO/MemoryIO.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+
+namespace Toolkit\Extlib\IO;
+
+/**
+ * Class MemoryIO
+ * @package Toolkit\Extlib\IO
+ */
+class MemoryIO
+{
+
+}

src/IO/StreamIO.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+
+namespace Toolkit\Extlib\IO;
+
+/**
+ * Class StreamIO
+ * @package Toolkit\Extlib\IO
+ */
+class StreamIO
+{
+
+}