From ddb66ed7120a9f9e45c3bf13b006173b6ff4cf86 Mon Sep 17 00:00:00 2001
From: Lian Duan <chemhack@users.noreply.github.com>
Date: Fri, 10 Mar 2023 19:42:42 +0100
Subject: [PATCH] [FEAT] Implement GetAllOrganizationMembershipsForCurrent
 (#2654)

---
 .../IObservableOrganizationMembersClient.cs   | 23 +++++++++++++
 .../ObservableOrganizationMembersClient.cs    | 29 +++++++++++++++++
 .../Clients/OrganizationMembersClientTests.cs | 32 +++++++++++++++++++
 Octokit/Clients/IOrganizationMembersClient.cs | 24 ++++++++++++++
 Octokit/Clients/OrganizationMembersClient.cs  | 24 ++++++++++++++
 Octokit/Helpers/ApiUrls.cs                    |  9 ++++++
 6 files changed, 141 insertions(+)

diff --git a/Octokit.Reactive/Clients/IObservableOrganizationMembersClient.cs b/Octokit.Reactive/Clients/IObservableOrganizationMembersClient.cs
index 1097771f85..4c80d17f88 100644
--- a/Octokit.Reactive/Clients/IObservableOrganizationMembersClient.cs
+++ b/Octokit.Reactive/Clients/IObservableOrganizationMembersClient.cs
@@ -363,5 +363,28 @@ public interface IObservableOrganizationMembersClient
         /// <param name="options">Options to change API behaviour</param>
         /// <returns></returns>
         IObservable<OrganizationMembershipInvitation> GetAllFailedInvitations(string org, ApiOptions options);
+        
+        /// <summary>
+        /// Returns all <see cref="OrganizationMembership" />s for the current user.
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://docs.github.com/en/rest/orgs/members#list-organization-memberships-for-the-authenticated-user">API Documentation</a>
+        /// for more information.
+        /// </remarks>
+        /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
+        /// <returns></returns>
+        IObservable<OrganizationMembership> GetAllOrganizationMembershipsForCurrent();
+
+        /// <summary>
+        /// Returns all <see cref="OrganizationMembership" />s for the current user.
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://docs.github.com/en/rest/orgs/members#list-organization-memberships-for-the-authenticated-user">API Documentation</a>
+        /// for more information.
+        /// </remarks>
+        /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
+        /// <param name="options">Options to change API behaviour</param>
+        /// <returns></returns>
+        IObservable<OrganizationMembership> GetAllOrganizationMembershipsForCurrent(ApiOptions options);
     }
 }
diff --git a/Octokit.Reactive/Clients/ObservableOrganizationMembersClient.cs b/Octokit.Reactive/Clients/ObservableOrganizationMembersClient.cs
index 1a1b547399..f7616aaceb 100644
--- a/Octokit.Reactive/Clients/ObservableOrganizationMembersClient.cs
+++ b/Octokit.Reactive/Clients/ObservableOrganizationMembersClient.cs
@@ -506,5 +506,34 @@ public IObservable<OrganizationMembershipInvitation> GetAllFailedInvitations(str
 
             return _connection.GetAndFlattenAllPages<OrganizationMembershipInvitation>(ApiUrls.OrganizationFailedInvitations(org), null, options);
         }
+
+        /// <summary>
+        /// Returns all <see cref="OrganizationMembership" />s for the current user.
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://docs.github.com/en/rest/orgs/members#list-organization-memberships-for-the-authenticated-user">API Documentation</a>
+        /// for more information.
+        /// </remarks>
+        /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
+        /// <returns></returns>
+        public IObservable<OrganizationMembership> GetAllOrganizationMembershipsForCurrent()
+        {
+            return _connection.GetAndFlattenAllPages<OrganizationMembership>(ApiUrls.UserOrganizationMemberships());
+        }
+
+        /// <summary>
+        /// Returns all <see cref="OrganizationMembership" />s for the current user.
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://docs.github.com/en/rest/orgs/members#list-organization-memberships-for-the-authenticated-user">API Documentation</a>
+        /// for more information.
+        /// </remarks>
+        /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
+        /// <param name="options">Options to change API behaviour</param>
+        /// <returns></returns>
+        public IObservable<OrganizationMembership> GetAllOrganizationMembershipsForCurrent(ApiOptions options)
+        {
+            return _connection.GetAndFlattenAllPages<OrganizationMembership>(ApiUrls.UserOrganizationMemberships(), options);
+        }
     }
 }
diff --git a/Octokit.Tests.Integration/Clients/OrganizationMembersClientTests.cs b/Octokit.Tests.Integration/Clients/OrganizationMembersClientTests.cs
index 5e8dc01c04..16f0f8cf5d 100644
--- a/Octokit.Tests.Integration/Clients/OrganizationMembersClientTests.cs
+++ b/Octokit.Tests.Integration/Clients/OrganizationMembersClientTests.cs
@@ -293,5 +293,37 @@ public async Task ReturnsNoFailedInvitations()
                 Assert.Empty(pendingInvitations);
             }
         }
