From 2991383f180afbcf5df590789d898cf4a297970d Mon Sep 17 00:00:00 2001
From: Daniel Seifert <git@daniel-seifert.com>
Date: Sun, 5 Jan 2025 14:56:05 +0100
Subject: [PATCH] add tests for field entity

---
 src/Entities/Field.php            |   2 +-
 tests/unit/Entities/FieldTest.php | 148 ++++++++++++++++++++++++++++++
 2 files changed, 149 insertions(+), 1 deletion(-)
 create mode 100644 tests/unit/Entities/FieldTest.php

diff --git a/src/Entities/Field.php b/src/Entities/Field.php
index 96c4fee..199c84f 100644
--- a/src/Entities/Field.php
+++ b/src/Entities/Field.php
@@ -36,7 +36,7 @@ class Field extends ArrayCollection
 
     public function getName(): string
     {
-        return $this->get(FieldEndpoint::NAME);
+        return $this->get(FieldEndpoint::NAME) ?? '';
     }
 
     public function setName(string $name): void
diff --git a/tests/unit/Entities/FieldTest.php b/tests/unit/Entities/FieldTest.php
new file mode 100644
index 0000000..f79bb3a
--- /dev/null
+++ b/tests/unit/Entities/FieldTest.php
@@ -0,0 +1,148 @@
+<?php
+
+/**
+ * Copyright (c) D3 Data Development (Inh. Thomas Dartsch)
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ *
+ * https://www.d3data.de
+ *
+ * @copyright (C) D3 Data Development (Inh. Thomas Dartsch)
+ * @author    D3 Data Development - Daniel Seifert <info@shopmodule.com>
+ * @link      https://www.oxidmodule.com
+ */
+
+namespace D3\KlicktippPhpClient\tests\unit\Entities;
+
+use D3\KlicktippPhpClient\Entities\Field;
+use D3\KlicktippPhpClient\Resources\Field as FieldEndpoint;
+use D3\KlicktippPhpClient\tests\TestCase;
+use Generator;
+use PHPUnit\Framework\MockObject\Rule\InvokedCount;
+use ReflectionException;
+
+/**
+ * @covers \D3\KlicktippPhpClient\Entities\Field
+ */
+class FieldTest extends TestCase
+{
+    public function setUp(): void
+    {
+        parent::setUp();
+        $this->entity = new Field(
+            [
+                FieldEndpoint::ID    => "155988456",
+                FieldEndpoint::NAME  => "fieldName",
+            ]
+        );
+    }
+
+    /**
+     * @test
+     * @throws ReflectionException
+     * @covers \D3\KlicktippPhpClient\Entities\Field::__construct
+     */
+    public function testConstruct(): void
+    {
+        $elements = [
+            'key1' => 'value1',
+            'key2' => 'value2',
+        ];
+
+        $endpoint = $this->getMockBuilder(FieldEndpoint::class)
+            ->disableOriginalConstructor()
+            ->getMock();
+
+        $sut = new Field($elements, $endpoint);
+
+        $this->assertSame(
+            $elements,
+            $sut->toArray()
+        );
+        $this->assertSame(
+            $endpoint,
+            $this->getValue($sut, 'endpoint')
+        );
+    }
+
+    /**
+     * @test
+     * @throws ReflectionException
+     * @covers \D3\KlicktippPhpClient\Entities\Field::getId
+     * @covers \D3\KlicktippPhpClient\Entities\Field::getName
+     * @dataProvider getSomethingDataProvider
+     */
+    public function testGetSomething(string $methodName, string $expectedValue)
+    {
+        $this->assertSame(
+            $expectedValue,
+            $this->callMethod($this->entity, $methodName)
+        );
+    }
+
+    public static function getSomethingDataProvider(): Generator
+    {
+        yield ['getId', '155988456'];
+        yield ['getName', 'fieldName'];
+    }
+
+    /**
+     * @test
+     * @throws ReflectionException
+     * @covers \D3\KlicktippPhpClient\Entities\Field::setName
+     */
+    public function testSetName(): void
+    {
+        $sut = $this->getMockBuilder(Field::class)
+            ->onlyMethods(['set'])
+            ->setConstructorArgs([[FieldEndpoint::ID => 'foo']])
+            ->getMock();
+        $sut->expects($this->once())->method('set')->with(
+            $this->identicalTo(FieldEndpoint::NAME)
+        );
+
+        $this->callMethod(
+            $sut,
+            'setName',
+            ['newValue']
+        );
+    }
+
+    /**
+     * @test
+     * @throws ReflectionException
+     * @covers \D3\KlicktippPhpClient\Entities\Field::persist
+     * @dataProvider persistDataProvider
+     */
+    public function testPersist(
+        bool $endpointSet,
+        InvokedCount $endpointInvocation,
+        ?bool $expectedReturn
+    ): void {
+        $endpointMock = $this->getMockBuilder(FieldEndpoint::class)
+            ->disableOriginalConstructor()
+            ->onlyMethods(['update'])
+            ->getMock();
+        $endpointMock->expects($endpointInvocation)->method('update')->willReturn(true);
+
+        $sut = new Field(
+            [FieldEndpoint::ID => 'foo', FieldEndpoint::NAME => 'name'],
+            $endpointSet ? $endpointMock : null
+        );
+
+        $this->assertSame(
+            $expectedReturn,
+            $this->callMethod(
+                $sut,
+                'persist'
+            )
+        );
+    }
+
+    public static function persistDataProvider(): Generator
+    {
+        yield 'has endpoint'    => [true, self::once(), true];
+        yield 'has no endpoint'    => [false, self::never(), null];
+    }
+}