ci/docs: standardize badges and fix QA workflows across packages

Emmanuel Campait · Emmanuel Campait · commit 741db7d212c4 · 2026-04-10T17:09:27.000+02:00
diff --git a/.github/workflows/phpstan.yml b/.github/workflows/phpstan.yml
@@ -0,0 +1,31 @@
+name: PHPStan
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  phpstan:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+          extensions: intl, mbstring
+          coverage: none
+
+      - name: Install dependencies
+        run: composer install --no-interaction --prefer-dist
+
+      - name: Run PHPStan
+        run: vendor/bin/phpstan analyse -c phpstan.neon.dist --memory-limit=512M
diff --git a/.github/workflows/phpunit.yml b/.github/workflows/phpunit.yml
@@ -0,0 +1,31 @@
+name: PHPUnit
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  phpunit:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+          extensions: intl, mbstring
+          coverage: xdebug
+
+      - name: Install dependencies
+        run: composer install --no-interaction --prefer-dist
+
+      - name: Run PHPUnit
+        run: composer test
diff --git a/.github/workflows/psalm.yml b/.github/workflows/psalm.yml
@@ -0,0 +1,34 @@
+name: Psalm
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  psalm:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+          extensions: intl, mbstring
+          coverage: none
+
+      - name: Install dependencies
+        run: composer install --no-interaction --prefer-dist
+
+      - name: Prepare Psalm cache directory
+        run: mkdir -p build build/psalm
+
+      - name: Run Psalm
+        run: vendor/bin/psalm --config=psalm.xml
diff --git a/README.md b/README.md
@@ -1,5 +1,11 @@
 # Bootstrap Icons for CodeIgniter 4
 
