Merge pull request #117 from guillermoandrae/master

Added ability to pull a year's worth of commit activity for a repository

Author: cursedcoder

doc/repos.md

@@ -230,3 +230,11 @@ To include non GitHub users, add a third parameter to true:
 ```php
 $contributors = $client->api('repo')->contributors('ornicar', 'php-github-api', true);
 ```
+
+### Get the commit activity of a repository
+
+```php
+$activity = $client->api('repo')->activity('ornicar', 'php-github-api');
+```
+
+Returns an array of commit activity group by week.

lib/Github/Api/Repo.php

@@ -39,19 +39,33 @@ public function find($keyword, array $params = array())
     }
 
     /**
-     * Get contributor commit statistics for a repository
-     * @link http://developer.github.com/v3/repos/statistics/#contributors
+     * Get the last year of commit activity for a repository grouped by week
+     * @link http://developer.github.com/v3/repos/statistics/#commit-activity
      * 
      * @param string $username   the user who owns the repository
      * @param string $repository the name of the repository
      * 
-     * @return array list of contributors and their commit statistics
+     * @return array commit activity grouped by week
      */
-    public function statistics($username, $repository)
+    public function activity($username, $repository)
     {
-	    return $this->get('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/stats/contributors');
+	    return $this->get('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/stats/commit_activity');
     }
 
+	/**
+	 * Get contributor commit statistics for a repository
+	 * @link http://developer.github.com/v3/repos/statistics/#contributors
+	 *
+	 * @param string $username   the user who owns the repository
+	 * @param string $repository the name of the repository
+	 *
+	 * @return array list of contributors and their commit statistics
+	 */
+	public function statistics($username, $repository)
+	{
+		return $this->get('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/stats/contributors');
+	}
+
     /**
      * List all repositories for an organization
      * @link http://developer.github.com/v3/repos/#list-organization-repositories

test/Github/Tests/Api/RepoTest.php

@@ -417,6 +417,22 @@ public function shouldGetReleasesApiObject()
         $this->assertInstanceOf('Github\Api\Repository\Releases', $api->releases());
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetCommitActivity()
+    {
+	$expectedArray = array(array('days' => array(0, 3, 26, 20, 39, 1, 0), 'total' => 89, 'week' => 1336280400));
+
+	$api = $this->getApiMock();
+	$api->expects($this->once())
+	    ->method('get')
+	    ->with('repos/KnpLabs/php-github-api/stats/commit_activity')
+	    ->will($this->returnValue($expectedArray));
+
+	$this->assertEquals($expectedArray, $api->activity('KnpLabs', 'php-github-api'));
+    }
+
     protected function getApiClass()
     {
         return 'Github\Api\Repo';