Add method to get protected branches for a project (#567)

Co-authored-by: Lee Boynton <[email protected]>

Author: lboynton

src/Api/Projects.php

@@ -1041,6 +1041,17 @@ public function updateBadge($project_id, int $badge_id, array $parameters = [])
         return $this->put($this->getProjectPath($project_id, 'badges/'.self::encodePath($badge_id)), $parameters);
     }
 
+    /**
+     * @param int|string $project_id
+     * @param array      $parameters
+     *
+     * @return mixed
+     */
+    public function protectedBranches($project_id, array $parameters = [])
+    {
+        return $this->get('projects/'.self::encodePath($project_id).'/protected_branches');
+    }
+
     /**
      * @param int|string $project_id
      * @param array      $parameters

tests/Api/ProjectsTest.php

@@ -2004,6 +2004,41 @@ public function shouldDeleteAllMergedBranches(): void
         $this->assertEquals($expectedBool, $api->deleteAllMergedBranches(1));
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetProtectedBranches(): void
+    {
+        $expectedArray = [
+            [
+                'id' => 1,
+                'name' => 'master',
+                'push_access_levels' => [
+                    'access_level' => 0,
+                    'access_level_description' => 'No one',
+                    'user_id' => null,
+                    'group_id' => null,
+                ],
+                'merge_access_levels' => [
+                    'access_level' => 40,
+                    'access_level_description' => 'Maintainers',
+                    'user_id' => null,
+                    'group_id' => null,
+                ],
+                'unprotect_access_levels' => [],
+                'code_owner_approval_required' => false,
+            ],
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('projects/1/protected_branches')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->protectedBranches(1));
+    }
+
     protected function getApiClass()
     {
         return Projects::class;