meshtrade 1.0.1__py3-none-any.whl → 1.29.0__py3-none-any.whl

meshtrade/iam/group/v1/service_meshpy.py

@@ -9,6 +9,7 @@ the service interface with resource management capabilities, providing authentic
 timeouts, and proper connection handling.
 """
 
+from collections.abc import Iterator
 from datetime import timedelta
 from typing import Optional
 
@@ -16,13 +17,15 @@ from meshtrade.common import BaseGRPCClient
 from meshtrade.iam.api_user.v1.api_credentials import find_credentials
 
 from .group_pb2 import Group
-from .service_options_meshpy import ServiceOptions
+from meshtrade.common.service_options import ServiceOptions
 from .service_pb2 import (
+CreateGroupRequest,
 GetGroupRequest,
 ListGroupsRequest,
 ListGroupsResponse,
 SearchGroupsRequest,
 SearchGroupsResponse,
+UpdateGroupRequest,
 )
 from .service_pb2_grpc import GroupServiceStub
 
@@ -133,21 +136,37 @@ class GroupService(BaseGRPCClient):
             tls=options.tls,
         )
 
-    def get_group(self, request: GetGroupRequest, timeout: Optional[timedelta] = None) -> Group:
-        """GetGroup method.
+    def create_group(self, request: CreateGroupRequest, timeout: Optional[timedelta] = None) -> Group:
+        """CreateGroup method.
 
         Args:
-            request: The GetGroup request message
+            request: The CreateGroup request message
             timeout: Optional timeout override for this call
 
         Returns:
-            The GetGroup response message
+            The CreateGroup response message
 
         Raises:
             grpc.RpcError: If the gRPC call fails
             ValueError: If authentication credentials are missing
         """
-        return self._execute_method("GetGroup", request, timeout)
+        return self._execute_method("CreateGroup", request, timeout)
+
+    def update_group(self, request: UpdateGroupRequest, timeout: Optional[timedelta] = None) -> Group:
+        """UpdateGroup method.
+
+        Args:
+            request: The UpdateGroup request message
+            timeout: Optional timeout override for this call
+
+        Returns:
+            The UpdateGroup response message
+
+        Raises:
+            grpc.RpcError: If the gRPC call fails
+            ValueError: If authentication credentials are missing
+        """
+        return self._execute_method("UpdateGroup", request, timeout)
 
     def list_groups(self, request: ListGroupsRequest, timeout: Optional[timedelta] = None) -> ListGroupsResponse:
         """ListGroups method.
@@ -181,6 +200,22 @@ class GroupService(BaseGRPCClient):
         """
         return self._execute_method("SearchGroups", request, timeout)
 
+    def get_group(self, request: GetGroupRequest, timeout: Optional[timedelta] = None) -> Group:
+        """GetGroup method.
+
+        Args:
+            request: The GetGroup request message
+            timeout: Optional timeout override for this call
+
+        Returns:
+            The GetGroup response message
+
+        Raises:
+            grpc.RpcError: If the gRPC call fails
+            ValueError: If authentication credentials are missing
+        """
+        return self._execute_method("GetGroup", request, timeout)
+
 
 # Create aliases to match expected exports
 GroupServiceGRPCClient = GroupService

meshtrade/iam/group/v1/service_pb2.py

