merge

Author: kokspflanze

doc/README.md

@@ -20,6 +20,9 @@ APIs:
 * [Repositories](repos.md)
   * [Contents](repo/contents.md)
   * [Deployments](repo/deployments.md)
+  * [Projects](repo/projects.md)
+    * [Columns](repo/columns.md)
+      * [Cards](repo/cards.md)
   * [Releases](repo/releases.md)
     * [Assets](repo/assets.md)
   * [Stargazers](repo/stargazers.md)

doc/issue/comments.md

@@ -11,7 +11,7 @@ $comments = $client->api('issue')->comments()->all('KnpLabs', 'php-github-api',
 
 * `KnpLabs` : the owner of the repository
 * `php-github-api` : the name of the repository
-* `4` : the id of the issue
+* `4` : the issue number
 * You can select another page of comments using one more parameter (default: 1)
 
 Returns an array of comments.
@@ -41,7 +41,7 @@ $client->api('issue')->comments()->create('KnpLabs', 'php-github-api', 4, array(
 
 * `KnpLabs` : the owner of the repository
 * `php-github-api` : the name of the repository
-* `4` : the id of the issue
+* `4` : the issue number
 * You can set a `body` and optionally a `title`
 
 

doc/repo/cards.md

@@ -0,0 +1,53 @@
+## Repo / Cards API
+[Back to the "Repos API"](../repos.md) | [Back to the navigation](../README.md)
+
+This api is currently only available to developers in Early Access. To access the API during the Early Access period, 
+you must provide a custom media type in the Accept header.
+
+```php
+$client->api('repo')->projects()->columns()->cards()->configure();
+```
+
+### List all cards of a column
+
+```php
+$cards = $client->api('repo')->projects()->columns()->cards()->all('twbs', 'bootstrap', $columnId);
+```
+
+### List one card
+
+```php
+$card = $client->api('repo')->projects()->columns()->cards()->show('twbs', 'bootstrap', $cardId);
+```
+
+### Create a card
+
+> Requires [authentication](../security.md).
+
+```php
+$card = $client->api('repo')->projects()->columns()->cards()->create('twbs', 'bootstrap', $columnId, array('content_type' => 'Issue', 'content_id' => '452'));
+```
+
+### Edit a card
+
+> Requires [authentication](../security.md).
+
+```php
+$card = $client->api('repo')->project()->columns()->cards()->update('twbs', 'bootstrap', $cardId, array('note' => 'card note'));
+```
+
+### Remove a card
+
+> Requires [authentication](../security.md).
+
+```php
+$card = $client->api('repo')->projects()->columns()->cards()->deleteCard('twbs', 'bootstrap', $cardId);
+```
+
+### Move a card
+
+> Requires [authentication](../security.md).
+
+```php
+$card = $client->api('repo')->projects()->columns()->cards()->move('twbs', 'bootstrap', $cardId, array('position' => 'top));
+```

doc/repo/columns.md

@@ -0,0 +1,53 @@
+## Repo / Columns API
+[Back to the "Repos API"](../repos.md) | [Back to the navigation](../README.md)
+
+This api is currently only available to developers in Early Access. To access the API during the Early Access period, 
+you must provide a custom media type in the Accept header.
+
+```php
+$client->api('repo')->projects()->columns()->configure();
+```
+
+### List all columns of a project
+
+```php
+$columns = $client->api('repo')->projects()->columns()->all('twbs', 'bootstrap', $projectId);
+```
+
+### List one column
+
+```php
+$column = $client->api('repo')->projects()->columns()->show('twbs', 'bootstrap', $columnId);
+```
+
+### Create a column
+
+> Requires [authentication](../security.md).
+
+```php
+$column = $client->api('repo')->projects()->columns()->create('twbs', 'bootstrap', $projectId, array('name' => 'Column name'));
+```
+
+### Edit a column
+
+> Requires [authentication](../security.md).
+
+```php
+$column = $client->api('repo')->project()->columns()->update('twbs', 'bootstrap', $columnId, array('name' => 'New name'));
+```
+
+### Remove a column
+
+> Requires [authentication](../security.md).
+
+```php
+$column = $client->api('repo')->projects()->columns()->deleteColumn('twbs', 'bootstrap', $columnId);
+```
+
+### Move a column
+
+> Requires [authentication](../security.md).
+
+```php
+$column = $client->api('repo')->projects()->columns()->move('twbs', 'bootstrap', $columnId, array('position' => 'first));
+```

doc/repo/projects.md

@@ -0,0 +1,45 @@
+## Repo / Projects API
+[Back to the "Repos API"](../repos.md) | [Back to the navigation](../README.md)
+
+This api is currently only available to developers in Early Access. To access the API during the Early Access period, 
+you must provide a custom media type in the Accept header.
+
+```php
+$client->api('repo')->projects()->configure();
+```
+
+### List all projects
+
+```php
+$projects = $client->api('repo')->projects()->all('twbs', 'bootstrap');
+```
+
+### List one project
+
+```php
+$project = $client->api('repo')->projects()->show('twbs', 'bootstrap', $projectId);
+```
+
+### Create a project
+
+> Requires [authentication](../security.md).
+
+```php
+$project = $client->api('repo')->projects()->create('twbs', 'bootstrap', array('name' => 'Project name'));
+```
+
+### Edit a project
+
+> Requires [authentication](../security.md).
+
+```php
+$project = $client->api('repo')->project()->update('twbs', 'bootstrap', $projectId, array('name' => 'New name'));
+```
+
+### Remove a project
+
+> Requires [authentication](../security.md).
+
+```php
+$project = $client->api('repo')->projects()->deleteProject('twbs', 'bootstrap', $projectId);
+```

lib/Github/Api/AbstractApi.php

@@ -65,7 +65,7 @@ public function setPerPage($perPage)
      *
      * @return array|string
      */
-    protected function get($path, array $parameters = array(), $requestHeaders = array())
+    protected function get($path, array $parameters = array(), array $requestHeaders = array())
     {
         if (null !== $this->perPage && !isset($parameters['per_page'])) {
             $parameters['per_page'] = $this->perPage;
@@ -92,7 +92,7 @@ protected function get($path, array $parameters = array(), $requestHeaders = arr
      *
      * @return \Psr\Http\Message\ResponseInterface
      */
-    protected function head($path, array $parameters = array(), $requestHeaders = array())
+    protected function head($path, array $parameters = array(), array $requestHeaders = array())
     {
         if (array_key_exists('ref', $parameters) && is_null($parameters['ref'])) {
             unset($parameters['ref']);
@@ -109,8 +109,10 @@ protected function head($path, array $parameters = array(), $requestHeaders = ar
      * @param string $path           Request path.
      * @param array  $parameters     POST parameters to be JSON encoded.
      * @param array  $requestHeaders Request headers.
+     *
+     * @return array|string
      */
-    protected function post($path, array $parameters = array(), $requestHeaders = array())
+    protected function post($path, array $parameters = array(), array $requestHeaders = array())
     {
         return $this->postRaw(
             $path,
@@ -128,7 +130,7 @@ protected function post($path, array $parameters = array(), $requestHeaders = ar
      *
      * @return array|string
      */
-    protected function postRaw($path, $body, $requestHeaders = array())
+    protected function postRaw($path, $body, array $requestHeaders = array())
     {
         $response = $this->client->getHttpClient()->post(
             $path,
@@ -145,8 +147,10 @@ protected function postRaw($path, $body, $requestHeaders = array())
      * @param string $path           Request path.
      * @param array  $parameters     POST parameters to be JSON encoded.
      * @param array  $requestHeaders Request headers.
+     *
+     * @return array|string
      */
-    protected function patch($path, array $parameters = array(), $requestHeaders = array())
+    protected function patch($path, array $parameters = array(), array $requestHeaders = array())
     {
         $response = $this->client->getHttpClient()->patch(
             $path,
@@ -163,8 +167,10 @@ protected function patch($path, array $parameters = array(), $requestHeaders = a
      * @param string $path           Request path.
      * @param array  $parameters     POST parameters to be JSON encoded.
      * @param array  $requestHeaders Request headers.
+     *
+     * @return array|string
      */
-    protected function put($path, array $parameters = array(), $requestHeaders = array())
+    protected function put($path, array $parameters = array(), array $requestHeaders = array())
     {
         $response = $this->client->getHttpClient()->put(
             $path,
@@ -181,8 +187,10 @@ protected function put($path, array $parameters = array(), $requestHeaders = arr
      * @param string $path           Request path.
      * @param array  $parameters     POST parameters to be JSON encoded.
      * @param array  $requestHeaders Request headers.
+     *
+     * @return array|string
      */
-    protected function delete($path, array $parameters = array(), $requestHeaders = array())
+    protected function delete($path, array $parameters = array(), array $requestHeaders = array())
     {
         $response = $this->client->getHttpClient()->delete(
             $path,

lib/Github/Api/AcceptHeaderTrait.php

@@ -11,37 +11,37 @@ trait AcceptHeaderTrait
 {
     protected $acceptHeaderValue = null;
 
-    protected function get($path, array $parameters = array(), $requestHeaders = array())
+    protected function get($path, array $parameters = array(), array $requestHeaders = array())
     {
         return parent::get($path, $parameters, $this->mergeHeaders($requestHeaders));
     }
 
-    protected function head($path, array $parameters = array(), $requestHeaders = array())
+    protected function head($path, array $parameters = array(), array $requestHeaders = array())
     {
         return parent::head($path, $parameters, $this->mergeHeaders($requestHeaders));
     }
 
-    protected function post($path, array $parameters = array(), $requestHeaders = array())
+    protected function post($path, array $parameters = array(), array $requestHeaders = array())
     {
         return parent::post($path, $parameters, $this->mergeHeaders($requestHeaders));
     }
 
-    protected function postRaw($path, $body, $requestHeaders = array())
+    protected function postRaw($path, $body, array $requestHeaders = array())
     {
         return parent::postRaw($path, $body, $this->mergeHeaders($requestHeaders));
     }
 
-    protected function patch($path, array $parameters = array(), $requestHeaders = array())
+    protected function patch($path, array $parameters = array(), array $requestHeaders = array())
     {
         return parent::patch($path, $parameters, $this->mergeHeaders($requestHeaders));
     }
 
-    protected function put($path, array $parameters = array(), $requestHeaders = array())
+    protected function put($path, array $parameters = array(), array $requestHeaders = array())
     {
         return parent::put($path, $parameters, $this->mergeHeaders($requestHeaders));
     }
 
-    protected function delete($path, array $parameters = array(), $requestHeaders = array())
+    protected function delete($path, array $parameters = array(), array $requestHeaders = array())
     {
         return parent::delete($path, $parameters, $this->mergeHeaders($requestHeaders));
     }

lib/Github/Api/Repo.php

@@ -8,6 +8,7 @@
 use Github\Api\Repository\Contents;
 use Github\Api\Repository\DeployKeys;
 use Github\Api\Repository\Downloads;
+use Github\Api\Repository\Projects;
 use Github\Api\Repository\Releases;
 use Github\Api\Repository\Forks;
 use Github\Api\Repository\Hooks;
@@ -88,6 +89,36 @@ public function statistics($username, $repository)
         return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/stats/contributors');
     }
 
+    /**
+     * Get a weekly aggregate of the number of additions and deletions pushed to a repository.
+     *
+     * @link http://developer.github.com/v3/repos/statistics/#code-frequency
+     *
+     * @param string $username   the user who owns the repository
+     * @param string $repository the name of the repository
+     *
+     * @return array list of weeks and their commit statistics
+     */
+    public function frequency($username, $repository)
+    {
+        return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/stats/code_frequency');
+    }
+
+    /**
+     * Get the weekly commit count for the repository owner and everyone else.
+     *
+     * @link http://developer.github.com/v3/repos/statistics/#participation
+     *
+     * @param string $username   the user who owns the repository
+     * @param string $repository the name of the repository
+     *
+     * @return array list of weekly commit count grouped by 'all' and 'owner'
+     */
+    public function participation($username, $repository)
+    {
+        return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/stats/participation');
+    }
+
     /**
      * List all repositories for an organization.
      *
@@ -510,4 +541,9 @@ public function milestones($username, $repository)
     {
         return $this->get('/repos/'.rawurldecode($username).'/'.rawurldecode($repository).'/milestones');
     }
+
+    public function projects()
+    {
+        return new Projects($this->client);
+    }
 }