Merge pull request #181 from 1Password/sdk-core/beta/2025-10-14-3260001c

Make private beta features visible for private beta testers

Author: AndyTitu

example/desktop_app.py

@@ -8,7 +8,7 @@ async def main():
     # Connects to the 1Password desktop app.
     client = await Client.authenticate(
         auth=DesktopAuth(
-            account_name="YourAccountNameAsItAppearsInTheApp"  # Set to your 1Password account name.
+            account_name="YouAccountNameAsShownInDesktopApp"  # Set to your 1Password account name.
         ),
         # Set the following to your own integration name and version.
         integration_name="My 1Password Integration",
@@ -22,7 +22,7 @@ async def main():
     # [developer-docs.sdk.python.list-vaults]-end
 
     # [developer-docs.sdk.python.list-items]-start
-    overviews = await client.items.list(vault.id)
+    overviews = await client.items.list(vault_id=vaults[0].id)
     for overview in overviews:
         print(overview.title)
     # [developer-docs.sdk.python.list-items]-end

src/onepassword/__init__.py

@@ -7,6 +7,7 @@
 from .secrets import Secrets
 from .items import Items
 from .vaults import Vaults
+from .groups import Groups
 
 
 import sys
@@ -18,6 +19,7 @@
     "Secrets",
     "Items",
     "Vaults",
+    "Groups",
     "DEFAULT_INTEGRATION_NAME",
     "DEFAULT_INTEGRATION_VERSION",
     "DesktopAuth",

src/onepassword/client.py

@@ -2,18 +2,20 @@
 
 from __future__ import annotations
 import weakref
-from .core import Core, UniffiCore
+from .core import UniffiCore
 from .desktop_core import DesktopCore
 from .defaults import new_default_config, DesktopAuth
 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,8 @@ 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.groups = Groups(client_id, core)
+
         authenticated_client._finalizer = weakref.finalize(
             cls, core.release_client, client_id
         )

src/onepassword/defaults.py

@@ -32,7 +32,7 @@ def new_default_config(auth: DesktopAuth | str, integration_name, integration_ve
         "osVersion": DEFAULT_OS_VERSION,
         "architecture": platform.machine(),
     }
-    if isinstance(auth, str):
+    if not isinstance(auth, DesktopAuth):
         client_config_dict["serviceAccountToken"] = auth
 
     return client_config_dict

src/onepassword/desktop_core.py

@@ -5,7 +5,6 @@
 import base64
 from pathlib import Path
 from ctypes import c_uint8, c_size_t, c_int32, POINTER, byref, c_void_p
-from .core import UniffiCore
 from onepassword.errors import raise_typed_exception
 
 

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/items.py

@@ -1,18 +1,27 @@
 # Code generated by op-codegen - DO NO EDIT MANUALLY
 
-from typing import Optional, List
+from .core import Core
+from typing import List
 from pydantic import TypeAdapter
 from .items_shares import ItemsShares
 from .items_files import ItemsFiles
-from .types import Item, ItemCreateParams, ItemListFilter, ItemOverview
+from .types import (
+    Item,
+    ItemCreateParams,
+    ItemListFilter,
+    ItemOverview,
+    ItemsDeleteAllResponse,
+    ItemsGetAllResponse,
+    ItemsUpdateAllResponse,
+)
 
 
 class Items:
     """
     The Items API holds all operations the SDK client can perform on 1Password items.
     """
 
-    def __init__(self, client_id, core):
+    def __init__(self, client_id, core: Core):
         self.client_id = client_id
         self.core = core
         self.shares = ItemsShares(client_id, core)
@@ -37,6 +46,30 @@ async def create(self, params: ItemCreateParams) -> Item:
         response = TypeAdapter(Item).validate_json(response)
         return response
 
+    async def create_all(
+        self, vault_id: str, params: List[ItemCreateParams]
+    ) -> ItemsUpdateAllResponse:
+        """
+        Create items in batch, within a single vault.
+        """
+        response = await self.core.invoke(
+            {
+                "invocation": {
+                    "clientId": self.client_id,
+                    "parameters": {
+                        "name": "ItemsCreateAll",
+                        "parameters": {
+                            "vault_id": vault_id,
+                            "params": [o.model_dump(by_alias=True) for o in params],
+                        },
+                    },
+                }
+            }
+        )
+
+        response = TypeAdapter(ItemsUpdateAllResponse).validate_json(response)
+        return response
+
     async def get(self, vault_id: str, item_id: str) -> Item:
         """
         Get an item by vault and item ID
@@ -56,6 +89,25 @@ async def get(self, vault_id: str, item_id: str) -> Item:
         response = TypeAdapter(Item).validate_json(response)
         return response
 
+    async def get_all(self, vault_id: str, item_ids: List[str]) -> ItemsGetAllResponse:
+        """
+        Get items by vault and their item IDs.
+        """
+        response = await self.core.invoke(
+            {
+                "invocation": {
+                    "clientId": self.client_id,
+                    "parameters": {
+                        "name": "ItemsGetAll",
+                        "parameters": {"vault_id": vault_id, "item_ids": item_ids},
+                    },
+                }
+            }
+        )
+
+        response = TypeAdapter(ItemsGetAllResponse).validate_json(response)
+        return response
+
     async def put(self, item: Item) -> Item:
         """
         Update an existing item.
@@ -93,6 +145,27 @@ async def delete(self, vault_id: str, item_id: str) -> None:
 
         return None
 
+    async def delete_all(
+        self, vault_id: str, item_ids: List[str]
+    ) -> ItemsDeleteAllResponse:
+        """
+        Create items in batch, within a single vault.
+        """
+        response = await self.core.invoke(
+            {
+                "invocation": {
+                    "clientId": self.client_id,
+                    "parameters": {
+                        "name": "ItemsDeleteAll",
+                        "parameters": {"vault_id": vault_id, "item_ids": item_ids},
+                    },
+                }
+            }
+        )
+
+        response = TypeAdapter(ItemsDeleteAllResponse).validate_json(response)
+        return response
+
     async def archive(self, vault_id: str, item_id: str) -> None:
         """
         Archive an item.

src/onepassword/items_files.py

@@ -1,13 +1,13 @@
 # Code generated by op-codegen - DO NO EDIT MANUALLY
 
 from .core import Core
-from typing import Optional, List
+from typing import List
 from pydantic import TypeAdapter
 from .types import DocumentCreateParams, FileAttributes, FileCreateParams, Item
 
 
 class ItemsFiles:
-    def __init__(self, client_id, core):
+    def __init__(self, client_id, core: Core):
         self.client_id = client_id
         self.core = core
 

src/onepassword/items_shares.py

@@ -1,6 +1,6 @@
 # Code generated by op-codegen - DO NO EDIT MANUALLY
 
-from typing import Optional, List
+from typing import List
 from pydantic import TypeAdapter
 from .types import Item, ItemShareAccountPolicy, ItemShareParams, ValidRecipient