Replace Makefile with Castor task runner

.github/workflows/ci.yml

@@ -15,10 +15,20 @@ jobs:
             - name: Checkout
               uses: actions/checkout@v3
 
-            - name: PHP-CS-Fixer
-              uses: docker://oskarstark/php-cs-fixer-ga
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
               with:
-                  args: --config=.php-cs-fixer.php --diff --dry-run
+                  php-version: '8.3'
+                  extensions: mbstring, xml
+
+            - name: Setup Castor
+              uses: castor-php/[email protected]
+
+            - name: Install Composer dependencies
+              run: composer install --prefer-dist --no-interaction
+
+            - name: Run PHP-CS-Fixer check
+              run: castor cs:dry-run
 
     phpstan:
         name: PHPStan
@@ -27,10 +37,20 @@ jobs:
             - name: Checkout
               uses: actions/checkout@v3
 
-            - name: PHPStan
-              uses: docker://oskarstark/phpstan-ga
-              env:
-                  REQUIRE_DEV: true
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: '8.3'
+                  extensions: mbstring, xml
+
+            - name: Setup Castor
+              uses: castor-php/[email protected]
+
+            - name: Install Composer dependencies
+              run: composer install --prefer-dist --no-interaction
+
+            - name: Run PHPStan
+              run: castor phpstan
 
     ci:
         name: "Tests (PHP ${{ matrix.php-version }}, Symfony ${{ matrix.symfony }})"

.gitignore

@@ -4,6 +4,10 @@
 /composer.lock
 /vendor
 
+# Castor
+/castor
+/.castor.stub.php
+
 # Temporary
 /tests/app/var
 /tests/app/public/bundles

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changes between versions
 
+## Unreleased
+
+* Replaced Makefile with Castor task runner
+* Added development documentation for Castor
+
 ## 1.10.0 (2026-02-03)
 
 * Added support for PHP 8.5

CONTRIBUTING.md

@@ -48,7 +48,7 @@ changes, improvements or alternatives may be given).
 Run the tests using the following script:
 
 ```shell
-make test
+castor test
 ```
 
 ## Manual testing
@@ -70,7 +70,7 @@ Use [PHP CS fixer](https://cs.symfony.com/) to make your code compliant with
 GifExceptionBundle's coding standards:
 
 ```shell
-make cs
+castor cs
 ```
 
 ## Keeping your fork up-to-date

README.md

@@ -49,6 +49,22 @@ Although it would probably make more sense to use the former and push up the opt
 
 It uses [gifsicle](https://www.lcdf.org/gifsicle/) to optimize gifs via the [image-optimizer](https://github.com/psliwa/image-optimizer) library.
 
+## Development
+
+This project uses [Castor](https://castor.jolicode.com/) as a task runner for common development tasks.
+
+To install Castor, see the [installation documentation](https://castor.jolicode.com/getting-started/installation).
+
+Available tasks:
+
+```shell
+castor list        # List all available tasks
+castor test        # Run the test suite
+castor cs          # Fix PHP coding standards
+castor cs:dry-run  # Check PHP coding standards
+castor phpstan     # Run static analysis
+```
+
 ## Further documentation
 
 You can see the current and past versions using one of the following:

castor.php

@@ -0,0 +1,38 @@
+<?php
+
+/*
+ * This file is part of the GifExceptionBundle project.
+ *
+ * (c) JoliCode <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+use Castor\Attribute\AsTask;
+
+use function Castor\run;
+
+#[AsTask(description: 'Fix PHP CS')]
+function cs(): void
+{
+    run('vendor/bin/php-cs-fixer fix --verbose');
+}
+
+#[AsTask(name: 'cs:dry-run', description: 'Test if PHP CS is correct')]
+function cs_dry_run(): void
+{
+    run('vendor/bin/php-cs-fixer fix --verbose --dry-run');
+}
+
+#[AsTask(description: 'Run the test suite')]
+function test(): void
+{
+    run('vendor/bin/simple-phpunit');
+}
+
+#[AsTask(description: 'Run static analysis')]
+function phpstan(): void
+{
+    run('vendor/bin/phpstan analyse -c phpstan.neon');
+}

phpstan.neon

@@ -5,3 +5,4 @@ parameters:
 	excludePaths:
 	    - vendor
 	    - tests
+	    - castor.php