Merge branch 'master' into feature/deployment-branch-policies

Author: SergkeiM

.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
         strategy:
             fail-fast: false
             matrix:
-                php-versions: ['7.2', '7.3', '7.4', '8.0', '8.1']
+                php-versions: ['7.2', '7.3', '7.4', '8.0', '8.1', '8.2']
 
         steps:
             - uses: actions/checkout@v3

doc/README.md

@@ -39,6 +39,8 @@ v3 APIs:
 * [Organization](organization.md)
   * [Members](organization/members.md)
   * [Teams](organization/teams.md)
+  * [Secrets](organization/actions/secrets.md)
+  * [Variables](organization/actions/variables.md)
 * [Projects](project/projects.md)
   * [Columns](project/columns.md)
     * [Cards](project/cards.md)
@@ -51,6 +53,7 @@ v3 APIs:
   * Actions
     * [Artifacts](repo/actions/artifacts.md)
     * [Secrets](repo/actions/secrets.md)
+    * [Variables](repo/actions/variables.md)
     * [Self hosted runners](repo/actions/self_hosted_runners.md)
     * [Workflow jobs](repo/actions/workflow_jobs.md)
     * [Workflow runs](repo/actions/workflow_runs.md)
@@ -59,7 +62,9 @@ v3 APIs:
   * [Check Suites](repo/check_suites.md)
   * [Contents](repo/contents.md)
   * [Deployments](repo/deployments.md)
-  * [Policies](repo/policies.md)
+    * [Secrets](environment/secrets.md)
+    * [Variables](environment/variables.md)
+    * [Policies](repo/policies.md)
   * [Environments](repo/environments.md)
   * [Labels](repo/labels.md)
   * [Protection](repo/protection.md)

doc/environment/secrets.md

@@ -0,0 +1,46 @@
+## Environment / Secrets API
+[Back to the "Environments API"](../repo/environments.md) | [Back to the navigation](../README.md)
+
+### List environment secrets
+
+https://docs.github.com/en/rest/actions/secrets?apiVersion=2022-11-28
+
+```php
+$secrets = $client->environment()->secrets()->all($repoId, $envName);
+```
+
+### Get an environment secret
+
+https://docs.github.com/en/rest/actions/secrets?apiVersion=2022-11-28#get-an-environment-secret
+
+```php
+$secret = $client->environment()->secrets()->show($repoId, $envName, $secretName);
+```
+
+### Create or Update an environment secret
+
+https://docs.github.com/en/rest/actions/secrets?apiVersion=2022-11-28#create-or-update-an-environment-secret
+
+```php
+$client->environment()->secrets()->createOrUpdate($repoId, $envName, $secretName, [
+    'encrypted_value' => $encryptedValue,
+    'key_id' => $key_id
+]);
+```
+
+### Delete an environment secret
+
+https://docs.github.com/en/rest/reference/actions#delete-an-organization-secret
+
+```php
+$client->environment()->secrets()->remove($repoId, $envName, $secretName);
+```
+
+### Get an environment public key
+
+https://docs.github.com/en/rest/reference/actions#get-an-organization-public-key
+
+```php
+$client->environment()->secrets()->publicKey($repoId, $envName);
+```
+

doc/environment/variables.md

@@ -0,0 +1,49 @@
+## Environment / Variables API
+[Back to the "Environments API"](../repo/environments.md) | [Back to the navigation](../README.md)
+
+### List environment variables
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#list-environment-variables
+
+```php
+$variables = $client->environment()->variables()->all($repoId, $envName);
+```
+
+### Get an environment variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#get-an-environment-variable
+
+```php
+$variable = $client->environment()->variables()->show($repoId, $envName, $variableName);
+```
+
+### Create environment variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#create-an-environment-variable
+
+```php
+$client->environment()->variables()->create($repoId, $envName, [
+    'name' => $name,
+    'value' => $value
+]);
+```
+
+### Update environment variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#update-an-environment-variable
+
+```php
+$client->environment()->variables()->update($repoId, $envName, $variableName, [
+    'name' => $name,
+    'value' => $value
+]);
+```
+
+### Delete an environment variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#delete-an-environment-variable
+
+```php
+$client->environment()->variables()->remove($repoId, $envName, $variableName);
+```
+

doc/organization/actions/variables.md

