Python SDK v0.3.0

example/example.py

@@ -25,17 +25,26 @@ async def main():
     # [developer-docs.sdk.python.client-initialization]-end
 
     # [developer-docs.sdk.python.list-vaults]-start
-    vaults = await client.vaults.list_all()
-    async for vault in vaults:
+    vaults = await client.vaults.list()
+    for vault in vaults:
         print(vault.title)
     # [developer-docs.sdk.python.list-vaults]-end
 
     # [developer-docs.sdk.python.list-items]-start
-    items = await client.items.list_all(vault.id)
-    async for item in items:
-        print(item.title)
+    overviews = await client.items.list(vault.id)
+    for overview in overviews:
+        print(overview.title)
     # [developer-docs.sdk.python.list-items]-end
-
+    # [developer-docs.sdk.python.list-archived-items]-start
+    archived_overviews = await client.items.list(
+        vault.id,
+        ItemListFilterByState(
+            content=ItemListFilterByStateInner(active=False, archived=True)
+        ),
+    )
+    for overview in archived_overviews:
+        print(overview.title)
+    # [developer-docs.sdk.python.list-archived-items]-end
     # [developer-docs.sdk.python.validate-secret-reference]-start
     # Validate secret reference to ensure no syntax errors
     try:
@@ -175,24 +184,22 @@ async def main():
     print(random_password)
     # [developer-docs.sdk.python.generate-random-password]-end
 
-    await share_item(client, created_item.vault_id, updated_item.id)
+    await share_item(client, updated_item.vault_id, updated_item.id)
 
     await create_ssh_key_item(client, vault_id)
 
     await create_and_replace_document_item(client, vault_id)
 
     await create_attach_and_delete_file_field_item(client, vault_id)
 
+    await archive_item(client, updated_item.vault_id, updated_item.id)
+
     # [developer-docs.sdk.python.delete-item]-start
     # Delete a item from your vault.
     await client.items.delete(created_item.vault_id, updated_item.id)
     # [developer-docs.sdk.python.delete-item]-end
 
 
-## NOTE: this is in a separate function to avoid creating a new item
-## NOTE: just for the sake of archiving it. This is because the SDK
-## NOTE: only works with active items, so archiving and then deleting
-## NOTE: is not yet possible.
 async def archive_item(client: Client, vault_id: str, item_id: str):
     # [developer-docs.sdk.python.archive-item]-start
     # Archive a item from your vault.

src/onepassword/build_number.py

@@ -1 +1 @@
-SDK_BUILD_NUMBER = "0020101"
+SDK_BUILD_NUMBER = "0030001"

src/onepassword/items.py

@@ -1,12 +1,11 @@
 # Code generated by op-codegen - DO NO EDIT MANUALLY
 
 from .core import _invoke, _invoke_sync
-from .iterator import SDKIterator
 from typing import Optional, List
 from pydantic import TypeAdapter
 from .items_shares import ItemsShares
 from .items_files import ItemsFiles
-from .types import Item, ItemCreateParams, ItemOverview
+from .types import Item, ItemCreateParams, ItemListFilter, ItemOverview
 
 
 class Items:
