|
1 | | -# 1Password Python SDK v0.3.0 |
| 1 | +# 1Password Python SDK v0.3.1 |
2 | 2 |
|
3 | 3 | ## NEW |
4 | 4 |
|
5 | | -- **Support for item states**: You can now fetch an item's state using the SDK. `ItemOverview` exposes one of two states: `Active` or `Archived`. |
6 | | - - `Active`: An item located inside a vault. (Default) |
7 | | - - `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. |
8 | | -- **Filtering listed items by state**: You can now filter the results of the item list function by item state. |
9 | | - |
10 | | -## FIXED |
11 | | - |
12 | | -- **Deleting Archived Items:** The SDK now supports deleting items from the archive. |
13 | | - |
14 | | -## ⚠️ BREAKING CHANGES ⚠️ |
15 | | -This release contains breaking changes for two functions in the Python SDK. |
16 | | - |
17 | | -**Vault listing** |
18 | | - |
19 | | -* The function name has changed from `list_all` to `list`. To use this in your code, replace: |
20 | | -```python |
21 | | -vaults = await client.vaults.list_all(vault_id) |
22 | | -``` |
23 | | -with: |
24 | | -```python |
25 | | -vaults = await client.vaults.list(vault_id) |
26 | | -``` |
27 | | - |
28 | | -* The return type of the vault listing function has changed from `SDKIterator[VaultOverview]` to `List[VaultOverview]`. To use this in your code, replace: |
29 | | - |
30 | | -```python |
31 | | -async for vault in vaults: |
32 | | - # using vault overview |
33 | | -``` |
34 | | -with: |
35 | | -```python |
36 | | -for vault in vaults: |
37 | | - # using vault overview |
38 | | -``` |
39 | | -**Item listing** |
40 | | - |
41 | | -* The function name has changed from `ListAll` to `List`. To use this in your code, replace: |
42 | | -```python |
43 | | -overviews = await client.items.list_all(vault_id) |
44 | | -``` |
45 | | -with: |
46 | | -```python |
47 | | -overviews = await client.items.list(vault_id, ItemListFilter( |
48 | | - content=ItemListFilterByStateInner( |
49 | | - active=True, |
50 | | - archived=True, |
51 | | - ) |
52 | | - )) |
53 | | -``` |
54 | | - |
55 | | -* The return type of the item listing function has changed from `SDKIterator[ItemOverview]` to `List[ItemOverview]`. To use this in your code, replace: |
56 | | -```python |
57 | | -async for overview in overviews: |
58 | | - # using item overview |
59 | | -``` |
60 | | -with: |
61 | | -```python |
62 | | -for overview in overviews: |
63 | | - # using item overview |
64 | | -``` |
65 | | - |
66 | | -This does not affect any code that's already deployed, and will not take effect in your codebase until you choose to update to version 0.3.0 or later of the 1Password Python SDK. |
| 5 | +- `VaultOverview` now includes `created_at` and `updated_at` fields that show when the vault was created and last updated. |
0 commit comments