Adding API endpoints to interact with custom properties

Author: ONyklicek

doc/repo/custom_properties.md

@@ -0,0 +1,28 @@
+## Repo / Custom Properties API
+[Back to the "Repos API"](../repos.md) | [Back to the navigation](../README.md)
+
+For extended info see the [GitHub documentation](https://docs.github.com/en/rest/reference/repos#custom-properties-for-a-repository)
+
+### List custom properties for a repository
+
+```php
+$properties = $client->api('repo')->properties()->all('twbs', 'bootstrap');
+```
+
+### Get a custom property for a repository
+
+```php
+$property = $client->api('repo')->properties()->show('twbs', 'bootstrap', $propertyName);
+```
+
+
+### Update a custom property for a repository
+
+```php
+$parameters = [
+    'property_name' => 'foo',
+    'value' => 'bar'
+]
+
+$property = $client->api('repo')->properties()->update('twbs', 'bootstrap', $params);
+```

lib/Github/Api/Repository/CustomProperties.php

@@ -29,7 +29,7 @@ public function all(string $owner, string $repository)
      * @return array
      * @throws RuntimeException if the property is not found.
      */
-    public function show(string $owner, string $repository, string $propertyName)
+    public function show(string $owner, string $repository, string $propertyName): array
     {
         $allProperties = $this->all($owner, $repository);
 
@@ -43,18 +43,17 @@ public function show(string $owner, string $repository, string $propertyName)
             }
         }
 
-        throw new RuntimeException("Property '{$propertyName}' not found.");
+        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
+     * @param array<string, mixed> $params
      * @return array|string
      */
-    public function createOrUpdate(string $owner, string $repository, array $params)
+    public function update(string $owner, string $repository, array $params)
     {
         return $this->patch('/repos/' . rawurlencode($owner) . '/' . rawurlencode($repository) . '/properties/values', $params);
     }
-
 }

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

@@ -27,7 +27,7 @@ public function testShowPropertyExists()
             'property2' => 'value2',
         ];
 
-        $api = $this->getApiMock(CustomProperties::class);
+        $api = $this->getApiMock();
         $api->expects($this->once())
             ->method('get')
             ->with('/repos/owner/repo/properties/values')
@@ -44,19 +44,19 @@ public function testShowPropertyDoesNotExist()
             'property2' => 'value2',
         ];
 
-        $api = $this->getApiMock(CustomProperties::class);
+        $api = $this->getApiMock();
         $api->expects($this->once())
             ->method('get')
             ->with('/repos/owner/repo/properties/values')
             ->willReturn($allProperties);
 
         $this->expectException(\RuntimeException::class);
-        $this->expectExceptionMessage("Property 'property3' not found.");
+        $this->expectExceptionMessage("Property [property3] not found.");
 
         $api->show('owner', 'repo', 'property3');
     }
 
-    public function testCreateOrUpdate()
+    public function testUpdate()
     {
         $params = [
             'property1' => 'newValue1',
@@ -68,13 +68,13 @@ public function testCreateOrUpdate()
             'property2' => 42,
         ];
 
-        $api = $this->getApiMock(CustomProperties::class);
+        $api = $this->getApiMock();
         $api->expects($this->once())
             ->method('patch')
             ->with('/repos/owner/repo/properties/values', $params)
             ->willReturn($expectedResponse);
 
-        $this->assertEquals($expectedResponse, $api->createOrUpdate('owner', 'repo', $params));
+        $this->assertEquals($expectedResponse, $api->update('owner', 'repo', $params));
     }
 
     protected function getApiClass()