Merge branch 'release/0.3.0'

Author: vimishor

docs/Home.md

@@ -10,15 +10,15 @@ A simple PHP wrapper for Bitbucket API.
 * [Group privileges](group-privileges.md)
 * [Invitations](invitations.md)
 * [Privileges](privileges.md)
-* [Repositories](repositories.md)
+* [Repositories](repositories.md) (API 2.0)
     * [Changesets](repositories/changesets.md)
     * [Deploykeys](repositories/deploykeys.md)
     * [Events](repositories/events.md)
     * [Followers](repositories/followers.md)
     * [Issues](repositories/issues.md)
     * [Links](repositories/links.md)
-    * [PullRequests](repositories/pullrequests.md)
-    * [Repository](repositories/repository.md)
+    * [PullRequests](repositories/pullrequests.md) (API 2.0)
+    * [Repository](repositories/repository.md) (API 2.0)
     * [Services](repositories/services.md)
     * [Src](repositories/src.md)
     * [Wiki](repositories/wiki.md)
@@ -31,3 +31,7 @@ A simple PHP wrapper for Bitbucket API.
     * [OAuth](users/oauth.md)
     * [Privileges](users/privileges.md)
     * [SSH Keys](users/ssh-keys.md)
+
+### Legend:
+
+- API 2.0 = Contains methods that can be used against Bitbucket API v2.0

docs/repositories.md

@@ -3,6 +3,27 @@
 ----
 The repositories namespace has a number of resources you can use to manage repository. The following resources are available on repositories:
 
+### Prepare:
+```php
+$repositories = new Bitbucket\API\Repositories();
+$repositories->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
+```
+
+### Get a list of repositories for an account: (API 2.0)
+
+If the caller is properly authenticated and authorized, this method returns a collection containing public and private repositories.
+```php
+$repositories->all($account_name);
+```
+
+### Get a list of all public repositories: (API 2.0)
+
+Only public repositories are returned.
+```php
+$repositories->all();
+```
+
+* [Commit(s)](repositories/commits.md) (API 2.0)
 * [Changesets](repositories/changesets.md)
 * [Deploykeys](repositories/deploykeys.md)
 * [Events](repositories/events.md)

docs/repositories/commits.md

