update tests

Author: matronator

.env.php.local

@@ -0,0 +1,2 @@
+export PATH="/usr/local/opt/php@8.1/bin:$PATH"
+export PATH="/usr/local/opt/php@8.1/sbin:$PATH"

.travis.yml

@@ -0,0 +1,41 @@
+language: php
+
+php:
+  - '8.1'
+  - '8.2'
+  - '8.3'
+  - '8.4'
+  - nightly
+
+env:
+  - TESTER_PHP_BIN="php"
+  - TESTER_PHP_BIN="phpdbg"
+
+before_install:
+  - composer self-update
+
+install:
+  - composer install --no-interaction --prefer-source
+
+matrix:
+  exclude:
+    - php: 8.2
+      env: TESTER_PHP_BIN="phpdbg"
+
+    - php: 8.3
+      env: TESTER_PHP_BIN="phpdbg"
+
+    - php: 8.4
+      env: TESTER_PHP_BIN="phpdbg"
+
+    - php: nightly
+      env: TESTER_PHP_BIN="phpdbg"
+  allow_failures:
+    - php: nightly
+
+script:
+  - ./vendor/bin/tester ./tests -p $TESTER_PHP_BIN -s --coverage coverage.html --coverage-src src/Parsem
+
+after_failure:
+  # Print *.actual file contents
+  - for i in $(find ./tests -name \*.actual); do echo "--- $i"; cat $i; echo; echo; done

composer.json

@@ -15,7 +15,7 @@
         {
             "name": "Matronator",
             "email": "5470780+matronator@users.noreply.github.com",
-            "homepage": "https://matronator.com",
+            "homepage": "https://matronator.cz",
             "role": "Developer"
         }
     ],
@@ -32,7 +32,7 @@
 		}
     },
     "scripts": {
-        "test": "tester ."
+        "test": "tester tests/ -p phpdbg --coverage coverage.html --coverage-src src/Parsem"
     },
     "minimum-stability": "dev",
     "funding": [

coverage.html

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Matronator\Parsem\Config;
+
+use ArrayObject;
+
+class Options extends ArrayObject
+{
+    public function __construct(
+        public readonly bool $strict = false,
+        public readonly PatternsOption $patterns = new PatternsOption(),
+        public readonly ?bool $trimBeforeBlocks = false,
+        public readonly ?bool $trimAfterBlocks = false,
+    ) { }
+}

src/Parsem/Config/Options.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Matronator\Parsem\Config;
+
+use ArrayObject;
+
+class PatternsOption extends ArrayObject
+{
+    public function __construct(
+        public ?string $variables = null,
+        public ?string $conditions = null,
+        public ?string $comments = null,
+    ) { }
+}

src/Parsem/Config/PatternsOption.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Matronator\Parsem;
+
+use Matronator\Parsem\Config\Options;
+use Matronator\Parsem\Config\PatternsOption;
+
+class Engine
+{
+    private bool $strict = true;
+    private bool $trimBeforeBlocks = false;
+    private bool $trimAfterBlocks = false;
+    private PatternsOption $patterns = new PatternsOption();
+
+    public function __construct(Options|array|null $options = new Options())
+    {
+        $this->setOptions($options);
+    }
+
+    public function setOptions(Options|array|null $options = new Options()): void
+    {
+        if (!($options instanceof Options)) {
+            if (is_array($options)) {
+                $options = new Options(...$options);
+            } else {
+                throw new \InvalidArgumentException('Options must be an instance of Options class or an array.');
+            }
+        }
+
+        $this->strict = $options->strict ?? $this->strict;
+        $this->patterns = $options->patterns ?? $this->patterns;
+        $this->trimBeforeBlocks = $options->trimBeforeBlocks ?? $this->trimBeforeBlocks;
+        $this->trimAfterBlocks = $options->trimAfterBlocks ?? $this->trimAfterBlocks;
+    }
+
+    public function getOptions(): Options
+    {
+        return new Options(
+            $this->strict,
+            $this->patterns,
+            $this->trimBeforeBlocks,
+            $this->trimAfterBlocks,
+        );
+    }
+
+    public function parse(string $input, array $arguments = []): string
+    {
+        return Parser::parseString($input, $arguments, $this->strict, $this->patterns);
+    }
+}

src/Parsem/Engine.php

@@ -8,7 +8,15 @@ class Filters
 {
     public const ENCODING = 'UTF-8';
 
-    public const GLOBAL_FILTERS = ['upper', 'lower', 'upperFirst', 'lowerFirst', 'first', 'last', 'camelCase', 'snakeCase', 'kebabCase', 'pascalCase', 'titleCase', 'length', 'reverse', 'random', 'truncate'];
+    public const GLOBAL_FILTERS = [
+        'upper', 'lower',
+        'upperFirst', 'lowerFirst',
+        'first', 'last',
+        'camelCase', 'snakeCase', 'kebabCase', 'pascalCase', 'titleCase',
+        'length',
+        'reverse', 'random', 'shuffle',
+        'truncate',
+        'escape', 'unescape', 'hash'];
 
     public static function upper(string $string): string
     {
@@ -78,30 +86,39 @@ public static function titleCase(string $string): string
         return $string;
     }
 
-    public static function length(string $string): int
+    public static function length(array|string $value): int
     {
-        return mb_strlen($string, static::ENCODING);
+        return is_string($value) ? mb_strlen($value, static::ENCODING) : count($value);
     }
 
-    public static function reverse(string $string): string
+    public static function reverse(array|string $value): array|string
     {
-        return strrev($string);
+        return is_string($value) ? strrev($value) : array_reverse($value);
     }
 
-    public static function random(array|string $array): mixed
+    public static function random(array|string $value): array|string
     {
-        if (is_string($array))
-            return $array[rand(0, strlen($array) - 1)];
-        
-        return $array[array_rand($array)];
+        if (is_string($value)) {
+            return $value[rand(0, strlen($value) - 1)];
+        }
+
+        return $value[array_rand($value)];
+    }
+
+    public static function shuffle(array|string $value): array|string
+    {
+        $array = is_string($value) ? str_split($value) : $value;
+        shuffle($array);
+
+        return $value;
     }
 
     public static function truncate(string $string, int $length, string $ending = '...'): string
     {
         if (mb_strlen($string, static::ENCODING) <= $length) {
             return $string;
         }
-        
+
         return mb_substr($string, 0, $length, static::ENCODING) . $ending;
     }
 }