feat: [api] Introduce RPCs to share resources with individual users

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 167
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-dfd13e2785a9e0e662f79aab0c03d45144d803fedd87510ec27791b79ede6162.yml
-openapi_spec_hash: 8dcab0c2c65f9eb778e9b2cf3c44bf5c
-config_hash: 21bab2a4731f1e55c0a2c62588576282
+configured_endpoints: 169
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-6b80aebab53bff73bb7b87c5f91f98c6dd5db2d623b6c613aaa5e61252b74d75.yml
+openapi_spec_hash: 9636e315ac739c1ab9cba65a7ead6559
+config_hash: 73893621fd64bbd87b86671decf334e6

api.md

@@ -13,6 +13,7 @@ from gitpod.types import (
     OrganizationTier,
     Principal,
     ProjectEnvironmentClass,
+    ResourceRole,
     ResourceType,
     RunsOn,
     SecretRef,
@@ -302,7 +303,7 @@ Methods:
 Types:
 
 ```python
-from gitpod.types.groups import ResourceRole, RoleAssignment, RoleAssignmentCreateResponse
+from gitpod.types.groups import RoleAssignment, RoleAssignmentCreateResponse
 ```
 
 Methods:
@@ -311,6 +312,13 @@ Methods:
 - <code title="post /gitpod.v1.GroupService/ListRoleAssignments">client.groups.role_assignments.<a href="./src/gitpod/resources/groups/role_assignments.py">list</a>(\*\*<a href="src/gitpod/types/groups/role_assignment_list_params.py">params</a>) -> <a href="./src/gitpod/types/groups/role_assignment.py">SyncAssignmentsPage[RoleAssignment]</a></code>
 - <code title="post /gitpod.v1.GroupService/DeleteRoleAssignment">client.groups.role_assignments.<a href="./src/gitpod/resources/groups/role_assignments.py">delete</a>(\*\*<a href="src/gitpod/types/groups/role_assignment_delete_params.py">params</a>) -> object</code>
 
+## Shares
+
+Methods:
+
+- <code title="post /gitpod.v1.GroupService/ShareResourceWithPrincipal">client.groups.shares.<a href="./src/gitpod/resources/groups/shares.py">create</a>(\*\*<a href="src/gitpod/types/groups/share_create_params.py">params</a>) -> object</code>
+- <code title="post /gitpod.v1.GroupService/UnshareResourceWithPrincipal">client.groups.shares.<a href="./src/gitpod/resources/groups/shares.py">delete</a>(\*\*<a href="src/gitpod/types/groups/share_delete_params.py">params</a>) -> object</code>
+
 # Identity
 
 Types:

src/gitpod/resources/groups/__init__.py

@@ -8,6 +8,14 @@
     GroupsResourceWithStreamingResponse,
     AsyncGroupsResourceWithStreamingResponse,
 )
