up: update some class desc and redme

Author: inhere

README.md

@@ -83,6 +83,25 @@ $renderer = $box->get('renderer');
 
 ## Util classes
 
+### AutoLoader
+
+`AutoLoader` - an simple psr4 loader, can use for tests.
+
+```php
+AutoLoader::addFiles([
+    // alone files
+]);
+
+$loader = AutoLoader::getLoader();
+$loader->addPsr4Map([
+    'namespace' => 'path'
+]);
+
+$loader->addClassMap([
+ 'name' => 'class file'
+]);
+```
+
 ### Optional
 
 Not use Optional:
@@ -109,12 +128,48 @@ $username = Optional::ofNullable($userModel)->map(function ($userModel) {
 })->orElse('unknown');
 ```
 
-### DataStream
+### PhpDotEnv
+
+`PhpDotEnv` - a simple dont env file loader.
+
+The env config file `.env` (must is 'ini' format):
+
+```ini
+APP_ENV=dev
+DEBUG=true
+; ... ...
+```
+
+Usage:
 
 ```php
-use Toolkit\Stdlib\Util\Stream\DataStream;
+PhpDotEnv::load(__DIR__, '.env');
 
-$stream = DataStream::of($data);
+env('DEBUG', false);
+env('APP_ENV', 'prod');
+```
+
+### Stream
+
+```php
+use Toolkit\Stdlib\Util\Stream\DataStream;
+use Toolkit\Stdlib\Util\Stream\ListStream;
+
+$userList = ListStream::of($userModels)
+    ->filter(function ($userModel) {
+        // only need age > 20
+        return $userModel->age > 20;
+    })
+    ->map(function ($userModel) {
+        // only need field: age, name
+        return [
+            'age'  => $userModel->age,
+            'name' => $userModel->name,
+        ];
+    })
+    ->toArray();
+
+vdump($userList);
 ```
 
 ## License

src/Util/AutoLoader.php

@@ -16,15 +16,12 @@
 use function spl_autoload_unregister;
 use function str_replace;
 use function strlen;
-use function strpos;
 use function substr;
 use const DIRECTORY_SEPARATOR;
 
 /**
  * Class AutoLoader - an simple class loader
  *
- * @package Toolkit\Stdlib\Util
- *
  * ```php
  * AutoLoader::addFiles([
  *  // file
@@ -37,44 +34,48 @@
  *  'name' => 'file'
  * ]);
  * ```
+ *
+ * @package Toolkit\Stdlib\Util
  */
 class AutoLoader
 {
     /**
-     * @var self
+     * @var self|null
      */
-    private static $loader;
+    private static ?AutoLoader $loader = null;
 
     /**
      * @var array
      */
-    private static $files = [];
+    private static array $files = [];
 
     /**
-     * @var array
      * array (
      *  'prefix' => 'dir path'
      * )
+     *
+     * @var array
      */
-    private $psr0Map = [];
+    private array $psr0Map = [];
 
     /**
-     * @var array
      * array (
      *  'prefix' => 'dir path'
      * )
+     *
+     * @var array
      */
-    private $psr4Map = [];
+    private array $psr4Map = [];
 
     /**
-     * @var array
+     * @var array<string, string>
      */
-    private $classMap = [];
+    private array $classMap = [];
 
     /**
      * @var array
      */
-    private $missingClasses = [];
+    private array $missingClasses = [];
 
     /**
      * @param array $files
@@ -92,7 +93,6 @@ public static function getLoader(array $files = []): self
         }
 
         self::$loader = $loader = new self();
-
         $loader->register(true);
 
         foreach (self::$files as $fileIdentifier => $file) {
@@ -275,11 +275,11 @@ public function loadClass(string $class): ?bool
      *
      * @return string|false The path if found, false otherwise
      */
-    public function findFile(string $class)
+    public function findFile(string $class): bool|string
     {
         // work around for PHP 5.3.0 - 5.3.2 https://bugs.php.net/50731
         if ('\\' === $class[0]) {
-            $class = (string)substr($class, 1);
+            $class = substr($class, 1);
         }
 
         // class map lookup

src/Util/PhpDotEnv.php

@@ -28,9 +28,7 @@
 /**
  * Class PhpDotEnv - local env read
  *
- * @package Toolkit\Stdlib\Util
- *
- * in local config file `.env` (must is 'ini' format):
+ * The env config file `.env` (must is 'ini' format):
  *
  * ```ini
  * APP_ENV=dev