@@ -81,7 +80,7 @@
         """
         Delete an item.
         """
         response = await _invoke(
             {
                 "invocation": {
                     "clientId": self.client_id,
@@ -99,7 +98,7 @@
         """
         Archive an item.
         """
         response = await _invoke(
             {
                 "invocation": {
                     "clientId": self.client_id,
@@ -113,21 +112,24 @@
 
         return None
 
-    async def list_all(self, vault_id: str) -> SDKIterator[ItemOverview]:
+    async def list(self, vault_id: str, *filters: ItemListFilter) -> List[ItemOverview]:
         """
-        List all items
+        List items based on filters.
         """
         response = await _invoke(
             {
                 "invocation": {
                     "clientId": self.client_id,
                     "parameters": {
-                        "name": "ItemsListAll",
-                        "parameters": {"vault_id": vault_id},
+                        "name": "ItemsList",
+                        "parameters": {
+                            "vault_id": vault_id,
+                            "filters": [o.model_dump(by_alias=True) for o in filters],
+                        },
                     },
                 }
             }
         )
 
         response = TypeAdapter(List[ItemOverview]).validate_json(response)
-        return SDKIterator(response)
+        return response

src/onepassword/items_files.py

@@ -1,7 +1,6 @@
 # Code generated by op-codegen - DO NO EDIT MANUALLY
 
 from .core import _invoke, _invoke_sync
-from .iterator import SDKIterator
 from typing import Optional, List
 from pydantic import TypeAdapter
 from .types import DocumentCreateParams, FileAttributes, FileCreateParams, Item

src/onepassword/items_shares.py

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

src/onepassword/secrets.py

@@ -1,8 +1,7 @@
 # Code generated by op-codegen - DO NO EDIT MANUALLY
 
 from .core import _invoke, _invoke_sync
-from .iterator import SDKIterator
 from typing import Optional, List
 from pydantic import TypeAdapter
 from .types import GeneratePasswordResponse, PasswordRecipe, ResolveAllResponse
 

src/onepassword/types.py

@@ -330,6 +330,21 @@ class ItemFile(BaseModel):
     """
 
 
+class ItemState(str, Enum):
+    """
+    Represents the state of an item in the SDK.
+    """
+
+    ACTIVE = "active"
+    """
+    The item is active
+    """
+    ARCHIVED = "archived"
+    """
+    The item is archived meaning it's hidden from regular view and stored in the archive.
+    """
+
+
 class Item(BaseModel):
     """
     Represents a 1Password item.
@@ -401,6 +416,10 @@ class Item(BaseModel):
     """
     The time the item was updated at
     """
+    state: ItemState
+    """
+    Indicates the state of the item
+    """
 
 
 class ItemCreateParams(BaseModel):
@@ -495,6 +514,10 @@ class ItemOverview(BaseModel):
     """
     The time the item was updated at
     """
+    state: ItemState
+    """
+    Indicates the state of the item
+    """
 
 
 class ItemShareDuration(str, Enum):
@@ -967,6 +990,27 @@ class VaultOverview(BaseModel):
     """
 
 
+class ItemListFilterByStateInner(BaseModel):
+    """
+    Generated type representing the anonymous struct variant `ByState` of the `ItemListFilter` Rust enum
+    """
+
+    active: bool
+    archived: bool
+
+
+class ItemListFilterTypes(str, Enum):
+    BY_STATE = "ByState"
+
+
+class ItemListFilterByState(BaseModel):
+    type: Literal[ItemListFilterTypes.BY_STATE] = ItemListFilterTypes.BY_STATE
+    content: ItemListFilterByStateInner
+
+
+ItemListFilter = ItemListFilterByState
+
+
 class PasswordRecipeMemorableInner(BaseModel):
     """
     Generated type representing the anonymous struct variant `Memorable` of the `PasswordRecipe` Rust enum

src/onepassword/vaults.py

@@ -1,7 +1,6 @@
 # Code generated by op-codegen - DO NO EDIT MANUALLY
 
 from .core import _invoke, _invoke_sync
-from .iterator import SDKIterator
 from typing import Optional, List
 from pydantic import TypeAdapter
 from .types import VaultOverview
@@ -15,18 +14,18 @@ class Vaults:
     def __init__(self, client_id):
         self.client_id = client_id
 
-    async def list_all(self) -> SDKIterator[VaultOverview]:
+    async def list(self) -> List[VaultOverview]:
         """
         List all vaults
         """
         response = await _invoke(
             {
                 "invocation": {
                     "clientId": self.client_id,
-                    "parameters": {"name": "VaultsListAll", "parameters": {}},
+                    "parameters": {"name": "VaultsList", "parameters": {}},
                 }
             }
         )
 
         response = TypeAdapter(List[VaultOverview]).validate_json(response)
-        return SDKIterator(response)
+        return response

src/release/RELEASE-NOTES

@@ -1,20 +1,59 @@
-# 1Password Python SDK v0.2.1
+# 1Password Python SDK v0.3.0
 
 ## NEW
 
-- **`CreatedAt` and `UpdatedAt` item metadata:** Items and item overviews now expose attributes with their creation and last edit times.
-- **Resolving secrets in bulk**: With the `client.secrets.resolveAll` function, the SDK is now able to resolve multiple secrets at once, improving the performance of the operation.
+- **Support for item states**: You can now fetch an item's state using the SDK. `Item` and `ItemOverview` expose two states: `Active` and`Archived`.
+    - `Active`: An item located inside a vault. (Default)
+    - `Archived`: An item that has been moved to the Archive. 1Password doesn't include archived items in search results or suggest them when you fill in apps and browsers. You can keep archived items as long as you'd like.
+- **Filtering the return of item listing by state**: You can now filter the listed items by item state. The current exposed filter is `ByState`, which allows devs to filter `ItemOverviews` by their `State` .
 
 ## IMPROVED
 
-- **Support for new field types:** Items with `Address` and `Date` fields can now be created, retrieved, and edited using the 1Password SDK.
-- **Item sharing for attachments and documents**: Items with files attached now can also be shared using the `client.items.shares` functions.
-- **Adding custom fields in sections automatically**: The SDK now automatically adds custom fields without a section to an empty section within the item, creating it if necessary.
-- **`Tags` in item overviews**: The return type of `items.listAll` now also contains the item tags.
-- **Broader item editing capabilities**: You are now able to use the `items.put` function on more items, including those with fields that are not directly editable through the SDK (such as legacy fields, passkeys etc.)
+- **Improved Deleting Capabilities:** You can now delete `Archived` items in the SDKs.
 
-## FIXED
+### ⚠️ BREAKING CHANGES ⚠️
 
-- **Improvements to resolving secret references:**
-    - Archived items are no longer used for secret references.
-    - When multiple sections match a section query in resolving secret references, the SDK look through the fields in all sections, instead of erroring.
+This release contains a breaking change for the Go SDK.
+
+`items.list_all()` has changed to `items.list()` and below is how to migrate.
+
+Before:
+```python
+overviews = await client.items.list_all(vault_id)
+# To iterate through this you can do the following:
+async for overview in overviews:
+        print(overview.ID)
+```
+
+After:
+
+```python
+overviews = await client.items.list(vault_id, ItemListFilter(
+                content=ItemListFilterByStateInner(
+                    active=active,
+                    archived=archived
+                )
+            ))
+# to iterate through it you can do the following:
+for overview in overviews:
+   print(overview.ID)
+```
+`vaults.list_all()` has changed to `vaults.list()` and the migration guide is below:
+
+Before:
+```python
+    vaults = await client.vaults.list_all()
+    async for vault in vaults:
+        print(vault.title)
+```
+
+After:
+```python
+    vaults = await client.vaults.list()
+    for vault in vaults:
+        print(vault.title)
+```
+
+*  All functions that return an Iterator will now return the appropriate list type.
+
+This does not affect any code already deployed, and will not take effect in your codebase until you choose to update to v0.3.0+ of the 1Password Python SDK 

version.py

@@ -1 +1 @@
-SDK_VERSION = "0.2.1"
+SDK_VERSION = "0.3.0"