Replace Makefile with Castor task runner

.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,30 @@ 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, download the PHAR (example for Linux AMD64):
+
+```shell
+curl -L https://github.com/jolicode/castor/releases/latest/download/castor.linux-amd64.phar -o castor
+chmod +x castor
+```
+
+> **Note:** For other platforms (macOS, Windows, ARM), see the [Castor installation documentation](https://castor.jolicode.com/getting-started/installation).
+> You can either place the `castor` binary in your PATH (e.g., `/usr/local/bin/castor`) or keep it in the project root and run it as `./castor`.
+
+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');
+}