Add back group get function

Author: edif2008

src/onepassword/client.py

@@ -8,12 +8,14 @@
 from .secrets import Secrets
 from .items import Items
 from .vaults import Vaults
+from .groups import Groups
 
 
 class Client:
     secrets: Secrets
     items: Items
     vaults: Vaults
+    groups: Groups
 
     @classmethod
     async def authenticate(
@@ -37,6 +39,7 @@ async def authenticate(
         authenticated_client.secrets = Secrets(client_id, core)
         authenticated_client.items = Items(client_id, core)
         authenticated_client.vaults = Vaults(client_id, core)
+        authenticated_client.vaults = Groups(client_id, core)
 
         authenticated_client._finalizer = weakref.finalize(
             cls, core.release_client, client_id

src/onepassword/groups.py

@@ -0,0 +1,34 @@
+# Code generated by op-codegen - DO NO EDIT MANUALLY
+
+from .core import Core
+from pydantic import TypeAdapter
+from .types import Group, GroupGetParams
+
+
+class Groups:
+    """
+    The Groups API holds all the operations the SDK client can perform on 1Password groups.
+    """
+
+    def __init__(self, client_id, core: Core):
+        self.client_id = client_id
+        self.core = core
+
+    async def get(self, group_id: str, group_params: GroupGetParams) -> Group:
+        response = await self.core.invoke(
+            {
+                "invocation": {
+                    "clientId": self.client_id,
+                    "parameters": {
+                        "name": "GroupsGet",
+                        "parameters": {
+                            "group_id": group_id,
+                            "group_params": group_params.model_dump(by_alias=True),
+                        },
+                    },
+                }
+            }
+        )
+
+        response = TypeAdapter(Group).validate_json(response)
+        return response

src/onepassword/types.py

@@ -140,41 +140,114 @@ class GeneratePasswordResponse(BaseModel):
     """
 
 
-class GroupAccess(BaseModel):
+class GroupType(str, Enum):
+    OWNERS = "owners"
+    """
+    The owners group, which gives the following permissions:
+    - Do everything the Admin group can do
+    - See every vault other than the personal vaults
+    - Change people's names
+    - See billing
+    - Change billing
+    - Make other people owners
+    - Delete a person
+    """
+    ADMINISTRATORS = "administrators"
+    """
+    The administrators group, which gives the following permissions:
+    - Perform recovery
+    - Create new vaults
+    - Invite new members
+    - See vault metadata, including the vault name and who has access.
+    - Make other people admins
+    """
+    RECOVERY = "recovery"
+    """
+    The recovery group. It contains recovery keysets, and is added to every vault to allow for recovery.
+    
+    No one is added to this.
+    """
+    EXTERNALACCOUNTMANAGERS = "externalAccountManagers"
+    """
+    The external account managers group or EAM is a mandatory group for managed accounts that has
+    same permissions as the owners.
+    """
+    TEAMMEMBERS = "teamMembers"
+    """
+    Members of a team that a user is on.
     """
-    Represents a group's access to a 1Password vault.
-    This is used for granting permissions
+    USERDEFINED = "userDefined"
     """
+    A custom, user defined group.
+    """
+    UNSUPPORTED = "unsupported"
+    """
+    Support for new or renamed group types
+    """
+
 
-    group_id: str
+class GroupState(str, Enum):
+    ACTIVE = "active"
     """
-    The group's ID
+    This group is active
     """
-    permissions: int
+    DELETED = "deleted"
+    """
+    This group has been deleted
+    """
+    UNSUPPORTED = "unsupported"
     """
-    The group's set of permissions for the vault
+    This group is in an unknown state
     """
 
 
-class GroupVaultAccess(BaseModel):
+class VaultAccessorType(str, Enum):
+    USER = "user"
+    GROUP = "group"
+
+
+class VaultAccess(BaseModel):
     """
-    Represents a group's access to a 1Password vault.
+    Represents the vault access information.
     """
 
-    vault_id: str
+    model_config = ConfigDict(populate_by_name=True)
+
+    vault_uuid: str = Field(alias="vaultUuid")
+    """
+    The vault's UUID.
+    """
+    accessor_type: VaultAccessorType = Field(alias="accessorType")
     """
-    The vault's ID
+    The vault's accessor type.
     """
-    group_id: str
+    accessor_uuid: str = Field(alias="accessorUuid")
     """
-    The group's ID
+    The vault's accessor UUID.
     """
     permissions: int
     """
-    The group's set of permissions for the vault
+    The permissions granted to this vault
     """
 
 
+class Group(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    id: str
+    title: str
+    description: str
+    group_type: GroupType = Field(alias="groupType")
+    state: GroupState
+    vault_access: Optional[List[VaultAccess]] = Field(alias="vaultAccess", default=None)
+
+
+class GroupGetParams(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    vault_permissions: Optional[bool] = Field(alias="vaultPermissions", default=None)
+
+
 class ItemCategory(str, Enum):
     LOGIN = "Login"
     SECURENOTE = "SecureNote"
@@ -1154,36 +1227,6 @@ class VaultType(str, Enum):
     UNSUPPORTED = "unsupported"
 
 
-class VaultAccessorType(str, Enum):
-    USER = "user"
-    GROUP = "group"
-
-
-class VaultAccess(BaseModel):
-    """
-    Represents the vault access information.
-    """
-
-    model_config = ConfigDict(populate_by_name=True)
-
-    vault_uuid: str = Field(alias="vaultUuid")
-    """
-    The vault's UUID.
-    """
-    accessor_type: VaultAccessorType = Field(alias="accessorType")
-    """
-    The vault's accessor type.
-    """
-    accessor_uuid: str = Field(alias="accessorUuid")
-    """
-    The vault's accessor UUID.
-    """
-    permissions: int
-    """
-    The permissions granted to this vault
-    """
-
-
 class Vault(BaseModel):
     """
     Represents regular vault information together with the vault's access information.