+from .shares import (
+    SharesResource,
+    AsyncSharesResource,
+    SharesResourceWithRawResponse,
+    AsyncSharesResourceWithRawResponse,
+    SharesResourceWithStreamingResponse,
+    AsyncSharesResourceWithStreamingResponse,
+)
 from .memberships import (
     MembershipsResource,
     AsyncMembershipsResource,
@@ -38,6 +46,12 @@
     "AsyncRoleAssignmentsResourceWithRawResponse",
     "RoleAssignmentsResourceWithStreamingResponse",
     "AsyncRoleAssignmentsResourceWithStreamingResponse",
+    "SharesResource",
+    "AsyncSharesResource",
+    "SharesResourceWithRawResponse",
+    "AsyncSharesResourceWithRawResponse",
+    "SharesResourceWithStreamingResponse",
+    "AsyncSharesResourceWithStreamingResponse",
     "GroupsResource",
     "AsyncGroupsResource",
     "GroupsResourceWithRawResponse",

src/gitpod/resources/groups/groups.py

@@ -4,6 +4,14 @@
 
 import httpx
 
+from .shares import (
+    SharesResource,
+    AsyncSharesResource,
+    SharesResourceWithRawResponse,
+    AsyncSharesResourceWithRawResponse,
+    SharesResourceWithStreamingResponse,
+    AsyncSharesResourceWithStreamingResponse,
+)
 from ...types import (
     group_list_params,
     group_create_params,
@@ -56,6 +64,10 @@ def memberships(self) -> MembershipsResource:
     def role_assignments(self) -> RoleAssignmentsResource:
         return RoleAssignmentsResource(self._client)
 
+    @cached_property
+    def shares(self) -> SharesResource:
+        return SharesResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> GroupsResourceWithRawResponse:
         """
@@ -396,6 +408,10 @@ def memberships(self) -> AsyncMembershipsResource:
     def role_assignments(self) -> AsyncRoleAssignmentsResource:
         return AsyncRoleAssignmentsResource(self._client)
 
+    @cached_property
+    def shares(self) -> AsyncSharesResource:
+        return AsyncSharesResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncGroupsResourceWithRawResponse:
         """
@@ -755,6 +771,10 @@ def memberships(self) -> MembershipsResourceWithRawResponse:
     def role_assignments(self) -> RoleAssignmentsResourceWithRawResponse:
         return RoleAssignmentsResourceWithRawResponse(self._groups.role_assignments)
 
+    @cached_property
+    def shares(self) -> SharesResourceWithRawResponse:
+        return SharesResourceWithRawResponse(self._groups.shares)
+
 
 class AsyncGroupsResourceWithRawResponse:
     def __init__(self, groups: AsyncGroupsResource) -> None:
@@ -784,6 +804,10 @@ def memberships(self) -> AsyncMembershipsResourceWithRawResponse:
     def role_assignments(self) -> AsyncRoleAssignmentsResourceWithRawResponse:
         return AsyncRoleAssignmentsResourceWithRawResponse(self._groups.role_assignments)
 
+    @cached_property
+    def shares(self) -> AsyncSharesResourceWithRawResponse:
+        return AsyncSharesResourceWithRawResponse(self._groups.shares)
+
 
 class GroupsResourceWithStreamingResponse:
     def __init__(self, groups: GroupsResource) -> None:
@@ -813,6 +837,10 @@ def memberships(self) -> MembershipsResourceWithStreamingResponse:
     def role_assignments(self) -> RoleAssignmentsResourceWithStreamingResponse:
         return RoleAssignmentsResourceWithStreamingResponse(self._groups.role_assignments)
 
+    @cached_property
+    def shares(self) -> SharesResourceWithStreamingResponse:
+        return SharesResourceWithStreamingResponse(self._groups.shares)
+
 
 class AsyncGroupsResourceWithStreamingResponse:
     def __init__(self, groups: AsyncGroupsResource) -> None:
@@ -841,3 +869,7 @@ def memberships(self) -> AsyncMembershipsResourceWithStreamingResponse:
     @cached_property
     def role_assignments(self) -> AsyncRoleAssignmentsResourceWithStreamingResponse:
         return AsyncRoleAssignmentsResourceWithStreamingResponse(self._groups.role_assignments)
+
+    @cached_property
+    def shares(self) -> AsyncSharesResourceWithStreamingResponse:
+        return AsyncSharesResourceWithStreamingResponse(self._groups.shares)

src/gitpod/resources/groups/role_assignments.py

@@ -16,13 +16,8 @@
 )
 from ...pagination import SyncAssignmentsPage, AsyncAssignmentsPage
 from ..._base_client import AsyncPaginator, make_request_options
-from ...types.groups import (
-    ResourceRole,
-    role_assignment_list_params,
-    role_assignment_create_params,
-    role_assignment_delete_params,
-)
-from ...types.groups.resource_role import ResourceRole
+from ...types.groups import role_assignment_list_params, role_assignment_create_params, role_assignment_delete_params
+from ...types.shared.resource_role import ResourceRole
 from ...types.shared.resource_type import ResourceType
 from ...types.groups.role_assignment import RoleAssignment
 from ...types.groups.role_assignment_create_response import RoleAssignmentCreateResponse