Added ConnectionClient (#141)

Co-authored-by: Igal Kreichman <igal1987@gmail.com>

Author: ReallyLiri

src/GitLabApiClient/ConnectionClient.cs

@@ -0,0 +1,37 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using GitLabApiClient.Internal.Http;
+
+namespace GitLabApiClient
+{
+    /// <summary>
+    /// Provides a client connection to make rest requests to HTTP endpoints.
+    /// <exception cref="GitLabException">Thrown if request to GitLab API does not indicate success</exception>
+    /// <exception cref="HttpRequestException">Thrown if request to GitLab API fails</exception>
+    /// </summary>
+    public sealed class ConnectionClient
+    {
+        private readonly GitLabHttpFacade _httpFacade;
+
+        internal ConnectionClient(
+            GitLabHttpFacade httpFacade
+        )
+        {
+            _httpFacade = httpFacade;
+        }
+
+        /// <summary>
+        /// Performs an asynchronous HTTP GET request.
+        /// </summary>
+        /// <param name="uri">URI endpoint to send request to</param>
+        public Task<T> GetAsync<T>(string uri)
+            => _httpFacade.Get<T>(uri);
+
+        /// <summary>
+        /// Performs an asynchronous HTTP paged GET request that iterates all pages.
+        /// </summary>
+        /// <param name="uri">URI endpoint to send request to</param>
+        public Task<IList<T>> GetPagedListAsync<T>(string uri)
+            => _httpFacade.GetPagedList<T>(uri);
+    }
+}

src/GitLabApiClient/GitLabClient.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Net.Http;
 using System.Threading.Tasks;
 using GitLabApiClient.Internal.Http;
 using GitLabApiClient.Internal.Http.Serialization;
@@ -23,7 +24,8 @@ public sealed class GitLabClient
         /// </summary>
         /// <param name="hostUrl">Host address of GitLab instance. For example https://gitlab.example.com or https://gitlab.example.com/api/v4/ </param>
         /// <param name="authenticationToken">Personal access token. Obtained from GitLab profile settings.</param>
-        public GitLabClient(string hostUrl, string authenticationToken = "")
+        /// <param name="httpMessageHandler">Optional handler for HTTP messages. Used for SSL pinning or canceling validation for example.</param>
+        public GitLabClient(string hostUrl, string authenticationToken = "", HttpMessageHandler httpMessageHandler = null)
         {
             Guard.NotEmpty(hostUrl, nameof(hostUrl));
             Guard.NotNull(authenticationToken, nameof(authenticationToken));
@@ -34,7 +36,8 @@ public GitLabClient(string hostUrl, string authenticationToken = "")
             _httpFacade = new GitLabHttpFacade(
                 HostUrl,
                 jsonSerializer,
-                authenticationToken);
+                authenticationToken,
+                httpMessageHandler);
 
             var projectQueryBuilder = new ProjectsQueryBuilder();
             var projectIssueNotesQueryBuilder = new ProjectIssueNotesQueryBuilder();
@@ -74,6 +77,7 @@ public GitLabClient(string hostUrl, string authenticationToken = "")
             Files = new FilesClient(_httpFacade);
             Runners = new RunnersClient(_httpFacade);
             ToDoList = new ToDoListClient(_httpFacade, toDoListBuilder);
+            Connection = new ConnectionClient(_httpFacade);
         }
 
         /// <summary>
@@ -161,6 +165,11 @@ public GitLabClient(string hostUrl, string authenticationToken = "")
         /// </summary>
         public ToDoListClient ToDoList { get; }
 
+        /// <summary>
+        /// Provides a client connection to make rest requests to HTTP endpoints.
+        /// </summary>
+        public ConnectionClient Connection { get; }
+
         /// <summary>
         /// Host address of GitLab instance. For example https://gitlab.example.com or https://gitlab.example.com/api/v4/.
         /// </summary>

src/GitLabApiClient/Internal/Http/GitLabHttpFacade.cs

@@ -21,15 +21,15 @@ internal sealed class GitLabHttpFacade
         private GitLabApiRequestor _requestor;
         private GitLabApiPagedRequestor _pagedRequestor;
 
-        private GitLabHttpFacade(string hostUrl, RequestsJsonSerializer jsonSerializer)
+        private GitLabHttpFacade(string hostUrl, RequestsJsonSerializer jsonSerializer, HttpMessageHandler httpMessageHandler)
         {
-            _httpClient = new HttpClient { BaseAddress = new Uri(hostUrl) };
+            _httpClient = new HttpClient(httpMessageHandler ?? new HttpClientHandler()) { BaseAddress = new Uri(hostUrl) };
 
             Setup(jsonSerializer);
         }
 
-        public GitLabHttpFacade(string hostUrl, RequestsJsonSerializer jsonSerializer, string authenticationToken = "") :
-            this(hostUrl, jsonSerializer)
+        public GitLabHttpFacade(string hostUrl, RequestsJsonSerializer jsonSerializer, string authenticationToken = "", HttpMessageHandler httpMessageHandler = null) :
+            this(hostUrl, jsonSerializer, httpMessageHandler)
         {
             switch (authenticationToken.Length)
             {