+[![Packagist](https://img.shields.io/packagist/v/domprojects/codeigniter4-bootstrap-icons?label=Packagist)](https://packagist.org/packages/domprojects/codeigniter4-bootstrap-icons)
+[![License](https://img.shields.io/github/license/domProjects/codeigniter4-bootstrap-icons)](https://github.com/domProjects/codeigniter4-bootstrap-icons/blob/main/LICENSE)
+[![PHPUnit](https://img.shields.io/github/actions/workflow/status/domProjects/codeigniter4-bootstrap-icons/phpunit.yml?branch=main&label=PHPUnit)](https://github.com/domProjects/codeigniter4-bootstrap-icons/actions/workflows/phpunit.yml)
+[![Psalm](https://img.shields.io/github/actions/workflow/status/domProjects/codeigniter4-bootstrap-icons/psalm.yml?branch=main&label=Psalm)](https://github.com/domProjects/codeigniter4-bootstrap-icons/actions/workflows/psalm.yml)
+[![PHPStan](https://img.shields.io/github/actions/workflow/status/domProjects/codeigniter4-bootstrap-icons/phpstan.yml?branch=main&label=PHPStan)](https://github.com/domProjects/codeigniter4-bootstrap-icons/actions/workflows/phpstan.yml)
+
 Bootstrap Icons asset publisher for CodeIgniter 4 projects.
 
 ## Features
diff --git a/composer.json b/composer.json
@@ -41,6 +41,8 @@
             "domProjects\\CodeIgniterBootstrapIcons\\Tests\\": "tests/"
         }
     },
+    "minimum-stability": "dev",
+    "prefer-stable": true,
     "config": {
         "allow-plugins": {
             "phpstan/extension-installer": true
@@ -56,7 +58,7 @@
         ],
         "cs": "php-cs-fixer fix --ansi --verbose --dry-run --diff --config=.php-cs-fixer.dist.php",
         "cs-fix": "php-cs-fixer fix --ansi --verbose --diff --config=.php-cs-fixer.dist.php",
-        "test": "phpunit -c phpunit.xml.dist"
+        "test": "@php -d xdebug.mode=coverage vendor/bin/phpunit -c phpunit.xml.dist"
     },
     "extra": {
         "branch-alias": {
diff --git a/psalm.xml b/psalm.xml
@@ -6,7 +6,7 @@
     ensureOverrideAttribute="false"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns="https://getpsalm.org/schema/config"
-    xsi:schemaLocation="https://getpsalm.org/schema/config ../../../vendor/vimeo/psalm/config.xsd"
+    xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
     autoloader="psalm_autoload.php"
     cacheDirectory="build/psalm/"
     findUnusedBaselineEntry="true"
@@ -17,7 +17,7 @@
         <directory name="tests/" />
         <ignoreFiles>
             <directory name="build" />
-            <directory name="../../../vendor" />
+            <directory name="vendor" />
             <directory name="tests/_support" />
         </ignoreFiles>
     </projectFiles>
diff --git a/tests/bootstrap.php b/tests/bootstrap.php
@@ -11,9 +11,15 @@
  * the LICENSE file that was distributed with this source code.
  */
 
-$rootPath = realpath(__DIR__ . '/../../../../');
+$packageRoot = realpath(__DIR__ . '/..');
+$rootPath    = $packageRoot;
+$packageMode = $packageRoot !== false && is_file($packageRoot . DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR . 'autoload.php');
 
-if ($rootPath === false) {
+if (! $packageMode) {
+    $rootPath = realpath(__DIR__ . '/../../../../');
+}
+
+if ($rootPath === false || ! is_file($rootPath . DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR . 'autoload.php')) {
     throw new RuntimeException('Unable to resolve the project root for bootstrap icons tests.');
 }
 
@@ -23,8 +29,59 @@
     throw new RuntimeException('Unable to create the test public directory for bootstrap icons tests.');
 }
 
+if ($packageMode) {
+    $testAppRoot  = $rootPath . DIRECTORY_SEPARATOR . 'build' . DIRECTORY_SEPARATOR . 'test-app';
+    $configPath   = $testAppRoot . DIRECTORY_SEPARATOR . 'Config';
+    $writablePath = $rootPath . DIRECTORY_SEPARATOR . 'build' . DIRECTORY_SEPARATOR . 'writable';
+    $frameworkRoot = $rootPath . DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR . 'codeigniter4' . DIRECTORY_SEPARATOR . 'framework';
+    $pathsFile    = $configPath . DIRECTORY_SEPARATOR . 'Paths.php';
+
+    if (! is_dir($configPath) && ! mkdir($configPath, 0775, true) && ! is_dir($configPath)) {
+        throw new RuntimeException('Unable to create the test config directory for bootstrap icons tests.');
+    }
+
+    foreach ([$writablePath, $writablePath . DIRECTORY_SEPARATOR . 'cache', $writablePath . DIRECTORY_SEPARATOR . 'logs', $writablePath . DIRECTORY_SEPARATOR . 'session', $writablePath . DIRECTORY_SEPARATOR . 'uploads'] as $directory) {
+        if (! is_dir($directory) && ! mkdir($directory, 0775, true) && ! is_dir($directory)) {
+            throw new RuntimeException('Unable to create the writable directory for bootstrap icons tests.');
+        }
+    }
+
+    $pathsContents = <<<PHP
+<?php
+
+namespace Config;
+
+class Paths
+{
+    public string \$systemDirectory = %s;
+    public string \$appDirectory = %s;
+    public string \$writableDirectory = %s;
+    public string \$testsDirectory = %s;
+    public string \$viewDirectory = %s;
+    public string \$envDirectory = %s;
+}
+PHP;
+
+    $pathsContents = sprintf(
+        $pathsContents,
+        var_export(str_replace('\\', '/', $frameworkRoot . '/system'), true),
+        var_export(str_replace('\\', '/', $frameworkRoot . '/app'), true),
+        var_export(str_replace('\\', '/', $writablePath), true),
+        var_export(str_replace('\\', '/', $rootPath . DIRECTORY_SEPARATOR . 'tests'), true),
+        var_export(str_replace('\\', '/', $frameworkRoot . '/app/Views'), true),
+        var_export(str_replace('\\', '/', $rootPath), true),
+    );
+
+    if (! is_file($pathsFile) || file_get_contents($pathsFile) !== $pathsContents) {
+        file_put_contents($pathsFile, $pathsContents);
+    }
+
+    defined('CONFIGPATH') || define('CONFIGPATH', $configPath . DIRECTORY_SEPARATOR);
+} else {
+    defined('CONFIGPATH') || define('CONFIGPATH', $rootPath . DIRECTORY_SEPARATOR . 'app/Config' . DIRECTORY_SEPARATOR);
+}
+
 defined('HOMEPATH')    || define('HOMEPATH', $rootPath . DIRECTORY_SEPARATOR);
-defined('CONFIGPATH')  || define('CONFIGPATH', $rootPath . DIRECTORY_SEPARATOR . 'app/Config' . DIRECTORY_SEPARATOR);
 defined('PUBLICPATH')  || define('PUBLICPATH', $publicPath . DIRECTORY_SEPARATOR);
 defined('TESTPATH')    || define('TESTPATH', __DIR__ . DIRECTORY_SEPARATOR);
 defined('SUPPORTPATH') || define('SUPPORTPATH', __DIR__ . DIRECTORY_SEPARATOR . '_support' . DIRECTORY_SEPARATOR);
