From 16f6eec1c809bff5067ce452fb92b0507ca94cf8 Mon Sep 17 00:00:00 2001
From: Jozef Izso <jozef.izso@gmail.com>
Date: Tue, 18 Jul 2017 14:30:17 +0200
Subject: [PATCH] Implement GetLicenseContents() method for getting
 repository's license info

---
 .../Clients/IObservableRepositoriesClient.cs  | 21 +++++++++
 .../Clients/ObservableRepositoriesClient.cs   | 30 +++++++++++++
 Octokit/Clients/IRepositoriesClient.cs        | 21 +++++++++
 Octokit/Clients/RepositoriesClient.cs         | 31 +++++++++++++
 Octokit/Helpers/ApiUrls.cs                    | 21 +++++++++
 Octokit/Models/Response/RepositoryLicense.cs  | 44 +++++++++++++++++++
 6 files changed, 168 insertions(+)
 create mode 100644 Octokit/Models/Response/RepositoryLicense.cs

diff --git a/Octokit.Reactive/Clients/IObservableRepositoriesClient.cs b/Octokit.Reactive/Clients/IObservableRepositoriesClient.cs
index dae1ec2690..d0669870cd 100644
--- a/Octokit.Reactive/Clients/IObservableRepositoriesClient.cs
+++ b/Octokit.Reactive/Clients/IObservableRepositoriesClient.cs
@@ -422,6 +422,27 @@ public interface IObservableRepositoriesClient
         /// <returns>All of the repositories tags.</returns>
         IObservable<RepositoryTag> GetAllTags(long repositoryId, ApiOptions options);
 
+        /// <summary>
+        /// Get the contents of a repository's license
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://developer.github.com/v3/licenses/#get-the-contents-of-a-repositorys-license">API documentation</a> for more details
+        /// </remarks>
+        /// <param name="owner">The owner of the repository</param>
+        /// <param name="name">The name of the repository</param>
+        /// <returns>Returns the contents of the repository's license file, if one is detected.</returns>
+        IObservable<RepositoryLicense> GetLicenseContents(string owner, string name);
+
+        /// <summary>
+        /// Get the contents of a repository's license
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://developer.github.com/v3/licenses/#get-the-contents-of-a-repositorys-license">API documentation</a> for more details
+        /// </remarks>
+        /// <param name="repositoryId">The Id of the repository</param>
+        /// <returns>Returns the contents of the repository's license file, if one is detected.</returns>
+        IObservable<RepositoryLicense> GetLicenseContents(long repositoryId);
+
         /// <summary>
         /// Updates the specified repository with the values given in <paramref name="update"/>
         /// </summary>
diff --git a/Octokit.Reactive/Clients/ObservableRepositoriesClient.cs b/Octokit.Reactive/Clients/ObservableRepositoriesClient.cs
index aea66d3b8a..04f570f697 100644
--- a/Octokit.Reactive/Clients/ObservableRepositoriesClient.cs
+++ b/Octokit.Reactive/Clients/ObservableRepositoriesClient.cs
@@ -649,6 +649,36 @@ public IObservable<Repository> Edit(string owner, string name, RepositoryUpdate
             return _client.Edit(owner, name, update).ToObservable();
         }
 
+        /// <summary>
+        /// Get the contents of a repository's license
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://developer.github.com/v3/licenses/#get-the-contents-of-a-repositorys-license">API documentation</a> for more details
+        /// </remarks>
+        /// <param name="owner">The owner of the repository</param>
+        /// <param name="name">The name of the repository</param>
+        /// <returns>Returns the contents of the repository's license file, if one is detected.</returns>
+        public IObservable<RepositoryLicense> GetLicenseContents(string owner, string name)
+        {
+            Ensure.ArgumentNotNullOrEmptyString(owner, "owner");
+            Ensure.ArgumentNotNullOrEmptyString(name, "name");
+
+            return _client.GetLicenseContents(owner, name).ToObservable();
+        }
+
+        /// <summary>
+        /// Get the contents of a repository's license
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://developer.github.com/v3/licenses/#get-the-contents-of-a-repositorys-license">API documentation</a> for more details
+        /// </remarks>
+        /// <param name="repositoryId">The Id of the repository</param>
+        /// <returns>Returns the contents of the repository's license file, if one is detected.</returns>
+        public IObservable<RepositoryLicense> GetLicenseContents(long repositoryId)
+        {
+            return _client.GetLicenseContents(repositoryId).ToObservable();
+        }
+
         /// <summary>
         /// Updates the specified repository with the values given in <paramref name="update"/>
         /// </summary>
diff --git a/Octokit/Clients/IRepositoriesClient.cs b/Octokit/Clients/IRepositoriesClient.cs
index bab7c37ef9..0ce28e6c4f 100644
--- a/Octokit/Clients/IRepositoriesClient.cs
+++ b/Octokit/Clients/IRepositoriesClient.cs
@@ -527,6 +527,27 @@ public interface IRepositoriesClient
         /// <returns>All of the repositories tags.</returns>
         Task<IReadOnlyList<RepositoryTag>> GetAllTags(long repositoryId, ApiOptions options);
 
