Add RepositoryFiles api endpoint

lib/Gitlab/Api/Repositories.php

@@ -309,9 +309,9 @@ public function tree($project_id, array $params = array())
      */
     public function blob($project_id, $sha, $filepath)
     {
-        return $this->get($this->getProjectPath($project_id, 'repository/files/'.$this->encodePath($filepath).'/raw'), array(
-            'ref' => $sha,
-        ));
+        @trigger_error(sprintf('The %s() method is deprecated since version 9.2 and will be removed in 10.0. Use the %s::getRawFile() method instead.', __METHOD__, RepositoryFiles::class), E_USER_DEPRECATED);
+
+        return $this->client->repositoryFiles()->getRawFile($project_id, $filepath, $sha);
     }
 
     /**
@@ -322,9 +322,9 @@ public function blob($project_id, $sha, $filepath)
      */
     public function getFile($project_id, $file_path, $ref)
     {
-        return $this->get($this->getProjectPath($project_id, 'repository/files/'.$this->encodePath($file_path)), array(
-            'ref' => $ref
-        ));
+        @trigger_error(sprintf('The %s() method is deprecated since version 9.2 and will be removed in 10.0. Use the %s::getFile() method instead.', __METHOD__, RepositoryFiles::class), E_USER_DEPRECATED);
+
+        return $this->client->repositoryFiles()->getFile($project_id, $file_path, $ref);
     }
 
     /**
@@ -340,15 +340,17 @@ public function getFile($project_id, $file_path, $ref)
      */
     public function createFile($project_id, $file_path, $content, $branch, $commit_message, $encoding = null, $author_email = null, $author_name = null)
     {
-        return $this->post($this->getProjectPath($project_id, 'repository/files'), array(
+        @trigger_error(sprintf('The %s() method is deprecated since version 9.2 and will be removed in 10.0. Use the %s::createFile() method instead.', __METHOD__, RepositoryFiles::class), E_USER_DEPRECATED);
+
+        return $this->client->repositoryFiles()->createFile($project_id, [
             'file_path' => $file_path,
             'branch' => $branch,
             'content' => $content,
             'commit_message' => $commit_message,
             'encoding' => $encoding,
             'author_email' => $author_email,
             'author_name' => $author_name,
-        ));
+        ]);
     }
 
     /**
@@ -364,15 +366,17 @@ public function createFile($project_id, $file_path, $content, $branch, $commit_m
      */
     public function updateFile($project_id, $file_path, $content, $branch, $commit_message, $encoding = null, $author_email = null, $author_name = null)
     {
-        return $this->put($this->getProjectPath($project_id, 'repository/files'), array(
+        @trigger_error(sprintf('The %s() method is deprecated since version 9.2 and will be removed in 10.0. Use the %s::updateFile() method instead.', __METHOD__, RepositoryFiles::class), E_USER_DEPRECATED);
+
+        return $this->client->repositoryFiles()->updateFile($project_id, [
             'file_path' => $file_path,
             'branch' => $branch,
             'content' => $content,
             'commit_message' => $commit_message,
             'encoding' => $encoding,
             'author_email' => $author_email,
             'author_name' => $author_name,
-        ));
+        ]);
     }
 
     /**
@@ -386,13 +390,15 @@ public function updateFile($project_id, $file_path, $content, $branch, $commit_m
      */
     public function deleteFile($project_id, $file_path, $branch, $commit_message, $author_email = null, $author_name = null)
     {
-        return $this->delete($this->getProjectPath($project_id, 'repository/files'), array(
+        @trigger_error(sprintf('The %s() method is deprecated since version 9.2 and will be removed in 10.0. Use the %s::deleteFile() method instead.', __METHOD__, RepositoryFiles::class), E_USER_DEPRECATED);
+
+        return $this->client->repositoryFiles()->deleteFile($project_id, [
             'file_path' => $file_path,
             'branch' => $branch,
             'commit_message' => $commit_message,
             'author_email' => $author_email,
             'author_name' => $author_name,
-        ));
+        ]);
     }
 
     /**

lib/Gitlab/Api/RepositoryFiles.php

@@ -0,0 +1,135 @@
+<?php
+
+namespace Gitlab\Api;
+
+use Symfony\Component\OptionsResolver\OptionsResolver;
+
+class RepositoryFiles extends AbstractApi
+{
+    /**
+     * @param int $project_id
+     * @param string $file_path
+     * @param string $ref
+     * @return mixed
+     */
+    public function getFile($project_id, $file_path, $ref)
+    {
+        return $this->get($this->getProjectPath($project_id, 'repository/files/'.$this->encodePath($file_path)), array(
+            'ref' => $ref
+        ));
+    }
+
+    /**
+     * @param int $project_id
+     * @param string $file_path
+     * @param string $ref
+     * @return mixed
+     */
+    public function getRawFile($project_id, $file_path, $ref)
+    {
+        return $this->get($this->getProjectPath($project_id, 'repository/files/'.$this->encodePath($file_path).'/raw'), array(
+            'ref' => $ref,
+        ));
+    }
+
+    /**
+     * @param int   $project_id
+     * @param array $parameters (
+     *
+     *     @var string $file_path      Url encoded full path to new file. Ex. lib%2Fclass%2Erb.
+     *     @var string $branch         Name of the branch.
+     *     @var string $start_branch   Name of the branch to start the new commit from.
+     *     @var string $encoding       Change encoding to 'base64'. Default is text.
+     *     @var string $author_email   Specify the commit author's email address.
+     *     @var string $author_name    Specify the commit author's name.
+     *     @var string $content        File content.
+     *     @var string $commit_message Commit message.
+     * )
+     *
+     * @return mixed
+     */
+    public function createFile($project_id, array $parameters = [])
+    {
+        $resolver = new OptionsResolver();
+        $resolver->setRequired('file_path');
+        $resolver->setRequired('branch');
+        $resolver->setDefined('start_branch');
+        $resolver->setDefined('encoding')
+            ->setAllowedValues('encoding', ['text', 'base64'])
+        ;
+        $resolver->setDefined('author_email');
+        $resolver->setDefined('author_name');
+        $resolver->setRequired('content');
+        $resolver->setRequired('commit_message');
+
+        $resolved = $resolver->resolve($parameters);
+
+        return $this->post($this->getProjectPath($project_id, 'repository/files/'.$this->encodePath($resolved['file_path'])), $resolved);
+    }
+
+    /**
+     * @param int   $project_id
+     * @param array $parameters (
+     *
+     *     @var string $file_path      Url encoded full path to new file. Ex. lib%2Fclass%2Erb.
+     *     @var string $branch         Name of the branch.
+     *     @var string $start_branch   Name of the branch to start the new commit from.
+     *     @var string $encoding       Change encoding to 'base64'. Default is text.
+     *     @var string $author_email   Specify the commit author's email address.
+     *     @var string $author_name    Specify the commit author's name.
+     *     @var string $content        File content.
+     *     @var string $commit_message Commit message.
+     *     @var string $last_commit_id Last known file commit id.
+     * )
+     *
+     * @return mixed
+     */
+    public function updateFile($project_id, array $parameters = [])
+    {
+        $resolver = new OptionsResolver();
+        $resolver->setRequired('file_path');
+        $resolver->setRequired('branch');
+        $resolver->setDefined('start_branch');
+        $resolver->setDefined('encoding')
+            ->setAllowedValues('encoding', ['text', 'base64'])
+        ;
+        $resolver->setDefined('author_email');
+        $resolver->setDefined('author_name');
+        $resolver->setRequired('content');
+        $resolver->setRequired('commit_message');
+        $resolver->setDefined('last_commit_id');
+
+        $resolved = $resolver->resolve($parameters);
+
+        return $this->put($this->getProjectPath($project_id, 'repository/files/'.$this->encodePath($resolved['file_path'])), $resolved);
+    }
+
+    /**
+     * @param int   $project_id
+     * @param array $parameters (
+     *
+     *     @var string $file_path      Url encoded full path to new file. Ex. lib%2Fclass%2Erb.
+     *     @var string $branch         Name of the branch.
+     *     @var string $start_branch   Name of the branch to start the new commit from.
+     *     @var string $author_email   Specify the commit author's email address.
+     *     @var string $author_name    Specify the commit author's name.
+     *     @var string $commit_message Commit message.
+     * )
+     *
+     * @return mixed
+     */
+    public function deleteFile($project_id, array $parameters = [])
+    {
+        $resolver = new OptionsResolver();
+        $resolver->setRequired('file_path');
+        $resolver->setRequired('branch');
+        $resolver->setDefined('start_branch');
+        $resolver->setDefined('author_email');
+        $resolver->setDefined('author_name');
+        $resolver->setRequired('commit_message');
+
+        $resolved = $resolver->resolve($parameters);
+
+        return $this->delete($this->getProjectPath($project_id, 'repository/files/'.$this->encodePath($resolved['file_path'])), $resolved);
+    }
+}

