[11.15] Repository branch and file check existence methods

src/Api/AbstractApi.php

@@ -232,6 +232,20 @@ protected function delete(string $uri, array $params = [], array $headers = [])
         return ResponseMediator::getContent($response);
     }
 
+    /**
+     * @param string               $uri
+     * @param array<string,mixed> $params
+     * @param array<string,string> $headers
+     *
+     * @return int
+     */
+    protected function head(string $uri, array $params, array $headers = []): int
+    {
+        $response = $this->client->getHttpClient()->head(self::prepareUri($uri, $params), $headers);
+
+        return $response->getStatusCode();
+    }
+
     /**
      * @param int|string $uri
      *

src/Api/Repositories.php

@@ -58,6 +58,19 @@ public function branch($project_id, string $branch)
         return $this->get($this->getProjectPath($project_id, 'repository/branches/'.self::encodePath($branch)));
     }
 
+    /**
+     * @param int|string $project_id
+     * @param string     $branch
+     *
+     * @return bool
+     */
+    public function branchExists($project_id, string $branch): bool
+    {
+        $uri = $this->getProjectPath($project_id, 'repository/branches/'.self::encodePath($branch));
+
+        return 200 === $this->head($uri, []);
+    }
+
     /**
      * @param int|string $project_id
      * @param string     $branch

src/Api/RepositoryFiles.php

@@ -146,4 +146,21 @@ public function deleteFile($project_id, array $parameters = [])
 
         return $this->delete($this->getProjectPath($project_id, 'repository/files/'.self::encodePath($resolved['file_path'])), $resolved);
     }
+
+    /**
+     * @param int|string $project_id
+     * @param string     $file_path
+     * @param string     $ref
+     *
+     * @return bool
+     */
+    public function fileExists($project_id, string $file_path, string $ref): bool
+    {
+        $uri = $this->getProjectPath($project_id, 'repository/files/'.self::encodePath($file_path));
+        $params = [
+            'ref' => $ref,
+        ];
+
+        return 200 === $this->head($uri, $params);
+    }
 }

tests/Api/RepositoriesTest.php

@@ -55,6 +55,21 @@ public function shouldGetBranch(): void
         $this->assertEquals($expectedArray, $api->branch(1, 'master'));
     }
 
+    /**
+     * @test
+     */
+    public function shouldBranchExists(): void
+    {
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('head')
+            ->with('projects/1/repository/branches/master', [])
+            ->will($this->returnValue(200))
+        ;
+
+        $this->assertTrue($api->branchExists(1, 'master'));
+    }
+
     /**
      * @test
      */

tests/Api/RepositoryFilesTest.php

@@ -280,6 +280,23 @@ public function shouldDeleteFileWithAuthor(): void
         ]));
     }
 
+    /**
+     * @test
+     */
+    public function shouldFileExists(): void
+    {
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('head')
+            ->with('projects/1/repository/files/dir%2Ffile1.txt', [
+                'ref' => 'master',
+            ])
+            ->will($this->returnValue(200))
+        ;
+
+        $this->assertTrue($api->fileExists(1, 'dir/file1.txt', 'master'));
+    }
+
     /**
      * @return string
      */