+        /// <summary>
+        /// Get the contents of a repository's license
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://developer.github.com/v3/licenses/#get-the-contents-of-a-repositorys-license">API documentation</a> for more details
+        /// </remarks>
+        /// <param name="owner">The owner of the repository</param>
+        /// <param name="name">The name of the repository</param>
+        /// <returns>Returns the contents of the repository's license file, if one is detected.</returns>
+        Task<RepositoryLicense> GetLicenseContents(string owner, string name);
+
+        /// <summary>
+        /// Get the contents of a repository's license
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://developer.github.com/v3/licenses/#get-the-contents-of-a-repositorys-license">API documentation</a> for more details
+        /// </remarks>
+        /// <param name="repositoryId">The Id of the repository</param>
+        /// <returns>Returns the contents of the repository's license file, if one is detected.</returns>
+        Task<RepositoryLicense> GetLicenseContents(long repositoryId);
+
         /// <summary>
         /// Updates the specified repository with the values given in <paramref name="update"/>
         /// </summary>
diff --git a/Octokit/Clients/RepositoriesClient.cs b/Octokit/Clients/RepositoriesClient.cs
index e7a9b044f4..a27999cc35 100644
--- a/Octokit/Clients/RepositoriesClient.cs
+++ b/Octokit/Clients/RepositoriesClient.cs
@@ -808,6 +808,37 @@ public Task<IReadOnlyList<RepositoryTag>> GetAllTags(long repositoryId, ApiOptio
             return ApiConnection.GetAll<RepositoryTag>(ApiUrls.RepositoryTags(repositoryId), options);
         }
 
+        /// <summary>
+        /// Get the contents of a repository's license
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://developer.github.com/v3/licenses/#get-the-contents-of-a-repositorys-license">API documentation</a> for more details
+        /// </remarks>
+        /// <param name="owner">The owner of the repository</param>
+        /// <param name="name">The name of the repository</param>
+        /// <returns>Returns the contents of the repository's license file, if one is detected.</returns>
+        public Task<RepositoryLicense> GetLicenseContents(string owner, string name)
+        {
+            Ensure.ArgumentNotNullOrEmptyString(owner, "owner");
+            Ensure.ArgumentNotNullOrEmptyString(name, "name");
+
+            return ApiConnection.Get<RepositoryLicense>(ApiUrls.RepositoryLicense(owner, name), null, AcceptHeaders.LicensesApiPreview);
+
+        }
+
+        /// <summary>
+        /// Get the contents of a repository's license
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://developer.github.com/v3/licenses/#get-the-contents-of-a-repositorys-license">API documentation</a> for more details
+        /// </remarks>
+        /// <param name="repositoryId">The Id of the repository</param>
+        /// <returns>Returns the contents of the repository's license file, if one is detected.</returns>
+        public Task<RepositoryLicense> GetLicenseContents(long repositoryId)
+        {
+            return ApiConnection.Get<RepositoryLicense>(ApiUrls.RepositoryLicense(repositoryId), null, AcceptHeaders.LicensesApiPreview);
+        }
+
         /// <summary>
         /// A client for GitHub's Repository Pages API.
         /// </summary>
diff --git a/Octokit/Helpers/ApiUrls.cs b/Octokit/Helpers/ApiUrls.cs
index 24120b3165..62cc4b065d 100644
--- a/Octokit/Helpers/ApiUrls.cs
+++ b/Octokit/Helpers/ApiUrls.cs
@@ -3699,5 +3699,26 @@ public static Uri ProjectCardMove(int id)
         {
             return "projects/columns/cards/{0}/moves".FormatUri(id);
         }
+
+        /// <summary>
+        /// Returns the <see cref="Uri"/> for repository's license requests.
+        /// </summary>
+        /// <param name="owner">The owner of repo</param>
+        /// <param name="repo">The name of repo</param>
+        /// <returns>The <see cref="Uri"/> for repository's license requests.</returns>
+        public static Uri RepositoryLicense(string owner, string repo)
+        {
+            return "repos/{0}/{1}/license".FormatUri(owner, repo);
+        }
+
+        /// <summary>
+        /// Returns the <see cref="Uri"/> for repository's license requests.
+        /// </summary>
+        /// <param name="repositoryId">The id of the repository</param>
+        /// <returns>The <see cref="Uri"/> for repository's license requests.</returns>
+        public static Uri RepositoryLicense(long repositoryId)
+        {
+            return "repositories/{0}/license".FormatUri(repositoryId);
+        }
     }
 }
diff --git a/Octokit/Models/Response/RepositoryLicense.cs b/Octokit/Models/Response/RepositoryLicense.cs
new file mode 100644
index 0000000000..8eb99519db
--- /dev/null
+++ b/Octokit/Models/Response/RepositoryLicense.cs
@@ -0,0 +1,44 @@
+using System.Diagnostics;
+using System.Globalization;
+
+namespace Octokit
+{
+    [DebuggerDisplay("{DebuggerDisplay,nq}")]
+    public class RepositoryLicense : LicenseMetadata
+    {
+        public RepositoryLicense(
+            string key,
+            string name,
+            string spdxId,
+            string url,
+            bool featured) : base(key, name, url)
+        {
+            Ensure.ArgumentNotNull(spdxId, "spdxId");
+
+            SpdxId = spdxId;
+            Featured = featured;
+        }
+
+        public RepositoryLicense()
+        {
+        }
+
+        /// <summary>
+        /// SPDX license identifier.
+        /// </summary>
+        public string SpdxId { get; protected set; }
+
+        /// <summary>
+        /// Whether the license is one of the licenses featured on https://choosealicense.com
+        /// </summary>
+        public bool Featured { get; protected set; }
+
+        internal override string DebuggerDisplay
+        {
+            get
+            {
+                return string.Format(CultureInfo.InvariantCulture, "{0} Featured: {1}", base.DebuggerDisplay, Featured);
+            }
+        }
+    }
+}