Implement User Emails API

Octokit.Tests.Integration/Clients/UsersClientTests.cs

@@ -117,4 +117,23 @@ public async Task RetrievesEmailsForUser()
             Assert.True(email.Primary);
         }
     }
+
+    public class TheAddEmailsToCurrentMethod
+    {
+        [IntegrationTest]
+        public async Task CanAddEmailsToUser()
+        {
+            var github = new GitHubClient(new ProductHeaderValue("OctokitTests"))
+            {
+                Credentials = Helper.Credentials
+            };
+
+            var emailToAdd = string.Format("test_{0}@example.com", System.Guid.NewGuid());
+
+            await github.User.AddEmailsToCurrent(emailToAdd);
+            var emails = await github.User.GetEmails();
+
+            Assert.True(emails.Where(e => e.Email == emailToAdd).Any());
+        }
+    }
 }

Octokit.Tests/Clients/UsersClientTests.cs

@@ -105,5 +105,31 @@ public void SendsUpdateToCorrectUrl()
                 client.Received().GetAll<EmailAddress>(endpoint, null);
             }
         }
+
+        public class TheAddEmailsToCurrentMethod
+        {
+            [Fact]
+            public void ShouldThrowIfProvidedListIsEmpty()
+            {
+                var client = Substitute.For<IApiConnection>();
+                var usersClient = new UsersClient(client);
+
+                var result = Record.Exception(() => usersClient.AddEmailsToCurrent());
+
+                Assert.IsType<ArgumentException>(result);
+                Assert.Equal("emails", ((ArgumentException)result).ParamName);
+            }
+
+            [Fact]
+            public void ShouldSkipEmptyEmailAddresses()
+            {
+                var client = Substitute.For<IApiConnection>();
+                var usersClient = new UsersClient(client);
+
+                usersClient.AddEmailsToCurrent("[email protected]", "", null, "[email protected]");
+
+                client.Received().Post<string[]>(ApiUrls.Emails(), Arg.Is<string[]>(p => p.Length == 2));
+            }
+        }
     }
 }

Octokit/Clients/IUsersClient.cs

@@ -41,5 +41,12 @@ public interface IUsersClient
         /// <returns></returns>
         [SuppressMessage("Microsoft.Design", "CA1024:UsePropertiesWhereAppropriate")]
         Task<IReadOnlyList<EmailAddress>> GetEmails();
+
+        /// <summary>
+        /// Add email address(es) to the current user.
+        /// </summary>
+        /// <param name="emails">The email adresses to add.</param>
+        /// <returns>A read only list of the added email adresses.</returns>
+        Task<EmailAddress[]> AddEmailsToCurrent(params string[] emails);
     }
 }

Octokit/Clients/UsersClient.cs

@@ -2,6 +2,7 @@
 #if NET_45
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
+using System.Linq;
 #endif
 using System.Threading.Tasks;
 
@@ -68,5 +69,22 @@ public Task<IReadOnlyList<EmailAddress>> GetEmails()
         {
             return ApiConnection.GetAll<EmailAddress>(ApiUrls.Emails(), null);
         }
+
+        /// <summary>
+        /// Add email address(es) to the current user.
+        /// </summary>
+        /// <param name="emails">The email adresses to add.</param>
+        /// <returns>A read only list of the added email adresses.</returns>
+        public Task<EmailAddress[]> AddEmailsToCurrent(params string[] emails)
+        {
+            if (emails == null || emails.Length == 0)
+            {
+                throw new ArgumentException("No email addresses provided.", "emails");
+            }
+
+            var data = emails.Where(e => !string.IsNullOrEmpty(e)).ToArray();
+
+            return ApiConnection.Post<EmailAddress[]>(ApiUrls.Emails(), data);
+        }
     }
 }