lib/Gitlab/Client.php

@@ -197,6 +197,14 @@ public function repositories()
         return new Api\Repositories($this);
     }
 
+    /**
+     * @return Api\RepositoryFiles
+     */
+    public function repositoryFiles()
+    {
+        return new Api\RepositoryFiles($this);
+    }
+
     /**
      * @return Api\Snippets
      */

lib/Gitlab/Model/Project.php

@@ -582,7 +582,22 @@ public function getFile($sha, $filepath)
      */
     public function createFile($file_path, $content, $branch_name, $commit_message, $author_email = null, $author_name = null)
     {
-        $data = $this->client->repositories()->createFile($this->id, $file_path, $content, $branch_name, $commit_message, null, $author_email, $author_name);
+        $parameters = [
+            'file_path' => $file_path,
+            'branch' => $branch_name,
+            'content' => $content,
+            'commit_message' => $commit_message,
+        ];
+
+        if ($author_email !== null) {
+            $parameters['author_email'] = $author_email;
+        }
+
+        if ($author_name !== null) {
+            $parameters['author_name'] = $author_name;
+        }
+
+        $data = $this->client->repositoryFiles()->createFile($this->id, $parameters);
 
         return File::fromArray($this->getClient(), $this, $data);
     }
@@ -598,7 +613,22 @@ public function createFile($file_path, $content, $branch_name, $commit_message,
      */
     public function updateFile($file_path, $content, $branch_name, $commit_message, $author_email = null, $author_name = null)
     {
-        $data = $this->client->repositories()->updateFile($this->id, $file_path, $content, $branch_name, $commit_message, null, $author_email, $author_name);
+        $parameters = [
+            'file_path' => $file_path,
+            'branch' => $branch_name,
+            'content' => $content,
+            'commit_message' => $commit_message,
+        ];
+
+        if ($author_email !== null) {
+            $parameters['author_email'] = $author_email;
+        }
+
+        if ($author_name !== null) {
+            $parameters['author_name'] = $author_name;
+        }
+
+        $data = $this->client->repositoryFiles()->updateFile($this->id, $parameters);
 
         return File::fromArray($this->getClient(), $this, $data);
     }
@@ -613,7 +643,21 @@ public function updateFile($file_path, $content, $branch_name, $commit_message,
      */
     public function deleteFile($file_path, $branch_name, $commit_message, $author_email = null, $author_name = null)
     {
-        $this->client->repositories()->deleteFile($this->id, $file_path, $branch_name, $commit_message, $author_email, $author_name);
+        $parameters = [
+            'file_path' => $file_path,
+            'branch' => $branch_name,
+            'commit_message' => $commit_message,
+        ];
+
+        if ($author_email !== null) {
+            $parameters['author_email'] = $author_email;
+        }
+
+        if ($author_name !== null) {
+            $parameters['author_name'] = $author_name;
+        }
+
+        $this->client->repositoryFiles()->deleteFile($this->id, $parameters);
 
         return true;
     }