@@ -0,0 +1,44 @@
+## Commits
+
+----
+Retrieve and compare information about commits.
+
+### Prepare:
+```php
+$commits = new Bitbucket\API\Repositories\PullRequests();
+$commits->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
+```
+
+### Get all commits for a repository: (API 2.0)
+```php
+$commits->all($account_name, $repo_slug);
+```
+
+### Get all commits for a single branch: (API 2.0)
+```php
+$commits->all($account_name, $repo_slug, array(
+    'branch' => 'master' // this can also be a tag
+));
+```
+
+### Get an individual commit: (API 2.0)
+```php
+$commits->get($account_name, $repo_slug, $commitSHA1);
+```
+
+### Approve a commit: (API 2.0)
+```php
+$commits->approve($account_name, $repo_slug, $commitSHA1);
+```
+
+### Delete a commit approval: (API 2.0)
+```php
+$commits->deleteApproval($account_name, $repo_slug, $commitSHA1);
+```
+
+----
+
+#### Related:
+  * [Authentication](../authentication.md)
+  * [Commit(s) comments](commits/comments.md)
+  * [BB Wiki](https://confluence.atlassian.com/x/doA7Fw)

docs/repositories/commits/comments.md

@@ -0,0 +1,26 @@
+## Commits comments
+
+---
+Manage commits comments.
+
+### Prepare:
+```php
+$commit = new Bitbucket\API\Repositories\Commits();
+$commit->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
+```
+
+### Get a list of a commit comments: (API 2.0)
+```php
+$commit->comments()->all($account_name, $repo_slug, $commitSHA1)
+```
+
+### Get an individual commit comment: (API 2.0)
+```php
+$commit->comments()->get($account_name, $repo_slug, $commitSHA1, $commentID)
+```
+
+----
+
+#### Related:
+  * [Authentication](../../authentication.md)
+  * [Commit(s)](../commits.md)

docs/repositories/pullrequests.md

@@ -9,38 +9,98 @@ $pull = new Bitbucket\API\Repositories\PullRequests();
 $pull->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
 ```
 
-### Get a list of a pull request comments:
+### Get all pull requests: (API 2.0)
 ```php
-$pull->comments()->all($account_name, $repo_slug, 1)
+$pull->all($account_name, $repo_slug);
 ```
 
-### Get an individual pull request comment:
+### Get all merged pull requests: (API 2.0)
 ```php
-$pull->comments()->get($account_name, $repo_slug, 1, 2)
+$pull->all($account_name, $repo_slug, array('state' => 'merged'));
 ```
 
-### Add a new comment:
+### Create a new pull request: (API 2.0)
 ```php
-$pull->comments()->create($account_name, $repo_slug, 41, "dummy content");
+$pull->create('gentle', 'secret-repo', array(
+    'title'         => 'Test PR',
+    'description'   => 'Fixed readme',
+    'source'        => array(
+        'branch'    => array(
+            'name'  => 'quickfix-1'
+        ),
+        'repository' => array(
+            'full_name' => 'vimishor/secret-repo'
+        )
+    ),
+    'destination'   => array(
+        'branch'    => array(
+            'name'  => 'master'
+        )
+    )
+));
 ```
 
-### Update an existing comment:
+### Update a pull request: (API 2.0)
 ```php
-$pull->comments()->update($account_name, $repo_slug, 41, 4, "dummy content [edited]");
+$pull->update('gentle', 'secret-repo', 1, array(
+    'title'         => 'Test PR (updated)',
+    'destination'   => array(
+        'branch'    => array(
+            'name'  => 'master'
+        )
+    ),
+));
 ```
 
-### Delete a pull request comment
+### Get a specific pull request: (API 2.0)
 ```php
-$pull->comments()->delete($account_name, $repo_slug, 41, 4);
+$pull->get($account_name, $repo_slug, 1);
 ```
 
-### Get all pull requests
+### Get the commits for a pull request: (API 2.0)
 ```php
-$pull->all($account_name, $repo_slug);
+$pull->commits($account_name, $repo_slug, 1);
+```
+
+### Approve a pull request: (API 2.0)
+```php
+$pull->approve($account_name, $repo_slug, 1);
+```
+
+### Delete a a pull request approval: (API 2.0)
+```php
+$pull->delete($account_name, $repo_slug, 1);
+```
+
+### Get the diff for a pull request: (API 2.0)
+```php
+$pull->diff($account_name, $repo_slug, 1);
+```
+
+### Get the log of a pull request activity: (API 2.0)
+If pull request ID is omitted, the entire repository's pull request activity is returned.
+
+```php
+$pull->activity($account_name, $repo_slug, 1);
+```
+
+### Accept and merge a pull request: (API 2.0)
+```php
+$pull->accept($account_name, $repo_slug, 1, array(
+    'message' => 'This message will be used for merge commit.'
+));
+```
+
+### Decline a pull request: (API 2.0)
+```php
+$pull->accept($account_name, $repo_slug, 1, array(
+    'message' => 'Please update the docs to reflect new changes.'
+));
 ```
 
 ----
 
 #### Related:
   * [Authentication](../authentication.md)
+  * [PullRequests comments](pullrequests/comments.md)
   * [BB Wiki](https://confluence.atlassian.com/display/BITBUCKET/pullrequests+Resource#pullrequestsResource-Overview)

docs/repositories/pullrequests/comments.md

@@ -0,0 +1,35 @@
+## Pull requests comments
+
+---
+Manage pull requests comments.
+
+### Prepare:
+```php
+$pull = new Bitbucket\API\Repositories\PullRequests();
+$pull->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
+```
+
+### Get a list of a pull request comments:
+```php
+$pull->comments()->all($account_name, $repo_slug, 1)
+```
+
+### Get an individual pull request comment:
+```php
+$pull->comments()->get($account_name, $repo_slug, 1, 2)
+```
+
+### Add a new comment:
+```php
+$pull->comments()->create($account_name, $repo_slug, 41, "dummy content");
+```
+
+### Update an existing comment:
+```php
+$pull->comments()->update($account_name, $repo_slug, 41, 4, "dummy content [edited]");
+```
+
+### Delete a pull request comment
+```php
+$pull->comments()->delete($account_name, $repo_slug, 41, 4);
+```

docs/repositories/repository.md

@@ -9,7 +9,14 @@ $repo = new Bitbucket\API\Repositories\Repository();
 $repo->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
 ```
 
-### Create a new repository:
+### Get information associated with an individual repository: (API 2.0)
+```php
+$repo->get($account_name, $repo_slug);
+```
+
+### Create a new repository: (API 1.0)
+**NOTE:** API 1.0 endpoint for repository creation has been deprecated, so please use the new API 2.0 endpoint described bellow.
+
 ```php
 $repo->create($repo_slug, array(
     'description'   => 'My super secret project.',
@@ -18,6 +25,17 @@ $repo->create($repo_slug, array(
 ));
 ```
 
+### Create a new repository: (API 2.0)
+```php
+$repo->create($account_name, $repo_slug, array(
+    'scm'               => 'git',
+    'description'       => 'My super secret project.',
+    'language'          => 'php',
+    'is_private'        => true,
+    'forking_policy'    => 'no_public_forks',
+));
+```
+
 ### Update an existing repository:
 ```php
 $repo->update($account_name, $repo_slug, array(
@@ -27,11 +45,21 @@ $repo->update($account_name, $repo_slug, array(
 ));
 ```
 
-### Delete a repository:
+### Delete a repository: (API 2.0)
 ```php
 $repo->delete($account_name, $repo_slug);
 ```
 
+### Get the list of accounts watching a repository: (API 2.0)
+```php
+$repo->watchers($account_name, $repo_slug);
+```
+
+### Get the list of repository forks: (API 2.0)
+```php
+$repo->forks($account_name, $repo_slug);
+```
+
 ### Fork a repository:
 ```php
 $repo->fork($account_name, $repo_slug, $fork_slug, array(