From 4ce65d59ca91871cfd126497158200a818720bce Mon Sep 17 00:00:00 2001
From: Daniel Baumann <daniel.baumann@progress-linux.org>
Date: Sat, 13 Apr 2024 13:30:08 +0200
Subject: Adding upstream version 0.13.1.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
---
 vendor/ipl/scheduler/src/Common/Promises.php | 108 +++++++++++++++++++++++++++
 1 file changed, 108 insertions(+)
 create mode 100644 vendor/ipl/scheduler/src/Common/Promises.php

(limited to 'vendor/ipl/scheduler/src/Common/Promises.php')

diff --git a/vendor/ipl/scheduler/src/Common/Promises.php b/vendor/ipl/scheduler/src/Common/Promises.php
new file mode 100644
index 0000000..b896627
--- /dev/null
+++ b/vendor/ipl/scheduler/src/Common/Promises.php
@@ -0,0 +1,108 @@
+<?php
+
+namespace ipl\Scheduler\Common;
+
+use ArrayObject;
+use InvalidArgumentException;
+use Ramsey\Uuid\UuidInterface;
+use React\Promise\PromiseInterface;
+use SplObjectStorage;
+
+trait Promises
+{
+    /** @var SplObjectStorage<UuidInterface, ArrayObject<int, PromiseInterface>> */
+    protected $promises;
+
+    /**
+     * Add the given promise for the specified UUID
+     *
+     * **Example Usage:**
+     *
+     * ```php
+     * $promise = work();
+     * $promises->addPromise($uuid, $promise);
+     * ```
+     *
+     * @param UuidInterface $uuid
+     * @param PromiseInterface $promise
+     *
+     * @return $this
+     */
+    protected function addPromise(UuidInterface $uuid, PromiseInterface $promise): self
+    {
+        if (! $this->promises->contains($uuid)) {
+            $this->promises->attach($uuid, new ArrayObject());
+        }
+
+        $this->promises[$uuid][] = $promise;
+
+        return $this;
+    }
+
+    /**
+     * Remove the given promise for the specified UUID
+     *
+     * **Example Usage:**
+     *
+     * ```php
+     * $promise->always(function () use ($uuid, $promise) {
+     *     $promises->removePromise($uuid, $promise);
+     * })
+     * ```
+     *
+     * @param UuidInterface $uuid
+     * @param PromiseInterface $promise
+     *
+     * @return $this
+     *
+     * @throws InvalidArgumentException If the given UUID doesn't have any registered promises or when the specified
+     *                                  UUID promises doesn't contain the provided promise
+     */
+    protected function removePromise(UuidInterface $uuid, PromiseInterface $promise): self
+    {
+        if (! $this->promises->contains($uuid)) {
+            throw new InvalidArgumentException(
+                sprintf('There are no registered promises for UUID %s', $uuid->toString())
+            );
+        }
+
+        foreach ($this->promises[$uuid] as $k => $v) {
+            if ($v === $promise) {
+                unset($this->promises[$uuid][$k]);
+
+                return $this;
+            }
+        }
+
+        throw new InvalidArgumentException(
+            sprintf('There is no such promise for UUID %s', $uuid->toString())
+        );
+    }
+
+    /**
+     * Detach and return promises for the given UUID, if any
+     *
+     * **Example Usage:**
+     *
+     * ```php
+     * foreach ($promises->detachPromises($uuid) as $promise) {
+     *     $promise->cancel();
+     * }
+     * ```
+     *
+     * @param UuidInterface $uuid
+     *
+     * @return PromiseInterface[]
+     */
+    protected function detachPromises(UuidInterface $uuid): array
+    {
+        if (! $this->promises->contains($uuid)) {
+            return [];
+        }
+
+        $promises = $this->promises[$uuid];
+        $this->promises->detach($uuid);
+
+        return $promises->getArrayCopy();
+    }
+}
-- 
cgit v1.2.3