adjust to promise template annotations

Author: dbu

.github/workflows/static.yml

@@ -15,6 +15,9 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v3
 
+      - name: Remove phpspec
+        run: composer remove phpspec/phpspec
+      
       - name: PHPStan
         uses: docker://oskarstark/phpstan-ga
         with:

composer.json

@@ -20,7 +20,7 @@
     ],
     "require": {
         "php": "^7.1 || ^8.0",
-        "php-http/promise": "^1.1",
+        "php-http/promise": "dev-template-exception as 1.2.2",
         "psr/http-client": "^1.0",
         "psr/http-message": "^1.0 || ^2.0"
     },

src/Exception/RequestAwareTrait.php

@@ -16,9 +16,6 @@ private function setRequest(RequestInterface $request)
         $this->request = $request;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getRequest(): RequestInterface
     {
         return $this->request;

src/HttpAsyncClient.php

@@ -4,6 +4,7 @@
 
 use Http\Promise\Promise;
 use Psr\Http\Message\RequestInterface;
+use Psr\Http\Message\ResponseInterface;
 
 /**
  * Sends a PSR-7 Request in an asynchronous way by returning a Promise.
@@ -17,7 +18,7 @@ interface HttpAsyncClient
      *
      * Exceptions related to processing the request are available from the returned Promise.
      *
-     * @return Promise resolves a PSR-7 Response or fails with an Http\Client\Exception
+     * @return Promise<ResponseInterface, Exception> resolves a PSR-7 Response or fails with an Http\Client\Exception
      *
      * @throws \Exception If processing the request is impossible (eg. bad configuration).
      */

src/Promise/HttpFulfilledPromise.php

@@ -6,6 +6,9 @@
 use Http\Promise\Promise;
 use Psr\Http\Message\ResponseInterface;
 
+/**
+ * @implements Promise<ResponseInterface, Exception>
+ */
 final class HttpFulfilledPromise implements Promise
 {
     /**
@@ -18,9 +21,6 @@ public function __construct(ResponseInterface $response)
         $this->response = $response;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function then(callable $onFulfilled = null, callable $onRejected = null)
     {
         if (null === $onFulfilled) {
@@ -34,17 +34,11 @@ public function then(callable $onFulfilled = null, callable $onRejected = null)
         }
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getState()
     {
         return Promise::FULFILLED;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function wait($unwrap = true)
     {
         if ($unwrap) {

src/Promise/HttpRejectedPromise.php

@@ -4,7 +4,11 @@
 
 use Http\Client\Exception;
 use Http\Promise\Promise;
+use Psr\Http\Message\ResponseInterface;
 
+/**
+ * @implements Promise<ResponseInterface, Exception>
+ */
 final class HttpRejectedPromise implements Promise
 {
     /**
@@ -17,9 +21,6 @@ public function __construct(Exception $exception)
         $this->exception = $exception;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function then(callable $onFulfilled = null, callable $onRejected = null)
     {
         if (null === $onRejected) {
@@ -38,17 +39,11 @@ public function then(callable $onFulfilled = null, callable $onRejected = null)
         }
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getState()
     {
         return Promise::REJECTED;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function wait($unwrap = true)
     {
         if ($unwrap) {