v2.0.0

bin/unitary

@@ -1,40 +1,31 @@
 #!/usr/bin/env php
 <?php
 /**
- * MaplePHP Unitary unit testing library
- * @example php unitary --path=fullDirPath --exclude="dir1/dir2/
+ * MaplePHP Unitary bin file
  */
 
-require $GLOBALS['_composer_autoload_path'];
+use MaplePHP\Blunder\Handlers\CliHandler;
+use MaplePHP\Unitary\Console\Application;
 
-use MaplePHP\Http\Environment;
-use MaplePHP\Http\ServerRequest;
-use MaplePHP\Http\Uri;
-use MaplePHP\Prompts\Command;
-use MaplePHP\Unitary\FileIterator;
 
-$command = new Command();
-$env = new Environment();
-$request = new ServerRequest(new Uri($env->getUriParts([
-    "argv" => $argv
-])), $env);
+$autoload = __DIR__ . '/../../../../vendor/autoload.php';
+$autoload = is_file($autoload) ? $autoload : __DIR__ . '/../vendor/autoload.php';
+$autoload = realpath($autoload);
 
-$data = $request->getCliArgs();
-$defaultPath = (defined("UNITARY_PATH") ? UNITARY_PATH : "./");
-
-try {
-    $path = ($data['path'] ?? $defaultPath);
-    if(!isset($path)) {
-        throw new Exception("Path not specified: --path=path/to/dir");
+if (!$autoload || !is_file($autoload)) {
+    if (!empty($GLOBALS['_composer_autoload_path'])) {
+        $autoload = $GLOBALS['_composer_autoload_path'];
+    } else {
+        fwrite(STDERR, "Autoloader not found. Run `composer install`.\n");
+        exit(1);
     }
+}
 
-    $testDir = realpath($path);
-    if(!is_dir($testDir)) {
-        throw new Exception("Test directory '$testDir' does not exist");
-    }
-    $unit = new FileIterator($data);
-    $unit->executeAll($testDir);
+require $autoload;
 
-} catch (Exception $e) {
-    $command->error($e->getMessage());
-}
+$app = (new Application())
+        ->withErrorHandler(new CliHandler())
+        ->boot([
+            "argv" => $argv,
+            "dir" => getcwd()
+        ]);

composer.json

@@ -31,6 +31,10 @@
     "maplephp/prompts": "^1.0"
   },
   "autoload": {
+    "files": [
+      "src/Setup/assert-polyfill.php",
+      "src/Support/functions.php"
+    ],
     "psr-4": {
       "MaplePHP\\Unitary\\": "src"
     }

src/Config/ConfigProps.php

@@ -0,0 +1,92 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MaplePHP\Unitary\Config;
+
+use InvalidArgumentException;
+use MaplePHP\Emitron\AbstractConfigProps;
+
+/**
+ * Defines the set of allowed configuration properties and CLI arguments.
+ *
+ * CLI arguments with matching property names will override configuration file values.
+ *
+ * Note:
+ * - All properties are nullable, indicating they have not been explicitly set.
+ * - Null values allow the system to distinguish between "not provided" and "intentionally set".
+ * - Do not use array values or multiple data types
+ */
+class ConfigProps extends AbstractConfigProps
+{
+    public ?string $path = null;
+    public ?string $discoverPattern = null;
+    public ?string $exclude = null;
+    public ?string $show = null;
+    public ?string $timezone = null;
+    public ?string $local = null;
+    public ?int $exitCode = null;
+    public ?bool $verbose = null;
+    public ?bool $alwaysShowFiles = null;
+    public ?bool $errorsOnly = null;
+    public ?bool $smartSearch = null;
+    public ?bool $failFast = null;
+
+
+    /**
+     * Hydrate the properties/object with expected data, and handle unexpected data
+     *
+     * @param string $key
+     * @param mixed $value
+     * @return void
+     */
+    protected function propsHydration(string $key, mixed $value): void
+    {
+        switch ($key) {
+            case 'path':
+                $this->path = (!is_string($value) || $value === '') ? null : $value;
+                break;
+            case 'discoverPattern':
+                $this->discoverPattern = (!is_string($value) || $value === '') ? null : $value;
+                break;
+            case 'exclude':
+                $this->exclude = (!is_string($value) || $value === '') ? null : $value;
+                break;
+            case 'show':
+                $this->show = (!is_string($value) || $value === '') ? null : $value;
+                break;
+            case 'timezone':
+                // The default timezone is 'CET'
+                $this->timezone = (!is_string($value) || $value === '') ? 'Europe/Stockholm' : $value;
+                break;
+            case 'local':
+                // The default timezone is 'CET'
+                $this->local = (!is_string($value) || $value === '') ? 'en_US' : $value;
+                if(!$this->isValidLocale($this->local)) {
+                    throw new InvalidArgumentException(
+                        "Invalid locale '{$this->local}'. Expected format like 'en_US' (language_COUNTRY)."
+                    );
+                }
+                break;
+            case 'exitCode':
+                $this->exitCode = ($value === null) ? null : (int)$value;
+                break;
+            case 'verbose':
+                $this->verbose = $this->dataToBool($value);
+                break;
+            case 'alwaysShowFiles':
+                $this->alwaysShowFiles = $this->dataToBool($value);
+                break;
+            case 'smartSearch':
+                $this->smartSearch = $this->dataToBool($value);
+                break;
+            case 'errorsOnly':
+                $this->errorsOnly = $this->dataToBool($value);
+                break;
+            case 'failFast':
+                $this->failFast = $this->dataToBool($value);
+                break;
+        }
+    }
+
+}

src/Config/TestConfig.php

@@ -0,0 +1,93 @@
+<?php
+
+/**
+ * TestConfig — Part of the MaplePHP Unitary Testing Library
+ *
+ * @package:    MaplePHP\Unitary
+ * @author:     Daniel Ronkainen
+ * @licence:    Apache-2.0 license, Copyright © Daniel Ronkainen
+ *              Don't delete this comment, it's part of the license.
+ */
+declare(strict_types=1);
+
+namespace MaplePHP\Unitary\Config;
+
+final class TestConfig
+{
+    public ?string $message;
+    public bool $skip = false;
+    public string $select = "";
+    private bool $updatedSubject = false;
+
+    public function __construct(string $message)
+    {
+        $this->message = $message;
+    }
+
+    /**
+     * Statically make instance.
+     *
+     * @param string $message
+     * @return self
+     */
+    public static function make(string $message = "Validating"): self
+    {
+        return new self($message);
+    }
+
+    /**
+     * Sets the select state for the current instance.
+     *
+     * @param string $key The key to set.
+     * @return self
+     */
+    public function withName(string $key): self
+    {
+        $inst = clone $this;
+        $inst->select = $key;
+        return $inst;
+    }
+
+    // Alias for setName()
+    public function setSelect(string $key): self
+    {
+        return $this->withName($key);
+    }
+
+    /**
+     * Sets the message for the current instance.
+     *
+     * @param string $subject The message to set.
+     * @return self
+     */
+    public function withSubject(string $subject): self
+    {
+        $inst = clone $this;
+        $inst->updatedSubject = true;
+        $inst->message = $subject;
+        return $inst;
+    }
+
+    /**
+     * Check if a subject has been added in `withSubject`
+     *
+     * @return bool
+     */
+    public function hasSubject(): bool
+    {
+        return $this->updatedSubject;
+    }
+
+    /**
+     * Sets the skip state for the current instance.
+     *
+     * @param bool $bool Optional. The value to set for the skip state. Defaults to true.
+     * @return self
+     */
+    public function withSkip(bool $bool = true): self
+    {
+        $inst = clone $this;
+        $inst->skip = $bool;
+        return $inst;
+    }
+}

src/Console/Application.php

@@ -0,0 +1,58 @@
+<?php
+namespace MaplePHP\Unitary\Console;
+
+use MaplePHP\Blunder\Interfaces\AbstractHandlerInterface;
+use MaplePHP\Blunder\Run;
+use MaplePHP\Container\Container;
+use MaplePHP\Http\Environment;
+use MaplePHP\Http\ServerRequest;
+use MaplePHP\Http\Uri;
+use MaplePHP\Unitary\Console\Middlewares\{
+    AddCommandMiddleware,
+    CliInitMiddleware,
+    ConfigPropsMiddleware,
+    LocalMiddleware
+};
+
+final class Application
+{
+
+    /**
+     * Default error handler boot
+     * @param AbstractHandlerInterface $handler
+     * @return $this
+     */
+    public function withErrorHandler(AbstractHandlerInterface $handler): self
+    {
+        $inst = clone $this;
+        $run = new Run($handler);
+        $run->severity()
+            ->excludeSeverityLevels([E_USER_WARNING, E_NOTICE, E_USER_NOTICE, E_DEPRECATED, E_USER_DEPRECATED])
+            ->redirectTo(function () {
+                // Let PHP’s default error handler process excluded severities
+                return false;
+            });
+        $run->setExitCode(1);
+        $run->load();
+        return $inst;
+    }
+
+    /**
+     * @param array $parts
+     * @return Kernel
+     * @throws \Exception
+     */
+    public function boot(array $parts): Kernel
+    {
+        $env = new Environment();
+        $request = new ServerRequest(new Uri($env->getUriParts($parts)), $env);
+        $kernel = new Kernel(new Container(), [
+            AddCommandMiddleware::class,
+            ConfigPropsMiddleware::class,
+            LocalMiddleware::class,
+            CliInitMiddleware::class
+        ]);
+        $kernel->run($request);
+        return $kernel;
+    }
+}

src/Console/ConsoleRouter.php

@@ -0,0 +1,13 @@
+<?php
+
+use MaplePHP\Unitary\Console\Controllers\CoverageController;
+use MaplePHP\Unitary\Console\Controllers\RunTestController;
+use MaplePHP\Unitary\Console\Controllers\TemplateController;
+use MaplePHP\Unitary\Console\Middlewares\TestMiddleware;
+
+return $router
+    ->map("coverage", [CoverageController::class, "run"])
+    ->map("template", [TemplateController::class, "run"])
+    ->map("junit", [RunTestController::class, "runJUnit"])
+    ->map(["", "test", "run"], [RunTestController::class, "run"])->with(TestMiddleware::class)
+    ->map(["__404", "help"], [RunTestController::class, "help"]);

src/Console/Controllers/CoverageController.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace MaplePHP\Unitary\Console\Controllers;
+
+use MaplePHP\Http\Interfaces\ResponseInterface;
+use MaplePHP\Prompts\Themes\Blocks;
+use MaplePHP\Unitary\Console\Services\RunTestService;
+use MaplePHP\Unitary\Renders\SilentRender;
+use MaplePHP\Unitary\Support\TestUtils\CodeCoverage;
+
+class CoverageController extends DefaultController
+{
+    /**
+     * Code Coverage Controller
+     */
+    public function run(RunTestService $service): ResponseInterface
+    {
+        $coverage = new CodeCoverage();
+        $coverage->start();
+        $handler = new SilentRender();
+        $response = $service->run($handler);
+        $coverage->end();
+
+        $result = $coverage->getResponse();
+        if ($result !== false) {
+            $this->outputBody($result);
+        } else {
+            $this->command->error("Error: Code coverage is not reachable");
+            $this->command->error("Reason: " . $coverage->getIssue()->message());
+        }
+        $this->command->message("");
+
+        return $response;
+    }
+
+    /**
+     * Will output the main body response in CLI
+     *
+     * @param array $result
+     * @return void
+     */
+    private function outputBody(array $result): void
+    {
+        $block = new Blocks($this->command);
+        $block->addSection("Code coverage", function (Blocks $block) use ($result) {
+            return $block->addList("Total lines:", $result['totalLines'])
+                ->addList("Executed lines:", $result['executedLines'])
+                ->addList("Code coverage percent:", $result['percent'] . "%");
+        });
+    }
+}