feat: implement enableFutureMode() in Client implementations

Author: Art4

src/Redmine/Client/ClientApiTrait.php

@@ -4,6 +4,7 @@
 
 use Redmine\Api;
 use Redmine\Exception\InvalidApiNameException;
+use Redmine\Future;
 
 /**
  * Provide API instantiation to clients.
@@ -60,6 +61,11 @@ public function getApi(string $name): Api
         return $this->apiInstances[$name];
     }
 
+    public function enableFutureMode(): void
+    {
+        Future::enableForwardCompatibility();
+    }
+
     private function isUploadCall(string $path): bool
     {
         $path = strtolower($path);

tests/Unit/Client/NativeCurlClient/EnableFutureModeTest.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Redmine\Tests\Unit\Client\NativeCurlClient;
+
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+use Redmine\Client\NativeCurlClient;
+use Redmine\Future;
+
+#[CoversClass(NativeCurlClient::class)]
+final class EnableFutureModeTest extends TestCase
+{
+    public function testEnableFutureModeEnablesFutureMode(): void
+    {
+        Future::disableForwardCompatibility();
+
+        $client = new NativeCurlClient(
+            '',
+            '',
+        );
+        $client->enableFutureMode();
+
+        self::assertTrue(Future::isForwardCompatibilityEnabled());
+
+        Future::disableForwardCompatibility();
+    }
+}

tests/Unit/Client/Psr18Client/EnableFutureModeTest.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Redmine\Tests\Unit\Client\Psr18Client;
+
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+use Psr\Http\Client\ClientInterface;
+use Psr\Http\Message\RequestFactoryInterface;
+use Psr\Http\Message\StreamFactoryInterface;
+use Redmine\Client\Psr18Client;
+use Redmine\Future;
+
+#[CoversClass(Psr18Client::class)]
+final class EnableFutureModeTest extends TestCase
+{
+    public function testEnableFutureModeEnablesFutureMode(): void
+    {
+        Future::disableForwardCompatibility();
+
+        $client = new Psr18Client(
+            $this->createStub(ClientInterface::class),
+            $this->createStub(RequestFactoryInterface::class),
+            $this->createStub(StreamFactoryInterface::class),
+            '',
+            '',
+        );
+        $client->enableFutureMode();
+
+        self::assertTrue(Future::isForwardCompatibilityEnabled());
+
+        Future::disableForwardCompatibility();
+    }
+}

tests/Unit/FutureTest.php

@@ -4,9 +4,11 @@
 
 namespace Redmine\Tests\Unit;
 
+use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\TestCase;
 use Redmine\Future;
 
+#[CoversClass(Future::class)]
 final class FutureTest extends TestCase
 {
     public function testIsForwardCompatabilityEnabledReturnsFalseByDefault(): void