Support for Tags (#42)

* Added Tag model

* Added query options for tags

* Added CreateTagRequest

* Added DeleteTagRequest class

* Fixed typo in classname and filename for TagQueryOptions

* Added TagQueryBuilder

* Added TagClient

* Fixed URL in GetAsync()

* Extended query options for tags

* Extended query builder for new properties

Author: dnagl

src/GitLabApiClient/Internal/Queries/TagQueryBuilder.cs

@@ -0,0 +1,22 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using GitLabApiClient.Models.Tags.Requests;
+
+namespace GitLabApiClient.Internal.Queries
+{
+    internal class TagQueryBuilder : QueryBuilder<TagQueryOptions>
+    {
+        protected override void BuildCore(TagQueryOptions options)
+        {
+            if (!string.IsNullOrEmpty(options.ProjectId))
+                Add("id", options.ProjectId);
+
+            if (!string.IsNullOrEmpty(options.Search))
+                Add("search", options.Search);
+
+            Add("order_by", options.OrderBy.ToString().ToLower());
+            Add("sort", options.Sort.ToString().ToLower());
+        }
+    }
+}

src/GitLabApiClient/Models/Tags/Requests/CreateTagRequest.cs

@@ -0,0 +1,65 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using GitLabApiClient.Internal.Utilities;
+using Newtonsoft.Json;
+
+namespace GitLabApiClient.Models.Tags.Requests
+{
+    /// <summary>
+    /// Used to create a tag in a project.
+    /// </summary>
+    public sealed class CreateTagRequest
+    {
+        /// <summary>
+        /// The ID or URL-encoded path of the project.
+        /// </summary>
+        [JsonProperty("id")]
+        public string ProjectId { get; set; }
+
+        /// <summary>
+        /// Name for the created tag
+        /// </summary>
+        [JsonProperty("tag_name")]
+        public string TagName { get; set; }
+
+        /// <summary>
+        /// Tag reference.
+        /// </summary>
+        [JsonProperty("ref")]
+        public string Reference { get; set; }
+
+        /// <summary>
+        /// Annotated message.
+        /// </summary>
+        [JsonProperty("message")]
+        public string Message { get; set; }
+
+        /// <summary>
+        /// Release notes.
+        /// </summary>
+        [JsonProperty("release_description")]
+        public string ReleaseDescription { get; set; }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="CreateTagRequest"/> class.
+        /// </summary>
+        /// <param name="projectId">The ID or URL-encoded path of the project.</param>
+        /// <param name="tagName">The name of the tag the release correspons to.</param>
+        /// <param name="reference">Commit SHA, another tag name, or branh name.</param>
+        /// <param name="message">Annotated message</param>
+        /// <param name="releaseDescription">Release notes</param>
+        public CreateTagRequest(string projectId, string tagName, string reference, string message, string releaseDescription)
+        {
+            Guard.NotEmpty(projectId, nameof(projectId));
+            Guard.NotEmpty(tagName, nameof(tagName));
+            Guard.NotEmpty(reference, nameof(reference));
+
+            ProjectId = projectId;
+            TagName = tagName;
+            Reference = reference;
+            Message = message;
+            ReleaseDescription = releaseDescription;
+        }
+    }
+}

src/GitLabApiClient/Models/Tags/Requests/DeleteTagRequest.cs

@@ -0,0 +1,37 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using GitLabApiClient.Internal.Utilities;
+
+namespace GitLabApiClient.Models.Tags.Requests
+{
+    /// <summary>
+    /// Used to delete a tag in a project
+    /// </summary>
+    public sealed class DeleteTagRequest
+    {
+        /// <summary>
+        /// ID or URL-encoded path of the project
+        /// </summary>
+        public string ProjectId { get; set; }
+
+        /// <summary>
+        /// Name of the Tag
+        /// </summary>
+        public string TagName { get; set; }
+
+        /// <summary>
+        /// Initializes a instance of the <see cref="DeleteTagRequest"/> class.
+        /// </summary>
+        /// <param name="projectId"></param>
+        /// <param name="tagName"></param>
+        public DeleteTagRequest(string projectId, string tagName)
+        {
+            Guard.NotEmpty(projectId, nameof(projectId));
+            Guard.NotEmpty(tagName, nameof(tagName));
+
+            ProjectId = projectId;
+            TagName = tagName;
+        }
+    }
+}

src/GitLabApiClient/Models/Tags/Requests/TagOrder.cs

@@ -0,0 +1,12 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace GitLabApiClient.Models.Tags.Requests
+{
+    public enum TagOrder
+    {
+        NAME,
+        UPDATED
+    }
+}

src/GitLabApiClient/Models/Tags/Requests/TagQueryOptions.cs

@@ -0,0 +1,16 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace GitLabApiClient.Models.Tags.Requests
+{
+    public sealed class TagQueryOptions
+    {
+        public string ProjectId { get; set; }
+        public string Search { get; set; }
+        public TagOrder OrderBy { get; set; } = TagOrder.NAME;
+        public TagSort Sort { get; set; } = TagSort.DESC;
+
+        internal TagQueryOptions(string projectId = null) => ProjectId = projectId;
+    }
+}

src/GitLabApiClient/Models/Tags/Requests/TagSort.cs

@@ -0,0 +1,12 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace GitLabApiClient.Models.Tags.Requests
+{
+    public enum TagSort
+    {
+        ASC,
+        DESC
+    }
+}

src/GitLabApiClient/Models/Tags/Responses/Tag.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using GitLabApiClient.Models.Releases.Responses;
+using Newtonsoft.Json;
+
+namespace GitLabApiClient.Models.Tags.Responses
+{
+    public sealed class Tag
+    {
+        [JsonProperty("commit")]
+        public Commit Commit { get; set; }
+
+        [JsonProperty("release")]
+        public Release Release { get; set; }
+
+        [JsonProperty("name")]
+        public string Name { get; set; }
+
+        [JsonProperty("target")]
+        public string Target { get; set; }
+
+        [JsonProperty("message")]
+        public string Message { get; set; }
+
+    }
+}

src/GitLabApiClient/TagClient.cs

@@ -0,0 +1,44 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using System.Threading.Tasks;
+using GitLabApiClient.Internal.Http;
+using GitLabApiClient.Internal.Queries;
+using GitLabApiClient.Models.Tags.Requests;
+using GitLabApiClient.Models.Tags.Responses;
+
+namespace GitLabApiClient
+{
+    public sealed class TagClient
+    {
+        private readonly GitLabHttpFacade _httpFacade;
+        private readonly TagQueryBuilder _tagQueryBuilder;
+
+        internal TagClient(
+            GitLabHttpFacade httpFacade,
+            TagQueryBuilder tagQueryBuilder)
+        {
+            _httpFacade = httpFacade;
+            _tagQueryBuilder = tagQueryBuilder;
+        }
+
+        public async Task<Tag> GetAsync(string projectId, string tagName) =>
+            await _httpFacade.Get<Tag>($"projects/{projectId}/repository/tags/{tagName}");
+
+        public async Task<IList<Tag>> GetAsync(string projectId, Action<TagQueryOptions> options)
+        {
+            var queryOptions = new TagQueryOptions(projectId);
+            options?.Invoke(queryOptions);
+
+            string url = _tagQueryBuilder.Build($"projects/{projectId}/tags", queryOptions);
+            return await _httpFacade.GetPagedList<Tag>(url);
+        }
+
+        public async Task<Tag> CreateAsync(CreateTagRequest request) =>
+            await _httpFacade.Post<Tag>($"projects/{request.ProjectId}/repository/tags", request);
+
+        public async Task DeleteAsync(DeleteTagRequest request) =>
+            await _httpFacade.Delete($"projects/{request.ProjectId}/repository/tags/{request.TagName}");
+
+    }
+}