Merge pull request #27 Remove support for PHP <8.2

Author: hschimpf

.github/workflows/linux-php-8.0.yml

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to **parallel-sdk** are documented in this file. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/).
+
+## `3.0.0` – 2025-07-04
+
+### Added
+- **Domain-specific exception hierarchy**  
+  `ActionNotImplementedException`, `InvalidMessageReceivedException`, `NoWorkerDefinedException`, `TaskExecutionFailedException`, `WorkerAlreadyDefinedException`, `WorkerNotDefinedException`, plus a `ParallelException` value object to serialise task-side errors.
+- `Scheduler::runTask()` now surfaces worker exceptions through `TaskExecutionFailedException` for clearer diagnostics.
+- Adopted modern PHP 8.2 language features:  
+  * `readonly` properties and promoted constructor parameters  
+  * Precise return-type hints (e.g. `void` on closures)  
+  * `match`-style strict comparisons and assorted PSR-12 tidy-ups.
+
+### Changed
+- **BC-BREAK:** Minimum supported PHP version raised from 8.0 → **8.2**.  
+  Consumers on <8.2 will remain on the `2.x` series.
+- `Scheduler::using()` now throws `WorkerAlreadyDefinedException` when attempting to re-register an existing worker with constructor args.
+- Error bubbling in `Scheduler::runTask()` changed from `RuntimeException` with string message to the typed `TaskExecutionFailedException`.
+
+### Removed
+- CI workflows for PHP 8.0 & 8.1 ‒ the suite now runs on 8.2/8.3/8.4.
+- Legacy catch-all `RuntimeException` branches replaced with specific domain exceptions.
+
+### Fixed
+- Sporadic race-condition when starting the runner under PHP ≥ 8.1 by ensuring a micro-sleep and event handshake.
+- Several docblock inaccuracies and progress-bar initialisation edge cases.
+
+---
+
+## [2.1.4] – 2024-xx-xx
+_Refer to Git history for details prior to the 3.x line._

.github/workflows/linux-php-8.1.yml

@@ -7,8 +7,6 @@ An implementation of [krakjoe/parallel](https://github.com/krakjoe/parallel) PHP
 [![Monthly Downloads](https://img.shields.io/packagist/dm/hds-solutions/parallel-sdk?style=flat-square&color=747474&label)](https://packagist.org/packages/hds-solutions/parallel-sdk)
 [![Required PHP version](https://img.shields.io/packagist/dependency-v/hds-solutions/parallel-sdk/php?style=flat-square&color=006496&logo=php&logoColor=white)](https://packagist.org/packages/hds-solutions/parallel-sdk)
 
-[![PHP 8.0](https://img.shields.io/github/actions/workflow/status/hds-solutions/parallel-sdk/linux-php-8.0.yml?style=flat-square&logo=github&label=PHP%208.0)](https://github.com/hschimpf/parallel-sdk/actions/workflows/linux-php-8.0.yml)
-[![PHP 8.1](https://img.shields.io/github/actions/workflow/status/hds-solutions/parallel-sdk/linux-php-8.1.yml?style=flat-square&logo=github&label=PHP%208.1)](https://github.com/hschimpf/parallel-sdk/actions/workflows/linux-php-8.1.yml)
 [![PHP 8.2](https://img.shields.io/github/actions/workflow/status/hds-solutions/parallel-sdk/linux-php-8.2.yml?style=flat-square&logo=github&label=PHP%208.2)](https://github.com/hschimpf/parallel-sdk/actions/workflows/linux-php-8.2.yml)
 [![PHP 8.3](https://img.shields.io/github/actions/workflow/status/hds-solutions/parallel-sdk/linux-php-8.3.yml?style=flat-square&logo=github&label=PHP%208.3)](https://github.com/hschimpf/parallel-sdk/actions/workflows/linux-php-8.3.yml)
 [![PHP 8.4](https://img.shields.io/github/actions/workflow/status/hds-solutions/parallel-sdk/linux-php-8.4.yml?style=flat-square&logo=github&label=PHP%208.4)](https://github.com/hschimpf/parallel-sdk/actions/workflows/linux-php-8.4.yml)
@@ -19,7 +17,7 @@ That allow that your code can be deployed in any environment, and if `parallel`
 ## Installation
 ### Dependencies
 You need these dependencies to execute tasks in parallel.
-- PHP >= 8.0 with ZTS enabled
+- PHP >= 8.2 with ZTS enabled
 - parallel PECL extension _(v1.2.5 or higher)_
 
 Parallel extension documentation can be found on https://php.net/parallel.

CHANGELOG.md

@@ -15,7 +15,7 @@
         "symfony/console": "Allows usage of a shared ProgressBar between the Workers"
     },
     "require": {
-        "php": "^8.0"
+        "php": "^8.2"
     },
     "autoload": {
         "files": [

README.md

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace HDSSolutions\Console\Parallel\Exceptions;
+
+use RuntimeException;
+
+final class ActionNotImplementedException extends RuntimeException {
+
+    public function __construct(string $action) {
+        parent::__construct(sprintf('Action "%s" not yet implemented', $action));
+    }
+
+}

composer.json

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace HDSSolutions\Console\Parallel\Exceptions;
+
+use RuntimeException;
+
+final class InvalidMessageReceivedException extends RuntimeException {
+
+    public function __construct() {
+        parent::__construct('Invalid message received!');
+    }
+
+}

src/Exceptions/ActionNotImplementedException.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace HDSSolutions\Console\Parallel\Exceptions;
+
+use RuntimeException;
+
+final class NoWorkerDefinedException extends RuntimeException {
+
+    public function __construct() {
+        parent::__construct('No worker is defined');
+    }
+
+}

src/Exceptions/InvalidMessageReceivedException.php

@@ -4,7 +4,7 @@
 
 use Throwable;
 
-final class ParallelException {
+final readonly class ParallelException {
 
     private string $message;
 

src/Exceptions/NoWorkerDefinedException.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace HDSSolutions\Console\Parallel\Exceptions;
+
+use RuntimeException;
+
+final class TaskExecutionFailedException extends RuntimeException {
+
+    public function __construct(ParallelException $exception) {
+        parent::__construct($exception->getMessage());
+    }
+
+}