@@ -0,0 +1,87 @@
+## Organization / Variables API
+[Back to the "Organization API"](../organization.md) | [Back to the navigation](../README.md)
+
+### List organization variables
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#list-organization-variables
+
+```php
+$variables = $client->organization()->variables()->all('KnpLabs');
+```
+
+### Get an organization variable
+
+https://docs.github.com/en/rest/reference/actions#get-an-organization-secret
+
+```php
+$variable = $client->organization()->variables()->show('KnpLabs', $variableName);
+```
+
+### Create an organization variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#create-an-organization-variable
+
+```php
+$client->organization()->variables()->create('KnpLabs', [
+    'name' => $name,
+    'value' => $value,
+    'visibility' => $visibility,
+    'selected_repository_ids' => $selectedRepositoryIds,
+]);
+```
+
+### Update an organization variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#update-an-organization-variable
+
+```php
+$client->organization()->variables()->update('KnpLabs', $variableName, [
+    'name' => $name,
+    'value' => $value,
+    'visibility' => $visibility,
+    'selected_repository_ids' => $selectedRepositoryIds
+]);
+```
+
+### Delete an organization variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#delete-an-organization-variable
+
+```php
+$client->organization()->variables()->remove('KnpLabs', $variableName);
+```
+
+### List selected repositories for organization variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#list-selected-repositories-for-an-organization-variable
+
+```php
+$client->organization()->variables()->selectedRepositories('KnpLabs', $variableName);
+```
+
+### Set selected repositories for an organization variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#set-selected-repositories-for-an-organization-variable
+
+```php
+$client->organization()->variables()->setSelectedRepositories('KnpLabs', 'variableName', [
+    'selected_repository_ids' => [1, 2, 3],
+]);
+```
+
+### Add selected repository to an organization variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#add-selected-repository-to-an-organization-variable
+
+```php
+$client->organization()->variables()->addRepository('KnpLabs', $repositoryId, $variableName);
+```
+
+### Remove selected repository from an organization variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#remove-selected-repository-from-an-organization-variable
+
+```php
+$client->organization()->variables()->removeRepository('KnpLabs', $repositoryId, $variableName);
+```
+

doc/repo/actions/variables.md

@@ -0,0 +1,48 @@
+## Repo / Actions / Variables API
+[Back to the "Repos API"](../../repos.md) | [Back to the navigation](../../README.md)
+
+### List repository variables
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#list-repository-variables
+
+```php
+$variables = $client->api('repo')->variables()->all('KnpLabs', 'php-github-api');
+```
+
+### Get a repository variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#get-a-repository-variable
+
+```php
+$variable = $client->api('repo')->variables()->show('KnpLabs', 'php-github-api', $variableName);
+```
+
+### Create a repository variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#create-a-repository-variable
+
+```php
+$client->api('repo')->variables()->create('KnpLabs', 'php-github-api', [
+    'name' => $name,
+    'value' => $value,
+]);
+```
+
+### Update a repository variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#update-a-repository-variable
+
+```php
+$client->api('repo')->variables()->update('KnpLabs', 'php-github-api', $variableName, [
+    'name' => $name,
+    'value' => $value,
+]);
+```
+
+### Delete a repository variable
+
+https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#delete-a-repository-variable
+
+```php
+$client->api('repo')->variables()->remove('KnpLabs', 'php-github-api', $variableName);
+```

doc/repo/environments.md

@@ -3,6 +3,10 @@
 
 Provides information about environments for a repository. Wraps [GitHub Environments API](https://docs.github.com/en/rest/deployments/environments?apiVersion=2022-11-28).
 
+Additional APIs:
+* [Secrets API](environment/secrets.md)
+* [Variables API](environment/variables.md)
+
 #### List all environments.
 
 ```php

lib/Github/Api/Deployment/Environments.php

@@ -4,6 +4,9 @@
 
 use Github\Api\AbstractApi;
 
+use Github\Api\Environment\Secrets;
+use Github\Api\Environment\Variables;
+
 /**
  * Listing, creating and updating environments.
  *
@@ -38,7 +41,7 @@ public function all($username, $repository, array $params = [])
      */
     public function show($username, $repository, $name)
     {
-        return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/environments/'.$name);
+        return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/environments/'.rawurlencode($name));
     }
 
     /**
@@ -55,7 +58,7 @@ public function show($username, $repository, $name)
      */
     public function createOrUpdate($username, $repository, $name, array $params = [])
     {
-        return $this->put('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/environments', $params);
+        return $this->put('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/environments/'.rawurlencode($name), $params);
     }
 
     /**
@@ -67,6 +70,22 @@ public function createOrUpdate($username, $repository, $name, array $params = []
      */
     public function remove(string $username, string $repository, string $name)
     {
-        return $this->delete('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/environments/'.$name);
+        return $this->delete('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/environments/'.rawurlencode($name));
+    }
+
+    /**
+     * @link https://docs.github.com/en/rest/actions/secrets?apiVersion=2022-11-28#about-secrets-in-github-actions
+     */
+    public function secrets(): Secrets
+    {
+        return new Secrets($this->getClient());
+    }
+
+    /**
+     * @link https://docs.github.com/en/rest/actions/variables?apiVersion=2022-11-28#about-variables-in-github-actions
+     */
+    public function variables(): Variables
+    {
+        return new Variables($this->getClient());
     }
 }