[feature] list, create and force sync remote mirrors for a project

src/GitLabApiClient/IProjectsClient.cs

@@ -213,5 +213,30 @@ public interface IProjectsClient
         /// <param name="projectId">The ID, path or <see cref="Project"/> of the project.</param>
         /// <returns>Status of the import</returns>
         Task<ImportStatus> GetImportStatusAsync(ProjectId projectId);
+
+        /// <summary>
+        /// Gets the remote mirrors for a project.
+        /// </summary>
+        /// <param name="projectId">The project identifier.</param>
+        /// <returns>List of remote mirrors</returns>
+        Task<IList<RemoteMirror>> GetRemoteMirrorsAsync(ProjectId projectId);
+
+        /// <summary>
+        /// Creates a remote mirror in a project.
+        /// </summary>
+        /// <param name="projectId">The project identifier.</param>
+        /// <param name="request">The request <see cref="CreateRemoteMirrorRequest"/>.</param>
+        /// <returns>An instance of <see cref="RemoteMirror"/></returns>
+
+        Task<RemoteMirror> CreateRemoteMirrorAsync(ProjectId projectId, CreateRemoteMirrorRequest request);
+
+        /// <summary>
+        /// Forces the mirror to sync.
+        /// </summary>
+        /// <param name="projectId">The project identifier.</param>
+        /// <param name="mirrorId">The mirror identifier.</param>
+
+        Task ForceSyncMirrorAsync(ProjectId projectId, int mirrorId);
+
     }
 }

src/GitLabApiClient/Internal/Paths/ProjectId.cs

@@ -15,15 +15,9 @@ public class ProjectId
         /// </summary>
         /// <param name="projectPath">The project path ie. 'group/project'</param>
         /// <returns></returns>
-        public static implicit operator ProjectId(string projectPath)
-        {
-            return new ProjectId(projectPath.UrlEncode());
-        }
+        public static implicit operator ProjectId(string projectPath) => new ProjectId(projectPath.UrlEncode());
 
-        public static implicit operator ProjectId(int projectId)
-        {
-            return new ProjectId(projectId.ToString());
-        }
+        public static implicit operator ProjectId(int projectId) => new ProjectId(projectId.ToString());
 
         public static implicit operator ProjectId(Project project)
         {

src/GitLabApiClient/Models/Projects/Requests/CreateRemoteMirrorRequest.cs

@@ -0,0 +1,29 @@
+using Newtonsoft.Json;
+
+namespace GitLabApiClient.Models.Projects.Requests
+{
+    public class CreateRemoteMirrorRequest
+    {
+
+        [JsonProperty("url", NullValueHandling = NullValueHandling.Ignore)]
+        public string Url { get; set; }
+
+        [JsonProperty("enabled", NullValueHandling = NullValueHandling.Ignore)]
+        public bool? Enabled { get; set; }
+
+        /// <summary>
+        /// Gets or sets the authentication method.
+        /// </summary>
+        /// <value>
+        /// ssh_public_key or password
+        /// </value>
+        [JsonProperty("auth_method", NullValueHandling = NullValueHandling.Ignore)]
+        public string AuthMethod { get; set; }
+
+        [JsonProperty("only_protected_branches", NullValueHandling = NullValueHandling.Ignore)]
+        public bool? OnlyProtectedBranches { get; set; }
+
+        [JsonProperty("keep_divergent_refs", NullValueHandling = NullValueHandling.Ignore)]
+        public bool? KeepDivergentRefs { get; set; }
+    }
+}

src/GitLabApiClient/Models/Projects/Requests/TransferProjectRequest.cs

@@ -1,3 +1,4 @@
+using System;
 using Newtonsoft.Json;
 
 namespace GitLabApiClient.Models.Projects.Requests

src/GitLabApiClient/Models/Projects/Responses/ImportStatus.cs

@@ -1,3 +1,4 @@
+using System;
 using Newtonsoft.Json;
 
 namespace GitLabApiClient.Models.Projects.Responses
@@ -28,4 +29,5 @@ public sealed class ImportStatus
         [JsonProperty("import_status")]
         public ImportStatusEnum Status { get; set; }
     }
+
 }

