Create file thru Src api

The Repositories\Src Api had no option to create a file, the $params array holds the files that needs to be created. With the create method it's also possible to create branches.

ref: Merged in vkerkhoffpon/bitbucket-api/feature/create-files-thru-api (pull request #40)
closes #69

Author: vkerkhoffpon

docs/examples/repositories/src.md

@@ -6,8 +6,7 @@ title: Source
 
 # Source
 
-Allows you to browse directories and view files.
-*NOTE:* This is a read-only resource.
+Allows you to browse directories and view files, create branches and commit new files.
 
 ### Prepare:
 {% include auth.md var_name="src" class_ns="Repositories\Src" %}
@@ -24,6 +23,41 @@ $src->get($account_name, $repo_slug, '1e10ffe', 'app/models/');
 $src->raw($account_name, $repo_slug, '1e10ffe', 'app/models/core.php');
 ```
 
+### Create file in repository
+
+```php
+$params = array();
+$params['parent'] = 'master'; // Optional branch to commit to
+$params['/path-to-file'] = 'File content'; // Can be multiple files per commit
+$params['author'] = 'User <my@email.com>';
+$params['message'] = 'Commit message';
+
+$src->create($account_name, $repo_slug, $params);
+```
+
+### Delete file in repository
+
+```php
+$params = array();
+$params['parent'] = 'master'; // Optional branch to commit to
+$params['files'] = '/file-to-delete';
+$params['author'] = 'User <my@email.com>';
+$params['message'] = 'Commit message';
+
+$src->create($account_name, $repo_slug, $params);
+```
+
+### Create new branch in repository
+
+```php
+$params = array();
+$params['parent'] = 'master'; // Optional source branch
+$params['branch'] = 'new-branch-name';
+$params['author'] = 'User <my@email.com>';
+$params['message'] = 'Commit message';
+
+$src->create($account_name, $repo_slug, $params);
+```
 ----
 
 #### Related:

lib/Bitbucket/API/Repositories/Src.php

@@ -56,4 +56,34 @@ public function raw($account, $repo, $revision, $path)
             sprintf('repositories/%s/%s/raw/%s/%s', $account, $repo, $revision, $path)
         );
     }
+
+    /**
+     * Create file in repository
+     *      $params contains the files to create, the key is the file (with path) to create and the value is the
+     *      data that will be written to the file.
+     *      See https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/src#post
+     *      for details on what options are available
+     * @param $account
+     * @param $repo
+     * @param array $params
+     * @return MessageInterface
+     */
+    public function create($account, $repo, array $params = array())
+    {
+        $mandatory = array(
+            'author'   => '',
+            'message'  => '',
+        );
+
+        $diff = array_diff(array_keys($mandatory), array_keys($params));
+
+        if (count($diff) > 0) {
+            throw new \InvalidArgumentException('Missing parameters for creating new files.');
+        }
+
+        return $this->getClient()->setApiVersion('2.0')->post(
+            sprintf('repositories/%s/%s/src', $account, $repo),
+            $params
+        );
+    }
 }

test/Bitbucket/Tests/API/Repositories/SrcTest.php

@@ -40,4 +40,56 @@ public function testSrcGetRawContent()
 
         $this->assertEquals($expectedResult, $actual);
     }
+
+    /**
+     * @expectedException \InvalidArgumentException
+     */
+    public function testSrcCreateWithInvalidParams()
+    {
+        /** @var \Bitbucket\API\Repositories\Src $src */
+        $src   = $this->getApiMock('Bitbucket\API\Repositories\Src');
+
+        $src->create('gentle', 'eof', array());
+        $src->create('gentle', 'eof', array(3));
+    }
+
+    public function testSrcCreateFile()
+    {
+        $endpoint       = 'repositories/gentle/eof/src';
+        $params         = array(
+            '/testfile' => 'dummy',
+            'author' => 'Gentle <noreply@gentle.com>',
+            'message' => 'Test commit'
+        );
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('post')
+            ->with($endpoint, $params);
+
+        /** @var \Bitbucket\API\Repositories\Src $src */
+        $src   = $this->getClassMock('Bitbucket\API\Repositories\Src', $client);
+
+        $src->create('gentle', 'eof', $params);
+    }
+
+    public function testSrcCreateBranch()
+    {
+        $endpoint       = 'repositories/gentle/eof/src';
+        $params         = array(
+            'branch' => 'new-branch',
+            'author' => 'Gentle <noreply@gentle.com>',
+            'message' => 'Test create branch'
+        );
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('post')
+            ->with($endpoint, $params);
+
+        /** @var \Bitbucket\API\Repositories\Src $src */
+        $src   = $this->getClassMock('Bitbucket\API\Repositories\Src', $client);
+
+        $src->create('gentle', 'eof', $params);
+    }
 }