+
+        public class TheGetAllOrganizationMembershipsForCurrentMethod
+        {
+            private IGitHubClient _gitHub;
+
+            public TheGetAllOrganizationMembershipsForCurrentMethod()
+            {
+                _gitHub = Helper.GetAuthenticatedClient();
+            }
+
+            [OrganizationTest]
+            public async Task ReturnsMemberships()
+            {
+                var memberships = await _gitHub.Organization.Member.GetAllOrganizationMembershipsForCurrent();
+                Assert.NotEmpty(memberships);
+            }
+
+            [OrganizationTest]
+            public async Task ReturnsCorrectCountOfMembersWithoutStart()
+            {
+                var options = new ApiOptions
+                {
+                    PageCount = 1,
+                    PageSize = 1
+                };
+
+                var memberships = await _gitHub.Organization.Member.GetAllOrganizationMembershipsForCurrent(options);
+
+                Assert.Equal(1, memberships.Count);
+            }
+
+        }
     }
 }
diff --git a/Octokit/Clients/IOrganizationMembersClient.cs b/Octokit/Clients/IOrganizationMembersClient.cs
index 328db251a9..222e10e558 100644
--- a/Octokit/Clients/IOrganizationMembersClient.cs
+++ b/Octokit/Clients/IOrganizationMembersClient.cs
@@ -369,5 +369,29 @@ public interface IOrganizationMembersClient
         /// <param name="options">Options to change API behaviour</param>
         /// <returns></returns>
         Task<IReadOnlyList<OrganizationMembershipInvitation>> GetAllFailedInvitations(string org, ApiOptions options);
+
+        /// <summary>
+        /// Returns all <see cref="OrganizationMembership" />s for the current user.
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://docs.github.com/en/rest/orgs/members#list-organization-memberships-for-the-authenticated-user">API Documentation</a>
+        /// for more information.
+        /// </remarks>
+        /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
+        /// <returns>A list of the current user's <see cref="OrganizationMembership"/>s.</returns>
+        Task<IReadOnlyList<OrganizationMembership>> GetAllOrganizationMembershipsForCurrent();
+
+        /// <summary>
+        /// Returns all <see cref="OrganizationMembership" />s for the current user.
+        /// </summary>
+        /// <remarks>
+        /// See the <a href="https://docs.github.com/en/rest/orgs/members#list-organization-memberships-for-the-authenticated-user">API Documentation</a>
+        /// for more information.
+        /// </remarks>
+        /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
+        /// <param name="options">Options to change API behaviour</param>
+        /// <returns>A list of the current user's <see cref="OrganizationMembership"/>s.</returns>
+        Task<IReadOnlyList<OrganizationMembership>> GetAllOrganizationMembershipsForCurrent(ApiOptions options);
+
     }
 }
diff --git a/Octokit/Clients/OrganizationMembersClient.cs b/Octokit/Clients/OrganizationMembersClient.cs
index d9f9d4fa9f..2e2de872ac 100644
--- a/Octokit/Clients/OrganizationMembersClient.cs
+++ b/Octokit/Clients/OrganizationMembersClient.cs
@@ -603,5 +603,29 @@ public Task<IReadOnlyList<OrganizationMembershipInvitation>> GetAllFailedInvitat
 
             return ApiConnection.GetAll<OrganizationMembershipInvitation>(ApiUrls.OrganizationFailedInvitations(org), null, options);
         }
+
+        /// <summary>
+        /// Returns all <see cref="OrganizationMembership" />s for the current user.
+        /// </summary>
+        /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
+        /// <returns>A list of the current user's <see cref="OrganizationMembership"/>s.</returns>
+        [ManualRoute("GET", "/user/memberships/orgs")]
+        public Task<IReadOnlyList<OrganizationMembership>> GetAllOrganizationMembershipsForCurrent()
+        {
+            return ApiConnection.GetAll<OrganizationMembership>(ApiUrls.UserOrganizationMemberships());
+        }
+
+        /// <summary>
+        /// Returns all <see cref="OrganizationMembership" />s for the current user.
+        /// </summary>
+        /// <exception cref="ApiException">Thrown when a general API error occurs.</exception>
+        /// <param name="options">Options to change API behaviour</param>
+        /// <returns>A list of the current user's <see cref="OrganizationMembership"/>s.</returns>
+        [ManualRoute("GET", "/user/memberships/orgs")]
+        public Task<IReadOnlyList<OrganizationMembership>> GetAllOrganizationMembershipsForCurrent(ApiOptions options)
+        {
+            return ApiConnection.GetAll<OrganizationMembership>(ApiUrls.UserOrganizationMemberships(), options);
+        }
+
     }
 }
diff --git a/Octokit/Helpers/ApiUrls.cs b/Octokit/Helpers/ApiUrls.cs
index 82621ada5a..9b1a072791 100644
--- a/Octokit/Helpers/ApiUrls.cs
+++ b/Octokit/Helpers/ApiUrls.cs
@@ -143,6 +143,15 @@ public static Uri UserOrganizations()
         {
             return "user/orgs".FormatUri();
         }
+        
+        /// <summary>
+        /// Returns the <see cref="Uri"/> that returns all of the organization memberships for the currently logged in user.
+        /// </summary>
+        /// <returns></returns>
+        public static Uri UserOrganizationMemberships()
+        {
+            return "user/memberships/orgs".FormatUri();
+        }
 
         /// <summary>
         /// Returns the <see cref="Uri"/> that returns all of the organizations for the specified login.