up: modify some class, update readme

Author: inhere

README.md

@@ -1,11 +1,11 @@
 # StdLib
 
 [![License](https://img.shields.io/github/license/php-toolkit/stdlib)](LICENSE)
-[![Php Version](https://img.shields.io/badge/php-%3E7.1.0-brightgreen.svg?maxAge=2592000)](https://packagist.org/packages/toolkit/stdlib)
+[![Php Version](https://img.shields.io/badge/php-%3E8.0-brightgreen.svg?maxAge=2592000)](https://packagist.org/packages/toolkit/stdlib)
 [![Latest Stable Version](http://img.shields.io/packagist/v/toolkit/stdlib.svg)](https://packagist.org/packages/toolkit/stdlib)
 [![Github Actions Status](https://github.com/php-toolkit/stdlib/workflows/Unit-Tests/badge.svg)](https://github.com/php-toolkit/stdlib/actions)
 
-Stdlib - useful basic tools for php develop.
+🧰 Stdlib - Useful basic tools library for PHP development.
 
 **Contains**:
 
@@ -26,9 +26,25 @@ Stdlib - useful basic tools for php develop.
 composer require toolkit/stdlib
 ```
 
-## Usage
+## String helper
 
-### String helper
+### StrBuffer
+
+```php
+use Toolkit\Stdlib\Str\StrBuffer;
+
+$buf = StrBuffer::new("c");
+$buf->prepend('ab')
+$buf->append('de')
+
+$str = (string)$buf; // "abcde"
+$str = $buf->toString(); // "abcde"
+// get and clean.
+$str = $buf->fetch(); // "abcde"
+$str = $buf->join(','); // "ab,c,de"
+```
+
+## Object helper
 
 ### Object box
 
@@ -69,8 +85,28 @@ $renderer = $box->get('renderer');
 
 ### Optional
 
+Not use Optional:
+
+```php
+use Toolkit\Stdlib\Util\Optional;
+
+$userModel = UserModel::findOne(23);
+
+if ($userModel) {
+    $username = $userModel->name;
+} else {
+    $username = 'unknown';
+}
+```
+
+Use Optional:
+
 ```php
+use Toolkit\Stdlib\Util\Optional;
 
+$username = Optional::ofNullable($userModel)->map(function ($userModel) {
+    return $userModel->name;
+})->orElse('unknown');
 ```
 
 ### DataStream

src/Util/BasePhpTestCase.php renamed to src/Helper/BasePhpTestCase.php

@@ -1,6 +1,6 @@
 <?php declare(strict_types=1);
 
-namespace Toolkit\Stdlib\Util;
+namespace Toolkit\Stdlib\Helper;
 
 use PHPUnit\Framework\TestCase;
 use ReflectionException;

src/Helper/Format.php

@@ -84,15 +84,15 @@ public static function beforeTime(int $secs): string
      *
      * @return string
      */
-    public static function microTime($mTime = null): string
+    public static function microTime(string|float $mTime = null): string
     {
         if (!$mTime) {
             $mTime = microtime(true);
         }
 
         [$ts, $ms] = explode('.', sprintf('%.4f', $mTime));
 
-        return date('Y/m/d H:i:s', $ts) . '.' . $ms;
+        return date('Y/m/d H:i:s', (int)$ts) . '.' . $ms;
     }
 
     /**
@@ -106,7 +106,7 @@ public static function microTime($mTime = null): string
      *
      * @return string
      */
-    public static function memory($memory): string
+    public static function memory(int|float $memory): string
     {
         if ($memory >= 1024 * 1024 * 1024) {
             return sprintf('%.1f GiB', $memory / 1024 / 1024 / 1024);
@@ -134,7 +134,7 @@ public static function memory($memory): string
      *
      * @return string
      */
-    public static function size($size): string
+    public static function size(int|float $size): string
     {
         if ($size >= 1024 * 1024 * 1024) {
             return sprintf('%.1f Gb', $size / 1024 / 1024 / 1024);
@@ -160,7 +160,7 @@ public static function size($size): string
      *
      * @return string
      */
-    public static function bytes($size, int $precision = 2): string
+    public static function bytes(int|float $size, int $precision = 2): string
     {
         if ($size < 1) {
             return '0b';
@@ -180,7 +180,7 @@ public static function bytes($size, int $precision = 2): string
      *
      * @return int
      */
-    public static function convertBytes($value): int
+    public static function convertBytes(int|float|string $value): int
     {
         if (is_numeric($value)) {
             return $value;

src/Std.php

@@ -16,7 +16,7 @@ class Std
      *
      * @return string
      */
-    public static function toString($data): string
+    public static function toString(mixed $data): string
     {
         return  DataHelper::toString($data);
     }

src/Std/StrStream.php

@@ -9,6 +9,7 @@
 
 namespace Toolkit\Stdlib\Str;
 
+use Stringable;
 use function array_unshift;
 use function implode;
 use function sprintf;
@@ -18,17 +19,17 @@
  *
  * @package Toolkit\Stdlib\Str
  */
-class StrBuffer
+class StrBuffer implements Stringable
 {
     /**
-     * @var self
+     * @var self|null
      */
-    private static $global;
+    private static ?StrBuffer $global = null;
 
     /**
      * @var string[]
      */
-    private $parts = [];
+    private array $parts = [];
 
     /**
      * @param string $str
@@ -160,7 +161,7 @@ public function fetch(): string
         // clear
         $this->parts = [];
 
-        return implode($strings);
+        return implode('', $strings);
     }
 
     /**

src/Str/StrBuffer.php

@@ -1,6 +1,6 @@
 <?php declare(strict_types=1);
 
-namespace Toolkit\Stdlib\Std;
+namespace Toolkit\Stdlib\Str;
 
 use Toolkit\Stdlib\Str;
 use function in_array;
@@ -14,7 +14,7 @@ class StrValue
     /**
      * @var string
      */
-    protected $value;
+    protected string $value = '';
 
     /**
      * @param string $str

src/Std/StrValue.php renamed to src/Str/StrValue.php

@@ -166,7 +166,7 @@ public static function canAccessed(string $url): bool
     }
 
     // Build arrays of values we need to decode before parsing
-    protected static $entities = [
+    protected static array $entities = [
         '%21',
         '%2A',
         '%27',
@@ -186,7 +186,7 @@ public static function canAccessed(string $url): bool
         '%5D'
     ];
 
-    protected static $replacements = [
+    protected static array $replacements = [
         '!',
         '*',
         "'",