Feature/protected branches (#40)

* Added Branch response

* Added Request for creating a branch

* Renamed CreateBranch class to CreateBranchRequest

* Added Guard to constructor

* Added DeleteBranchRequest class

* Added DeleteMergedBranchesRequest

* Made DeleteMergedBranchesRequest public sealed

* Added BranchQueryOptions class

* Added BranchQueryBuilder

* Updated classname for CreateBranchRequest

* Changed CreateBranchRequest Property 'Id' to 'ProjectId'

* Changed property names for DeleteBranchRequest class

* Changed property names for DeleteMergedBranchesRequest class

* Added BranchClient

* Fixed tests

* Fixed XML cref warning

* Added models for protected branches

* Added ProtectBranchRequest

* Extended BranchClient class to protect/unprotect branches

* Fixed tests - syntax errors

Author: dnagl

src/GitLabApiClient/BranchClient.cs

@@ -43,5 +43,16 @@ public async Task DeleteBranch(DeleteBranchRequest request) =>
         public async Task DeleteMergedBranches(DeleteMergedBranchesRequest request) =>
             await _httpFacade.Delete($"projects/{request.ProjectId}/repository/merged_branches");
 
+        public async Task<ProtectedBranch> GetProtectedBranchesAsync(string projectId, string branchName) =>
+            await _httpFacade.Get<ProtectedBranch>($"projects/{projectId}/protected_branches/{branchName}");
+
+        public async Task<IList<ProtectedBranch>> GetProtectedBranchesAsync(string projectId) =>
+            await _httpFacade.GetPagedList<ProtectedBranch>($"projects/{projectId}/protected_branches");
+
+        public async Task<ProtectedBranch> ProtectBranchAsync(ProtectBranchRequest request) =>
+            await _httpFacade.Post<ProtectedBranch>($"projects/{request.ProjectId}/protected_branches", request);
+
+        public async Task UnprotectBranchAsync(string projectId, string branchName) =>
+            await _httpFacade.Delete($"projects/{projectId}/protected_branches/{branchName}");
     }
 }

src/GitLabApiClient/Models/Branches/Requests/ProtectBranchRequest.cs

@@ -0,0 +1,69 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using GitLabApiClient.Internal.Utilities;
+using GitLabApiClient.Models.Branches.Responses;
+using Newtonsoft.Json;
+
+namespace GitLabApiClient.Models.Branches.Requests
+{
+    /// <summary>
+    /// Protects a branch.
+    /// </summary>
+    public sealed class ProtectBranchRequest
+    {
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ProtectBranchRequest"/> class.
+        /// </summary>
+        /// <param name="projectId">ID or URL-Encoded path of the project.</param>
+        /// <param name="name">The name of the branch or wildcard.</param>
+        /// <param name="pushAccessLevel">Access levels allowed to push.</param>
+        /// <param name="mergeAccessLevel">Access levels allowed to merge.</param>
+        /// <param name="unprotectAccessLevel">Access levels allowed to unprotect.</param>
+        public ProtectBranchRequest(
+            string projectId, 
+            string name, 
+            ProtectedRefAccessLevels? pushAccessLevel = ProtectedRefAccessLevels.MAINTAINER_ACCESS, 
+            ProtectedRefAccessLevels? mergeAccessLevel = ProtectedRefAccessLevels.MAINTAINER_ACCESS, 
+            ProtectedRefAccessLevels? unprotectAccessLevel = ProtectedRefAccessLevels.MAINTAINER_ACCESS)
+        {
+            Guard.NotEmpty(projectId, nameof(projectId));
+            Guard.NotEmpty(name, nameof(name));
+
+            PushAccessLevel = pushAccessLevel.ToString();
+            MergeAccessLevel = mergeAccessLevel.ToString();
+            UnprotectAccessLevel = unprotectAccessLevel.ToString();
+        }
+
+        /// <summary>
+        /// Id or URL-Encoded path of the project.
+        /// </summary>
+        [JsonProperty("id")]
+        public string ProjectId { get; set; }
+
+        /// <summary>
+        /// The name of the branch or wildcard.
+        /// </summary>
+        [JsonProperty("name")]
+        public string Name { get; set; }
+
+        /// <summary>
+        /// Access levels allowed to push (defaults: 40, maintainer access level).
+        /// </summary>
+        [JsonProperty("push_access_level")]
+        public string PushAccessLevel { get; set; }
+
+        /// <summary>
+        /// Access levels allowed to merge (defaults: 40, maintainer access level).
+        /// </summary>
+        [JsonProperty("merge_access_level")]
+        public string MergeAccessLevel { get; set; }
+
+        /// <summary>
+        /// Access levels allowed to unprotect (defaults: 40, maintainer access level).
+        /// </summary>
+        [JsonProperty("unprotect_access_level")]
+        public string UnprotectAccessLevel { get; set; }
+    }
+}

src/GitLabApiClient/Models/Branches/Responses/ProtectedBranch.cs

@@ -0,0 +1,19 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using Newtonsoft.Json;
+
+namespace GitLabApiClient.Models.Branches.Responses
+{
+    public sealed class ProtectedBranch
+    {
+        [JsonProperty("name")]
+        public string Name { get; set; }
+
+        [JsonProperty("push_access_levels")]
+        public PushAccessLevel[] PushAccessLevels { get; set; }
+
+        [JsonProperty("merge_access_levels")]
+        public PushAccessLevel[] MergeAccessLevels { get; set; }
+    }
+}

src/GitLabApiClient/Models/Branches/Responses/ProtectedRefAccessLevels.cs

@@ -0,0 +1,14 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace GitLabApiClient.Models.Branches.Responses
+{
+    public enum ProtectedRefAccessLevels
+    {
+        NO_ACCESS = 0,
+        DEVELOPER_ACCESS = 30,
+        MAINTAINER_ACCESS = 40,
+        ADMIN_ACCESS = 60
+    }
+}

src/GitLabApiClient/Models/Branches/Responses/PushAccessLevel.cs

@@ -0,0 +1,16 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using Newtonsoft.Json;
+
+namespace GitLabApiClient.Models.Branches.Responses
+{
+    public sealed class PushAccessLevel
+    {
+        [JsonProperty("access_level")]
+        public ProtectedRefAccessLevels AccessLevel { get; set; }
+
+        [JsonProperty("access_level_description")]
+        public string AccessLevelDescription { get; set; }
+    }
+}