Add support custom properties

Author: ONyklicek

lib/Github/Api/Repo.php

@@ -15,6 +15,7 @@
 use Github\Api\Repository\Comments;
 use Github\Api\Repository\Commits;
 use Github\Api\Repository\Contents;
+use Github\Api\Repository\CustomProperties;
 use Github\Api\Repository\DeployKeys;
 use Github\Api\Repository\Downloads;
 use Github\Api\Repository\Forks;
@@ -523,6 +524,18 @@ public function statuses()
         return new Statuses($this->getClient());
     }
 
+    /**
+     * Manage the custom properties of a repository.
+     *
+     * @link https://docs.github.com/en/rest/repos/custom-properties
+     *
+     * @return CustomProperties
+     */
+    public function customProperties()
+    {
+        return new CustomProperties($this->getClient());
+    }
+
     /**
      * Get the branch(es) of a repository.
      *

lib/Github/Api/Repository/CustomProperties.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Github\Api\Repository;
+
+use Github\Api\AbstractApi;
+use Github\Exception\RuntimeException;
+
+/**
+ * @link   https://docs.github.com/en/rest/repos/custom-properties
+ *
+ * @author Ondřej Nyklíček <[email protected]>
+ */
+class CustomProperties extends AbstractApi
+{
+    /**
+     * @param string $owner The account owner of the repository.
+     * @param string $repository The name of the repository.
+     * @return array|string
+     */
+    public function all(string $owner, string $repository)
+    {
+        return $this->get('/repos/' . rawurlencode($owner)  . '/' . rawurlencode($repository) . '/properties/values');
+    }
+
+    /**
+     * @param string $owner The account owner of the repository.
+     * @param string $repository The name of the repository.
+     * @param string $propertyName The name of the property to retrieve.
+     * @return array
+     * @throws RuntimeException if the property is not found.
+     */
+    public function show(string $owner, string $repository, string $propertyName)
+    {
+        $allProperties = $this->all($owner, $repository);
+
+        if(!is_array($allProperties)) {
+            throw new RuntimeException('Unexpected response from GitHub API.');
+        }
+
+        foreach ($allProperties as $property => $value) {
+            if ($property === $propertyName) {
+                return ['property_name' => $property, 'value' => $value];
+            }
+        }
+
+        throw new RuntimeException("Property '{$propertyName}' not found.");
+    }
+
+    /**
+     * @param string $owner The account owner of the repository.
+     * @param string $repository The name of the repository.
+     * @param array<string, string|int> $params
+     * @return array|string
+     */
+    public function createOrUpdate(string $owner, string $repository, array $params)
+    {
+        return $this->patch('/repos/' . rawurlencode($owner) . '/' . rawurlencode($repository) . '/properties/values', $params);
+    }
+
+}

test/Github/Tests/Api/Repository/CustomPropertiesTest.php

@@ -0,0 +1,84 @@
+<?php
+
+namespace Github\Tests\Api\Repository;
+
+use Github\Api\Repository\CustomProperties;
+use Github\Tests\Api\TestCase;
+
+class CustomPropertiesTest extends TestCase
+{
+    public function testAll()
+    {
+        $expectedArray = ['property1' => 'value1', 'property2' => 'value2'];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/repos/owner/repo/properties/values')
+            ->willReturn($expectedArray);
+
+        $this->assertEquals($expectedArray, $api->all('owner', 'repo'));
+    }
+
+    public function testShowPropertyExists()
+    {
+        $allProperties = [
+            'property1' => 'value1',
+            'property2' => 'value2',
+        ];
+
+        $api = $this->getApiMock(CustomProperties::class);
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/repos/owner/repo/properties/values')
+            ->willReturn($allProperties);
+
+        $expectedResult = ['property_name' =>'property2', 'value' => 'value2'];
+        $this->assertEquals($expectedResult, $api->show('owner', 'repo', 'property2'));
+    }
+
+    public function testShowPropertyDoesNotExist()
+    {
+        $allProperties = [
+            'property1' => 'value1',
+            'property2' => 'value2',
+        ];
+
+        $api = $this->getApiMock(CustomProperties::class);
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/repos/owner/repo/properties/values')
+            ->willReturn($allProperties);
+
+        $this->expectException(\RuntimeException::class);
+        $this->expectExceptionMessage("Property 'property3' not found.");
+
+        $api->show('owner', 'repo', 'property3');
+    }
+
+    public function testCreateOrUpdate()
+    {
+        $params = [
+            'property1' => 'newValue1',
+            'property2' => 42,
+        ];
+
+        $expectedResponse = [
+            'property1' => 'newValue1',
+            'property2' => 42,
+        ];
+
+        $api = $this->getApiMock(CustomProperties::class);
+        $api->expects($this->once())
+            ->method('patch')
+            ->with('/repos/owner/repo/properties/values', $params)
+            ->willReturn($expectedResponse);
+
+        $this->assertEquals($expectedResponse, $api->createOrUpdate('owner', 'repo', $params));
+    }
+
+    protected function getApiClass()
+    {
+        return CustomProperties::class;
+    }
+}