@@ -22,35 +22,62 @@ _runtime_version.ValidateProtobufRuntimeVersion(
 _sym_db = _symbol_database.Default()
 
 
+from buf.validate import validate_pb2 as buf_dot_validate_dot_validate__pb2
 from meshtrade.iam.group.v1 import group_pb2 as meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2
-from meshtrade.iam.role.v1 import role_pb2 as meshtrade_dot_iam_dot_role_dot_v1_dot_role__pb2
-from meshtrade.option.v1 import method_type_pb2 as meshtrade_dot_option_dot_v1_dot_method__type__pb2
+from meshtrade.option.method_options.v1 import method_options_pb2 as meshtrade_dot_option_dot_method__options_dot_v1_dot_method__options__pb2
+from meshtrade.type.v1 import sorting_pb2 as meshtrade_dot_type_dot_v1_dot_sorting__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n$meshtrade/iam/group/v1/service.proto\x12\x16meshtrade.iam.group.v1\x1a\"meshtrade/iam/group/v1/group.proto\x1a meshtrade/iam/role/v1/role.proto\x1a%meshtrade/option/v1/method_type.proto\"%\n\x0fGetGroupRequest\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\"\x13\n\x11ListGroupsRequest\"K\n\x12ListGroupsResponse\x12\x35\n\x06groups\x18\x01 \x03(\x0b\x32\x1d.meshtrade.iam.group.v1.GroupR\x06groups\")\n\x13SearchGroupsRequest\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\"M\n\x14SearchGroupsResponse\x12\x35\n\x06groups\x18\x01 \x03(\x0b\x32\x1d.meshtrade.iam.group.v1.GroupR\x06groups2\xee\x02\n\x0cGroupService\x12\x66\n\x08GetGroup\x12\'.meshtrade.iam.group.v1.GetGroupRequest\x1a\x1d.meshtrade.iam.group.v1.Group\"\x12\xa0\xb5\x18\x01\xaa\xb5\x18\n\n\x08\xc0\x8d\xb7\x01\xc1\x8d\xb7\x01\x12w\n\nListGroups\x12).meshtrade.iam.group.v1.ListGroupsRequest\x1a*.meshtrade.iam.group.v1.ListGroupsResponse\"\x12\xa0\xb5\x18\x01\xaa\xb5\x18\n\n\x08\xc0\x8d\xb7\x01\xc1\x8d\xb7\x01\x12}\n\x0cSearchGroups\x12+.meshtrade.iam.group.v1.SearchGroupsRequest\x1a,.meshtrade.iam.group.v1.SearchGroupsResponse\"\x12\xa0\xb5\x18\x01\xaa\xb5\x18\n\n\x08\xc0\x8d\xb7\x01\xc1\x8d\xb7\x01\x42Q\n\x1d\x63o.meshtrade.api.iam.group.v1Z0github.com/meshtrade/api/go/iam/group/v1;groupv1b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n$meshtrade/iam/group/v1/service.proto\x12\x16meshtrade.iam.group.v1\x1a\x1b\x62uf/validate/validate.proto\x1a\"meshtrade/iam/group/v1/group.proto\x1a\x37meshtrade/option/method_options/v1/method_options.proto\x1a\x1fmeshtrade/type/v1/sorting.proto\"Q\n\x12\x43reateGroupRequest\x12;\n\x05group\x18\x01 \x01(\x0b\x32\x1d.meshtrade.iam.group.v1.GroupB\x06\xbaH\x03\xc8\x01\x01R\x05group\"Q\n\x12UpdateGroupRequest\x12;\n\x05group\x18\x01 \x01(\x0b\x32\x1d.meshtrade.iam.group.v1.GroupB\x06\xbaH\x03\xc8\x01\x01R\x05group\"\xc3\x02\n\x11ListGroupsRequest\x12K\n\x07sorting\x18\x01 \x01(\x0b\x32\x31.meshtrade.iam.group.v1.ListGroupsRequest.SortingR\x07sorting\x1a\xe0\x01\n\x07Sorting\x12\x9d\x01\n\x05\x66ield\x18\x01 \x01(\tB\x86\x01\xbaH\x82\x01r\x16R\x00R\x04nameR\x0c\x64isplay_name\xba\x01g\n\x0b\x66ield.valid\x12\x32\x66ield must be one of: name, display_name, or empty\x1a$this in [\'\', \'name\', \'display_name\']R\x05\x66ield\x12\x35\n\x05order\x18\x02 \x01(\x0e\x32\x1f.meshtrade.type.v1.SortingOrderR\x05order\"K\n\x12ListGroupsResponse\x12\x35\n\x06groups\x18\x01 \x03(\x0b\x32\x1d.meshtrade.iam.group.v1.GroupR\x06groups\"\xf0\x04\n\x13SearchGroupsRequest\x12\x93\x01\n\x0c\x64isplay_name\x18\x01 \x01(\tBp\xbaHmr\x03\x18\xff\x01\xba\x01\x65\n\x17\x64isplay_name.max_length\x12\x37\x64isplay_name search term must not exceed 255 characters\x1a\x11size(this) <= 255R\x0b\x64isplayName\x12\x90\x01\n\x0b\x64\x65scription\x18\x02 \x01(\tBn\xbaHkr\x03\x18\xff\x01\xba\x01\x63\n\x16\x64\x65scription.max_length\x12\x36\x64\x65scription search term must not exceed 255 characters\x1a\x11size(this) <= 255R\x0b\x64\x65scription\x12M\n\x07sorting\x18\x03 \x01(\x0b\x32\x33.meshtrade.iam.group.v1.SearchGroupsRequest.SortingR\x07sorting\x1a\xe0\x01\n\x07Sorting\x12\x9d\x01\n\x05\x66ield\x18\x01 \x01(\tB\x86\x01\xbaH\x82\x01r\x16R\x00R\x04nameR\x0c\x64isplay_name\xba\x01g\n\x0b\x66ield.valid\x12\x32\x66ield must be one of: name, display_name, or empty\x1a$this in [\'\', \'name\', \'display_name\']R\x05\x66ield\x12\x35\n\x05order\x18\x02 \x01(\x0e\x32\x1f.meshtrade.type.v1.SortingOrderR\x05order\"M\n\x14SearchGroupsResponse\x12\x35\n\x06groups\x18\x01 \x03(\x0b\x32\x1d.meshtrade.iam.group.v1.GroupR\x06groups\"\xf6\x02\n\x0fGetGroupRequest\x12\xe2\x02\n\x04name\x18\x01 \x01(\tB\xcd\x02\xbaH\xc9\x02r3\x10\x01\x32/^groups/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$\xba\x01W\n\rname.required\x12\x36name is required and must be in format groups/{ULIDv2}\x1a\x0esize(this) > 0\xba\x01\xb3\x01\n\x0bname.format\x12\x63name must be in format groups/{ULIDv2} where ulidv2 is exactly 26 uppercase alphanumeric characters\x1a?this.matches(\'^groups/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$\')\xc8\x01\x01R\x04name2\xe3\x04\n\x0cGroupService\x12l\n\x0b\x43reateGroup\x12*.meshtrade.iam.group.v1.CreateGroupRequest\x1a\x1d.meshtrade.iam.group.v1.Group\"\x12\xb2\xb5\x18\x0e\x08\x02\x10\x02\x1a\x08\xc0\x8d\xb7\x01\xc4\x8d\xb7\x01\x12l\n\x0bUpdateGroup\x12*.meshtrade.iam.group.v1.UpdateGroupRequest\x1a\x1d.meshtrade.iam.group.v1.Group\"\x12\xb2\xb5\x18\x0e\x08\x02\x10\x02\x1a\x08\xc0\x8d\xb7\x01\xc4\x8d\xb7\x01\x12\x7f\n\nListGroups\x12).meshtrade.iam.group.v1.ListGroupsRequest\x1a*.meshtrade.iam.group.v1.ListGroupsResponse\"\x1a\xb2\xb5\x18\x16\x08\x01\x10\x02\x1a\x10\xc0\x8d\xb7\x01\xc1\x8d\xb7\x01\xc4\x8d\xb7\x01\xc5\x8d\xb7\x01\x12\x85\x01\n\x0cSearchGroups\x12+.meshtrade.iam.group.v1.SearchGroupsRequest\x1a,.meshtrade.iam.group.v1.SearchGroupsResponse\"\x1a\xb2\xb5\x18\x16\x08\x01\x10\x02\x1a\x10\xc0\x8d\xb7\x01\xc1\x8d\xb7\x01\xc4\x8d\xb7\x01\xc5\x8d\xb7\x01\x12n\n\x08GetGroup\x12\'.meshtrade.iam.group.v1.GetGroupRequest\x1a\x1d.meshtrade.iam.group.v1.Group\"\x1a\xb2\xb5\x18\x16\x08\x01\x10\x02\x1a\x10\xc0\x8d\xb7\x01\xc1\x8d\xb7\x01\xc4\x8d\xb7\x01\xc5\x8d\xb7\x01\x42R\n\x1d\x63o.meshtrade.api.iam.group.v1Z1github.com/meshtrade/api/go/iam/group/v1;group_v1b\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.iam.group.v1.service_pb2', _globals)
 if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
-  _globals['DESCRIPTOR']._serialized_options = b'\n\035co.meshtrade.api.iam.group.v1Z0github.com/meshtrade/api/go/iam/group/v1;groupv1'
-  _globals['_GROUPSERVICE'].methods_by_name['GetGroup']._loaded_options = None
-  _globals['_GROUPSERVICE'].methods_by_name['GetGroup']._serialized_options = b'\240\265\030\001\252\265\030\n\n\010\300\215\267\001\301\215\267\001'
+  _globals['DESCRIPTOR']._serialized_options = b'\n\035co.meshtrade.api.iam.group.v1Z1github.com/meshtrade/api/go/iam/group/v1;group_v1'
+  _globals['_CREATEGROUPREQUEST'].fields_by_name['group']._loaded_options = None
+  _globals['_CREATEGROUPREQUEST'].fields_by_name['group']._serialized_options = b'\272H\003\310\001\001'
+  _globals['_UPDATEGROUPREQUEST'].fields_by_name['group']._loaded_options = None
+  _globals['_UPDATEGROUPREQUEST'].fields_by_name['group']._serialized_options = b'\272H\003\310\001\001'
+  _globals['_LISTGROUPSREQUEST_SORTING'].fields_by_name['field']._loaded_options = None
+  _globals['_LISTGROUPSREQUEST_SORTING'].fields_by_name['field']._serialized_options = b'\272H\202\001r\026R\000R\004nameR\014display_name\272\001g\n\013field.valid\0222field must be one of: name, display_name, or empty\032$this in [\'\', \'name\', \'display_name\']'
+  _globals['_SEARCHGROUPSREQUEST_SORTING'].fields_by_name['field']._loaded_options = None
+  _globals['_SEARCHGROUPSREQUEST_SORTING'].fields_by_name['field']._serialized_options = b'\272H\202\001r\026R\000R\004nameR\014display_name\272\001g\n\013field.valid\0222field must be one of: name, display_name, or empty\032$this in [\'\', \'name\', \'display_name\']'
+  _globals['_SEARCHGROUPSREQUEST'].fields_by_name['display_name']._loaded_options = None
+  _globals['_SEARCHGROUPSREQUEST'].fields_by_name['display_name']._serialized_options = b'\272Hmr\003\030\377\001\272\001e\n\027display_name.max_length\0227display_name search term must not exceed 255 characters\032\021size(this) <= 255'
+  _globals['_SEARCHGROUPSREQUEST'].fields_by_name['description']._loaded_options = None
+  _globals['_SEARCHGROUPSREQUEST'].fields_by_name['description']._serialized_options = b'\272Hkr\003\030\377\001\272\001c\n\026description.max_length\0226description search term must not exceed 255 characters\032\021size(this) <= 255'
+  _globals['_GETGROUPREQUEST'].fields_by_name['name']._loaded_options = None
+  _globals['_GETGROUPREQUEST'].fields_by_name['name']._serialized_options = b'\272H\311\002r3\020\0012/^groups/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$\272\001W\n\rname.required\0226name is required and must be in format groups/{ULIDv2}\032\016size(this) > 0\272\001\263\001\n\013name.format\022cname must be in format groups/{ULIDv2} where ulidv2 is exactly 26 uppercase alphanumeric characters\032?this.matches(\'^groups/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$\')\310\001\001'
+  _globals['_GROUPSERVICE'].methods_by_name['CreateGroup']._loaded_options = None
+  _globals['_GROUPSERVICE'].methods_by_name['CreateGroup']._serialized_options = b'\262\265\030\016\010\002\020\002\032\010\300\215\267\001\304\215\267\001'
+  _globals['_GROUPSERVICE'].methods_by_name['UpdateGroup']._loaded_options = None
+  _globals['_GROUPSERVICE'].methods_by_name['UpdateGroup']._serialized_options = b'\262\265\030\016\010\002\020\002\032\010\300\215\267\001\304\215\267\001'
   _globals['_GROUPSERVICE'].methods_by_name['ListGroups']._loaded_options = None
-  _globals['_GROUPSERVICE'].methods_by_name['ListGroups']._serialized_options = b'\240\265\030\001\252\265\030\n\n\010\300\215\267\001\301\215\267\001'
+  _globals['_GROUPSERVICE'].methods_by_name['ListGroups']._serialized_options = b'\262\265\030\026\010\001\020\002\032\020\300\215\267\001\301\215\267\001\304\215\267\001\305\215\267\001'
   _globals['_GROUPSERVICE'].methods_by_name['SearchGroups']._loaded_options = None
-  _globals['_GROUPSERVICE'].methods_by_name['SearchGroups']._serialized_options = b'\240\265\030\001\252\265\030\n\n\010\300\215\267\001\301\215\267\001'
-  _globals['_GETGROUPREQUEST']._serialized_start=173
-  _globals['_GETGROUPREQUEST']._serialized_end=210
-  _globals['_LISTGROUPSREQUEST']._serialized_start=212
-  _globals['_LISTGROUPSREQUEST']._serialized_end=231
-  _globals['_LISTGROUPSRESPONSE']._serialized_start=233
-  _globals['_LISTGROUPSRESPONSE']._serialized_end=308
-  _globals['_SEARCHGROUPSREQUEST']._serialized_start=310
-  _globals['_SEARCHGROUPSREQUEST']._serialized_end=351
-  _globals['_SEARCHGROUPSRESPONSE']._serialized_start=353
-  _globals['_SEARCHGROUPSRESPONSE']._serialized_end=430
-  _globals['_GROUPSERVICE']._serialized_start=433
-  _globals['_GROUPSERVICE']._serialized_end=799
+  _globals['_GROUPSERVICE'].methods_by_name['SearchGroups']._serialized_options = b'\262\265\030\026\010\001\020\002\032\020\300\215\267\001\301\215\267\001\304\215\267\001\305\215\267\001'
+  _globals['_GROUPSERVICE'].methods_by_name['GetGroup']._loaded_options = None
+  _globals['_GROUPSERVICE'].methods_by_name['GetGroup']._serialized_options = b'\262\265\030\026\010\001\020\002\032\020\300\215\267\001\301\215\267\001\304\215\267\001\305\215\267\001'
+  _globals['_CREATEGROUPREQUEST']._serialized_start=219
+  _globals['_CREATEGROUPREQUEST']._serialized_end=300
+  _globals['_UPDATEGROUPREQUEST']._serialized_start=302
+  _globals['_UPDATEGROUPREQUEST']._serialized_end=383
+  _globals['_LISTGROUPSREQUEST']._serialized_start=386
+  _globals['_LISTGROUPSREQUEST']._serialized_end=709
+  _globals['_LISTGROUPSREQUEST_SORTING']._serialized_start=485
+  _globals['_LISTGROUPSREQUEST_SORTING']._serialized_end=709
+  _globals['_LISTGROUPSRESPONSE']._serialized_start=711
+  _globals['_LISTGROUPSRESPONSE']._serialized_end=786
+  _globals['_SEARCHGROUPSREQUEST']._serialized_start=789
+  _globals['_SEARCHGROUPSREQUEST']._serialized_end=1413
+  _globals['_SEARCHGROUPSREQUEST_SORTING']._serialized_start=485
+  _globals['_SEARCHGROUPSREQUEST_SORTING']._serialized_end=709
+  _globals['_SEARCHGROUPSRESPONSE']._serialized_start=1415
+  _globals['_SEARCHGROUPSRESPONSE']._serialized_end=1492
+  _globals['_GETGROUPREQUEST']._serialized_start=1495
+  _globals['_GETGROUPREQUEST']._serialized_end=1869
+  _globals['_GROUPSERVICE']._serialized_start=1872
+  _globals['_GROUPSERVICE']._serialized_end=2483
 # @@protoc_insertion_point(module_scope)

meshtrade/iam/group/v1/service_pb2.pyi

@@ -1,6 +1,7 @@
+from buf.validate import validate_pb2 as _validate_pb2
 from meshtrade.iam.group.v1 import group_pb2 as _group_pb2
-from meshtrade.iam.role.v1 import role_pb2 as _role_pb2
-from meshtrade.option.v1 import method_type_pb2 as _method_type_pb2
+from meshtrade.option.method_options.v1 import method_options_pb2 as _method_options_pb2
+from meshtrade.type.v1 import sorting_pb2 as _sorting_pb2
 from google.protobuf.internal import containers as _containers
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import message as _message
@@ -9,15 +10,30 @@ from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
 
 DESCRIPTOR: _descriptor.FileDescriptor
 
-class GetGroupRequest(_message.Message):
-    __slots__ = ("name",)
-    NAME_FIELD_NUMBER: _ClassVar[int]
-    name: str
-    def __init__(self, name: _Optional[str] = ...) -> None: ...
+class CreateGroupRequest(_message.Message):
+    __slots__ = ("group",)
+    GROUP_FIELD_NUMBER: _ClassVar[int]
+    group: _group_pb2.Group
+    def __init__(self, group: _Optional[_Union[_group_pb2.Group, _Mapping]] = ...) -> None: ...
+
+class UpdateGroupRequest(_message.Message):
+    __slots__ = ("group",)
+    GROUP_FIELD_NUMBER: _ClassVar[int]
+    group: _group_pb2.Group
+    def __init__(self, group: _Optional[_Union[_group_pb2.Group, _Mapping]] = ...) -> None: ...
 
 class ListGroupsRequest(_message.Message):
-    __slots__ = ()
-    def __init__(self) -> None: ...
+    __slots__ = ("sorting",)
+    class Sorting(_message.Message):
+        __slots__ = ("field", "order")
+        FIELD_FIELD_NUMBER: _ClassVar[int]
+        ORDER_FIELD_NUMBER: _ClassVar[int]
+        field: str
+        order: _sorting_pb2.SortingOrder
+        def __init__(self, field: _Optional[str] = ..., order: _Optional[_Union[_sorting_pb2.SortingOrder, str]] = ...) -> None: ...
+    SORTING_FIELD_NUMBER: _ClassVar[int]
+    sorting: ListGroupsRequest.Sorting
+    def __init__(self, sorting: _Optional[_Union[ListGroupsRequest.Sorting, _Mapping]] = ...) -> None: ...
 
 class ListGroupsResponse(_message.Message):
     __slots__ = ("groups",)
@@ -26,13 +42,30 @@ class ListGroupsResponse(_message.Message):
     def __init__(self, groups: _Optional[_Iterable[_Union[_group_pb2.Group, _Mapping]]] = ...) -> None: ...
 
 class SearchGroupsRequest(_message.Message):
-    __slots__ = ("name",)
-    NAME_FIELD_NUMBER: _ClassVar[int]
-    name: str
-    def __init__(self, name: _Optional[str] = ...) -> None: ...
+    __slots__ = ("display_name", "description", "sorting")
+    class Sorting(_message.Message):
+        __slots__ = ("field", "order")
+        FIELD_FIELD_NUMBER: _ClassVar[int]
+        ORDER_FIELD_NUMBER: _ClassVar[int]
+        field: str
+        order: _sorting_pb2.SortingOrder
+        def __init__(self, field: _Optional[str] = ..., order: _Optional[_Union[_sorting_pb2.SortingOrder, str]] = ...) -> None: ...
+    DISPLAY_NAME_FIELD_NUMBER: _ClassVar[int]
+    DESCRIPTION_FIELD_NUMBER: _ClassVar[int]
+    SORTING_FIELD_NUMBER: _ClassVar[int]
+    display_name: str
+    description: str
+    sorting: SearchGroupsRequest.Sorting
+    def __init__(self, display_name: _Optional[str] = ..., description: _Optional[str] = ..., sorting: _Optional[_Union[SearchGroupsRequest.Sorting, _Mapping]] = ...) -> None: ...
 
 class SearchGroupsResponse(_message.Message):
     __slots__ = ("groups",)
     GROUPS_FIELD_NUMBER: _ClassVar[int]
     groups: _containers.RepeatedCompositeFieldContainer[_group_pb2.Group]
     def __init__(self, groups: _Optional[_Iterable[_Union[_group_pb2.Group, _Mapping]]] = ...) -> None: ...
+
+class GetGroupRequest(_message.Message):
+    __slots__ = ("name",)
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    name: str
+    def __init__(self, name: _Optional[str] = ...) -> None: ...

meshtrade/iam/group/v1/service_pb2_grpc.py

@@ -7,7 +7,17 @@ from meshtrade.iam.group.v1 import service_pb2 as meshtrade_dot_iam_dot_group_do
 
 
 class GroupServiceStub(object):
-    """Missing associated documentation comment in .proto file."""
+    """
+    GroupService manages organizational group hierarchy and lifecycle operations.
+
+    Groups are the fundamental multi-tenancy units in Mesh that own resources,
+    define permission boundaries, and enable hierarchical access control.
+    Each group can own sub-groups, users, API users, and platform resources,
+    forming tree structures for inherited permissions and resource isolation.
+
+    All operations are scoped to the authenticated group's hierarchy and
+    require appropriate IAM domain permissions.
+    """
 
     def __init__(self, channel):
         """Constructor.
@@ -15,9 +25,14 @@ class GroupServiceStub(object):
         Args:
             channel: A grpc.Channel.
         """
-        self.GetGroup = channel.unary_unary(
-                '/meshtrade.iam.group.v1.GroupService/GetGroup',
-                request_serializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.GetGroupRequest.SerializeToString,
+        self.CreateGroup = channel.unary_unary(
+                '/meshtrade.iam.group.v1.GroupService/CreateGroup',
+                request_serializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.CreateGroupRequest.SerializeToString,
+                response_deserializer=meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2.Group.FromString,
+                _registered_method=True)
+        self.UpdateGroup = channel.unary_unary(
+                '/meshtrade.iam.group.v1.GroupService/UpdateGroup',
+                request_serializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.UpdateGroupRequest.SerializeToString,
                 response_deserializer=meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2.Group.FromString,
                 _registered_method=True)
         self.ListGroups = channel.unary_unary(
@@ -30,14 +45,43 @@ class GroupServiceStub(object):
                 request_serializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.SearchGroupsRequest.SerializeToString,
                 response_deserializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.SearchGroupsResponse.FromString,
                 _registered_method=True)
+        self.GetGroup = channel.unary_unary(
+                '/meshtrade.iam.group.v1.GroupService/GetGroup',
+                request_serializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.GetGroupRequest.SerializeToString,
+                response_deserializer=meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2.Group.FromString,
+                _registered_method=True)
 
 
 class GroupServiceServicer(object):
-    """Missing associated documentation comment in .proto file."""
+    """
+    GroupService manages organizational group hierarchy and lifecycle operations.
 
-    def GetGroup(self, request, context):
+    Groups are the fundamental multi-tenancy units in Mesh that own resources,
+    define permission boundaries, and enable hierarchical access control.
+    Each group can own sub-groups, users, API users, and platform resources,
+    forming tree structures for inherited permissions and resource isolation.
+
+    All operations are scoped to the authenticated group's hierarchy and
+    require appropriate IAM domain permissions.
+    """
+
+    def CreateGroup(self, request, context):
+        """
+        Creates a new child group within the authenticated group's hierarchy.
+
+        The new group inherits access from its parent and becomes part of the
+        organizational structure. Group ownership must match the executing context.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def UpdateGroup(self, request, context):
         """
-        Get Specific Group.
+        Updates an existing group's display name and description metadata.
+
+        Only mutable fields can be modified while preserving the group's
+        identity and ownership within the hierarchy.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
@@ -45,7 +89,10 @@ class GroupServiceServicer(object):
 
     def ListGroups(self, request, context):
         """
-        Get all groups
+        Retrieves all groups within the authenticated group's hierarchical scope.
+
+        Returns the complete organizational structure accessible to the executing
+        context, including the root group and all descendant groups.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
@@ -53,7 +100,21 @@ class GroupServiceServicer(object):
 
     def SearchGroups(self, request, context):
         """
-        Get all groups with search filtering options.
+        Searches groups using flexible text criteria within the hierarchy.
+
+        Performs case-insensitive substring matching on display names and
+        descriptions using OR logic across search terms.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetGroup(self, request, context):
+        """
+        Retrieves a specific group by its resource identifier within the hierarchy.
+
+        Provides access to a single group's complete metadata and organizational
+        context if accessible within the executing group's scope.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
@@ -62,9 +123,14 @@ class GroupServiceServicer(object):
 
 def add_GroupServiceServicer_to_server(servicer, server):
     rpc_method_handlers = {
-            'GetGroup': grpc.unary_unary_rpc_method_handler(
-                    servicer.GetGroup,
-                    request_deserializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.GetGroupRequest.FromString,
+            'CreateGroup': grpc.unary_unary_rpc_method_handler(
+                    servicer.CreateGroup,
+                    request_deserializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.CreateGroupRequest.FromString,
+                    response_serializer=meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2.Group.SerializeToString,
+            ),
+            'UpdateGroup': grpc.unary_unary_rpc_method_handler(
+                    servicer.UpdateGroup,
+                    request_deserializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.UpdateGroupRequest.FromString,
                     response_serializer=meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2.Group.SerializeToString,
             ),
             'ListGroups': grpc.unary_unary_rpc_method_handler(
@@ -77,6 +143,11 @@ def add_GroupServiceServicer_to_server(servicer, server):
                     request_deserializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.SearchGroupsRequest.FromString,
                     response_serializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.SearchGroupsResponse.SerializeToString,
             ),
+            'GetGroup': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetGroup,
+                    request_deserializer=meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.GetGroupRequest.FromString,
+                    response_serializer=meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2.Group.SerializeToString,
+            ),
     }
     generic_handler = grpc.method_handlers_generic_handler(
             'meshtrade.iam.group.v1.GroupService', rpc_method_handlers)
@@ -86,10 +157,20 @@ def add_GroupServiceServicer_to_server(servicer, server):
 
  # This class is part of an EXPERIMENTAL API.
 class GroupService(object):
-    """Missing associated documentation comment in .proto file."""
+    """
+    GroupService manages organizational group hierarchy and lifecycle operations.
+
+    Groups are the fundamental multi-tenancy units in Mesh that own resources,
+    define permission boundaries, and enable hierarchical access control.
+    Each group can own sub-groups, users, API users, and platform resources,
+    forming tree structures for inherited permissions and resource isolation.
+
+    All operations are scoped to the authenticated group's hierarchy and
+    require appropriate IAM domain permissions.
+    """
 
     @staticmethod
-    def GetGroup(request,
+    def CreateGroup(request,
             target,
             options=(),
             channel_credentials=None,
@@ -102,8 +183,35 @@ class GroupService(object):
         return grpc.experimental.unary_unary(
             request,
             target,
-            '/meshtrade.iam.group.v1.GroupService/GetGroup',
-            meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.GetGroupRequest.SerializeToString,
+            '/meshtrade.iam.group.v1.GroupService/CreateGroup',
+            meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.CreateGroupRequest.SerializeToString,
+            meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2.Group.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def UpdateGroup(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/meshtrade.iam.group.v1.GroupService/UpdateGroup',
+            meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.UpdateGroupRequest.SerializeToString,
             meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2.Group.FromString,
             options,
             channel_credentials,
@@ -168,3 +276,30 @@ class GroupService(object):
             timeout,
             metadata,
             _registered_method=True)
+
+    @staticmethod
+    def GetGroup(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/meshtrade.iam.group.v1.GroupService/GetGroup',
+            meshtrade_dot_iam_dot_group_dot_v1_dot_service__pb2.GetGroupRequest.SerializeToString,
+            meshtrade_dot_iam_dot_group_dot_v1_dot_group__pb2.Group.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

meshtrade/iam/role/v1/__init__.py

@@ -13,7 +13,7 @@
 # ===================================================================
 
 # Generated protobuf imports
-from .role_pb2 import Role, RoleList
+from .role_pb2 import Role
 
 # ===================================================================
 # END OF AUTO-GENERATED SECTION
@@ -29,7 +29,15 @@ from .role_pb2 import Role, RoleList
 #
 # ===================================================================
 
-from .role import full_resource_name_from_group_name
+from .role import (
+    must_parse_role_parts,
+    parse_role_parts,
+    role_from_full_resource_name,
+    role_full_resource_name_from_group,
+    role_full_resource_name_from_group_id,
+    role_is_valid,
+    role_is_valid_and_specified,
+)
 
 # ===================================================================
 # MODULE EXPORTS
@@ -38,7 +46,12 @@ from .role import full_resource_name_from_group_name
 __all__ = [
     # Generated exports
     "Role",
-    "RoleList",
     # Manual exports
-    "full_resource_name_from_group_name",
+    "must_parse_role_parts",
+    "parse_role_parts",
+    "role_from_full_resource_name",
+    "role_full_resource_name_from_group",
+    "role_full_resource_name_from_group_id",
+    "role_is_valid",
+    "role_is_valid_and_specified",
 ]