src/GitLabApiClient/Models/Projects/Responses/RemoteMirror.cs

@@ -0,0 +1,41 @@
+using System;
+using Newtonsoft.Json;
+
+namespace GitLabApiClient.Models.Projects.Responses
+{
+    public class RemoteMirror
+    {
+        [JsonProperty("enabled", NullValueHandling = NullValueHandling.Ignore)]
+        public bool? Enabled { get; set; }
+
+        [JsonProperty("id", NullValueHandling = NullValueHandling.Ignore)]
+        public int? Id { get; set; }
+
+        [JsonProperty("auth_method", NullValueHandling = NullValueHandling.Ignore)]
+        public string AuthMethod { get; set; }
+
+        [JsonProperty("last_error", NullValueHandling = NullValueHandling.Ignore)]
+        public object LastError { get; set; }
+
+        [JsonProperty("last_successful_update_at", NullValueHandling = NullValueHandling.Ignore)]
+        public DateTime? LastSuccessfulUpdateAt { get; set; }
+
+        [JsonProperty("last_update_at", NullValueHandling = NullValueHandling.Ignore)]
+        public DateTime? LastUpdateAt { get; set; }
+
+        [JsonProperty("last_update_started_at", NullValueHandling = NullValueHandling.Ignore)]
+        public DateTime? LastUpdateStartedAt { get; set; }
+
+        [JsonProperty("only_protected_branches", NullValueHandling = NullValueHandling.Ignore)]
+        public bool? OnlyProtectedBranches { get; set; }
+
+        [JsonProperty("keep_divergent_refs", NullValueHandling = NullValueHandling.Ignore)]
+        public bool? KeepDivergentRefs { get; set; }
+
+        [JsonProperty("update_status", NullValueHandling = NullValueHandling.Ignore)]
+        public string UpdateStatus { get; set; }
+
+        [JsonProperty("url", NullValueHandling = NullValueHandling.Ignore)]
+        public string Url { get; set; }
+    }
+}

src/GitLabApiClient/ProjectsClient.cs

@@ -106,7 +106,7 @@ public async Task<IList<Job>> GetJobsAsync(ProjectId projectId, Action<JobQueryO
             var queryOptions = new JobQueryOptions();
             options?.Invoke(queryOptions);
 
-            var url = _jobQueryBuilder.Build($"projects/{projectId}/jobs", queryOptions);
+            string url = _jobQueryBuilder.Build($"projects/{projectId}/jobs", queryOptions);
             return await _httpFacade.GetPagedList<Job>(url);
         }
 
@@ -335,5 +335,33 @@ public async Task<ImportStatus> GetImportStatusAsync(ProjectId projectId)
         {
             return await _httpFacade.Get<ImportStatus>($"projects/{projectId}/import");
         }
+
+        /// <summary>
+        /// Gets the remote mirrors for a project.
+        /// </summary>
+        /// <param name="projectId">The project identifier.</param>
+        /// <returns>List of remote mirrors</returns>
+        public async Task<IList<RemoteMirror>> GetRemoteMirrorsAsync(ProjectId projectId)
+        {
+            return await _httpFacade.Get<IList<RemoteMirror>>($"projects/{projectId}/remote_mirrors");
+        }
+
+        /// <summary>
+        /// Creates a remote mirror in a project.
+        /// </summary>
+        /// <param name="projectId">The project identifier.</param>
+        /// <param name="request">The request <see cref="CreateRemoteMirrorRequest"/>.</param>
+        /// <returns></returns>
+        public async Task<RemoteMirror> CreateRemoteMirrorAsync(ProjectId projectId, CreateRemoteMirrorRequest request)
+        {
+            return await _httpFacade.Post<RemoteMirror>($"projects/{projectId}/remote_mirrors", request);
+        }
+
+        /// <summary>
+        /// Forces the mirror to sync.
+        /// </summary>
+        /// <param name="projectId">The project identifier.</param>
+        /// <param name="mirrorId">The mirror identifier.</param>
+        public async Task ForceSyncMirrorAsync(ProjectId projectId, int mirrorId) => await _httpFacade.Post($"projects/{projectId}/remote_mirrors/{mirrorId}/sync");
     }
 }