Add Castor tasks and update Infection workflow

This commit introduces a new Castor PHP script with different tasks for test execution, mutation testing, coding standards check, PHPStan, and others. The Infection GitHub workflow was also updated to use the new Castor 'infect' task instead of 'make ci-mu'. The 'Infection' workflow name was also corrected.

.github/workflows/infection.yml

@@ -1,6 +1,6 @@
 # yaml-language-server: $schema=https://json.schemastore.org/github-workflow
 
-name: "Integrate"
+name: "Infection"
 
 on:
   push:
@@ -18,6 +18,7 @@ jobs:
           php-version: "8.3"
           extensions: "ctype, dom, json, libxml, mbstring, openssl, phar, simplexml, tokenizer, xml, xmlwriter"
           coverage: "xdebug"
+          tools: castor
 
       - name: "Checkout code"
         uses: "actions/checkout@v3"
@@ -32,4 +33,4 @@ jobs:
           composer-options: "--optimize-autoloader"
 
       - name: "Execute Infection"
-        run: "make ci-mu"
+        run: "castor infect --ci"

castor.php

@@ -0,0 +1,117 @@
+<?php
+
+declare(strict_types=1);
+
+use Castor\Attribute\AsTask;
+use function Castor\io;
+use function Castor\run;
+
+#[AsTask(description: 'Run mutation testing')]
+function infect(int $minMsi = 0, int $minCoveredMsi = 0, bool $ci = false): void
+{
+    io()->title('Running infection');
+    $nproc = run('nproc', quiet: true);
+    if (! $nproc->isSuccessful()) {
+        io()->error('Cannot determine the number of processors');
+        return;
+    }
+    $threads = (int) $nproc->getOutput();
+    $command = [
+        'php',
+        'vendor/bin/infection',
+        sprintf('--min-msi=%s', $minMsi),
+        sprintf('--min-covered-msi=%s', $minCoveredMsi),
+        sprintf('--threads=%s', $threads),
+    ];
+    if ($ci) {
+        $command[] = '--logger-github';
+        $command[] = '-s';
+    }
+    $environment = [
+        'XDEBUG_MODE' => 'coverage',
+    ];
+    run($command, environment: $environment);
+}
+
+#[AsTask(description: 'Run tests')]
+function test(bool $coverageHtml = false, bool $coverageText = false, null|string $group = null): void
+{
+    io()->title('Running tests');
+    $command = ['php', 'vendor/bin/phpunit', '--color'];
+    $environment = [
+        'XDEBUG_MODE' => 'off',
+    ];
+    if ($coverageHtml) {
+        $command[] = '--coverage-html=build/coverage';
+        $environment['XDEBUG_MODE'] = 'coverage';
+    }
+    if ($coverageText) {
+        $command[] = '--coverage-text';
+        $environment['XDEBUG_MODE'] = 'coverage';
+    }
+    if ($group !== null) {
+        $command[] = sprintf('--group=%s', $group);
+    }
+    run($command, environment: $environment);
+}
+
+#[AsTask(description: 'Coding standards check')]
+function cs(bool $fix = false): void
+{
+    io()->title('Running coding standards check');
+    $command = ['php', 'vendor/bin/ecs', 'check'];
+    $environment = [
+        'XDEBUG_MODE' => 'off',
+    ];
+    if ($fix) {
+        $command[] = '--fix';
+    }
+    run($command, environment: $environment);
+}
+
+#[AsTask(description: 'Running PHPStan')]
+function stan(): void
+{
+    io()->title('Running PHPStan');
+    $command = ['php', 'vendor/bin/phpstan', 'analyse'];
+    $environment = [
+        'XDEBUG_MODE' => 'off',
+    ];
+    run($command, environment: $environment);
+}
+
+#[AsTask(description: 'Validate Composer configuration')]
+function validate(): void
+{
+    io()->title('Validating Composer configuration');
+    $command = ['composer', 'validate'];
+    $environment = [
+        'XDEBUG_MODE' => 'off',
+    ];
+    run($command, environment: $environment);
+}
+
+#[AsTask(description: 'Run Rector')]
+function rector(bool $fix = false): void
+{
+    io()->title('Running Rector');
+    $command = ['php', 'vendor/bin/rector', 'process', '--ansi'];
+    if (! $fix) {
+        $command[] = '--dry-run';
+    }
+    $environment = [
+        'XDEBUG_MODE' => 'off',
+    ];
+    run($command, environment: $environment);
+}
+
+#[AsTask(description: 'Run Rector')]
+function deptrac(): void
+{
+    io()->title('Running Rector');
+    $command = ['php', 'vendor/bin/deptrac', 'analyse', '--fail-on-uncovered', '--no-cache'];
+    $environment = [
+        'XDEBUG_MODE' => 'off',
+    ];
+    run($command, environment: $environment);
+}

infection.json

@@ -0,0 +1,20 @@
+{
+    "timeout":20,
+    "source": {
+        "directories": [
+            "src"
+        ]
+    },
+    "logs": {
+        "text": "infection.log"
+    },
+    "mutators": {
+        "@default": true,
+        "MBString": {
+            "settings": {
+                "mb_substr": false,
+                "mb_strlen": false
+            }
+        }
+    }
+}