Created proxy interface and implementation

Author: Bastian Schwarz

src/Secret/Proxy/String/StringProxyInterface.php

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+
+namespace de\codenamephp\platform\secretsManager\base\Secret\Proxy\String;
+
+use de\codenamephp\platform\secretsManager\base\Secret\SecretInterface;
+use Stringable;
+
+/**
+ * Interface to proxy a secret that is a string and load it once lazily.
+ *
+ * Implementations should hold a client and a secret and fetch the payload once when it is needed and cache it.
+ */
+interface StringProxyInterface extends SecretInterface, Stringable
+{
+
+}

src/Secret/Proxy/String/WithClientAsClassMember.php

@@ -0,0 +1,43 @@
+<?php declare(strict_types=1);
+
+namespace de\codenamephp\platform\secretsManager\base\Secret\Proxy\String;
+
+use de\codenamephp\platform\secretsManager\base\Client\ClientInterface;
+use de\codenamephp\platform\secretsManager\base\Secret\Payload\PayloadInterface;
+use de\codenamephp\platform\secretsManager\base\Secret\SecretInterface;
+
+/**
+ * Proxy that just holds the secret, the client and the payload as members. When the payload is needed and is null
+ * it is resolved with the client and set. All further calls to the payload will therefore use the resolved payload.
+ *
+ * Everything else is just delegated to the secret.
+ */
+final class WithClientAsClassMember implements StringProxyInterface {
+
+  public ?PayloadInterface $payload = null;
+
+  public function __construct(
+    public readonly ClientInterface $client,
+    public readonly SecretInterface $secret
+  ) {}
+
+  public function __toString() : string {
+    return $this->fetchPayload()->getContent();
+  }
+
+  public function getName() : string {
+    return $this->secret->getName();
+  }
+
+  public function getProject() : string {
+    return $this->secret->getProject();
+  }
+
+  public function getVersion() : string {
+    return $this->secret->getVersion();
+  }
+
+  public function fetchPayload() : PayloadInterface {
+    return $this->payload ??= $this->client->fetchPayload($this->secret);
+  }
+}

test/Secret/Proxy/String/WithClientAsClassMemberTest.php

@@ -0,0 +1,78 @@
+<?php declare(strict_types=1);
+
+namespace de\codenamephp\platform\secretsManager\base\test\Secret\Proxy\String;
+
+use de\codenamephp\platform\secretsManager\base\Client\ClientInterface;
+use de\codenamephp\platform\secretsManager\base\Secret\Payload\PayloadInterface;
+use de\codenamephp\platform\secretsManager\base\Secret\Proxy\String\WithClientAsClassMember;
+use de\codenamephp\platform\secretsManager\base\Secret\SecretInterface;
+use PHPUnit\Framework\TestCase;
+
+final class WithClientAsClassMemberTest extends TestCase {
+
+  public function test__construct() : void {
+    $secret = $this->createMock(SecretInterface::class);
+    $client = $this->createMock(ClientInterface::class);
+
+    $sut = new WithClientAsClassMember($client, $secret);
+
+    self::assertSame($secret, $sut->secret);
+    self::assertSame($client, $sut->client);
+  }
+
+  public function testGetName() : void {
+    $secret = $this->createMock(SecretInterface::class);
+    $secret->expects(self::once())->method('getName')->willReturn('name');
+
+    $sut = new WithClientAsClassMember($this->createMock(ClientInterface::class), $secret);
+
+    self::assertSame('name', $sut->getName());
+  }
+
+  public function testGetVersion() : void {
+    $secret = $this->createMock(SecretInterface::class);
+    $secret->expects(self::once())->method('getVersion')->willReturn('version');
+
+    $sut = new WithClientAsClassMember($this->createMock(ClientInterface::class), $secret);
+
+    self::assertSame('version', $sut->getVersion());
+  }
+
+  public function testFetchPayload() : void {
+    $secret = $this->createMock(SecretInterface::class);
+
+    $payload = $this->createMock(PayloadInterface::class);
+
+    $client = $this->createMock(ClientInterface::class);
+    $client->expects(self::once())->method('fetchPayload')->with($secret)->willReturn($payload);
+
+    $sut = new WithClientAsClassMember($client, $secret);
+
+    self::assertSame($payload, $sut->fetchPayload());
+    self::assertSame($payload, $sut->fetchPayload());
+    self::assertSame($payload, $sut->fetchPayload());
+  }
+
+  public function testGetProject() : void {
+    $secret = $this->createMock(SecretInterface::class);
+    $secret->expects(self::once())->method('getProject')->willReturn('project');
+
+    $sut = new WithClientAsClassMember($this->createMock(ClientInterface::class), $secret);
+
+    self::assertSame('project', $sut->getProject());
+  }
+
+  public function test__toString() : void {
+    $secret = $this->createMock(SecretInterface::class);
+
+    $payload = $this->createMock(PayloadInterface::class);
+    $payload->expects(self::once())->method('getContent')->willReturn('content');
+
+    $client = $this->createMock(ClientInterface::class);
+    $client->expects(self::once())->method('fetchPayload')->with($secret)->willReturn($payload);
+
+    $sut = new WithClientAsClassMember($client, $secret);
+
+    self::assertSame('content', (string) $sut);
+  }
+}