@@ -45,6 +43,8 @@
  * env('DEBUG', false);
  * env('APP_ENV', 'pdt');
  * ```
+ *
+ * @package Toolkit\Stdlib\Util
  */
 class PhpDotEnv
 {

src/Util/Stream/DataStream.php

@@ -238,30 +238,55 @@ public function mapTo(callable $mapper, self $stream): static
     }
 
     /**
-     * @param callable(array|mixed): array{string,mixed} $func
+     * Mapping values to MapStream
+     *
+     * @param callable(array|mixed): array{string,mixed} $mapper
      * @param MapStream|null $new
      *
      * @return MapStream
      */
-    public function mapToMap(callable $func, MapStream $new = null): MapStream
+    public function mapToMap(callable $mapper, MapStream $new = null): MapStream
     {
         $new = $new ?: new MapStream();
         foreach ($this as $item) {
-            [$key, $val] = $func($item);
+            [$key, $val] = $mapper($item);
             $new->offsetSet($key, $val);
         }
 
         return $new;
     }
 
     /**
+     * Mapping values to IntStream
+     *
+     * @param callable(T):int $mapper
+     * @param IntStream|null $new
+     *
+     * @return IntStream
+     */
+    public function mapToInt(callable $mapper, IntStream $new = null): IntStream
+    {
+        $new = $new ?: new IntStream;
+        foreach ($this as $val) {
+            $new->append($mapper($val));
+        }
+
+        return $new;
+    }
+
+    /**
+     * Mapping values to StringStream
+     *
+     * @param callable(T):string $mapper
+     * @param StringStream|null $new
+     *
      * @return StringStream
      */
-    public function mapToString(): StringStream
+    public function mapToString(callable $mapper, StringStream $new = null): StringStream
     {
-        $new = new StringStream;
+        $new = $new ?: new StringStream;
         foreach ($this as $val) {
-            $new->append($val);
+            $new->append($mapper($val));
         }
 
         return $new;
@@ -534,6 +559,12 @@ public function eachToMap(callable $func, array $map = []): array
         return $map;
     }
 
+    /**
+     * @param callable $handler
+     * @param ...$args
+     *
+     * @return mixed
+     */
     public function collect(callable $handler, ...$args): mixed
     {
         // TODO

src/Util/Stream/IntStream.php

@@ -19,5 +19,4 @@ public function append(mixed $value): static
         parent::append((int)$value);
         return $this;
     }
-
 }

src/Util/Stream/ListStream.php

@@ -2,34 +2,19 @@
 
 namespace Toolkit\Stdlib\Util\Stream;
 
-use function implode;
-
 /**
  * class ListStream
+ *
+ * @author inhere
  */
 class ListStream extends DataStream
 {
     /**
-     * @param string $sep
-     *
-     * @return string
-     */
-    public function join(string $sep = ','): string
-    {
-        return $this->implode($sep);
-    }
-
-    /**
-     * @param string $sep
+     * @param mixed $value
      *
-     * @return string
+     * @return $this
      */
-    public function implode(string $sep = ','): string
-    {
-        return implode($sep, $this->getArrayCopy());
-    }
-
-    public function append($value): static
+    public function append(mixed $value): static
     {
         parent::append($value);
         return $this;

src/Util/Stream/StringStream.php

@@ -19,4 +19,24 @@ public function append(mixed $value): static
         parent::append((string)$value);
         return $this;
     }
+
+    /**
+     * @param string $sep
+     *
+     * @return string
+     */
+    public function join(string $sep = ','): string
+    {
+        return $this->implode($sep);
+    }
+
+    /**
+     * @param string $sep
+     *
+     * @return string
+     */
+    public function implode(string $sep = ','): string
+    {
+        return implode($sep, $this->getArrayCopy());
+    }
 }