Release 0.1.6

NEW

• Support for item sharing: You can now create an item sharing link via the 1Password SDKs using the new client.items.shares API.
• Support for item archiving: You can now move items to the archive with the SDKs, using the new client.items.archive(vault_uuid, item_uuid) function.

IMPROVED

• Support for item notes: You can now read, create and edit items with a notes field, accessing it via item.notes.
• Support for SSH key attributes in secret references: You can now retrieve an SSH key's public key, key type and fingerprint with client.secrets.resolve.
• Support for additional field types: You can now read, create and edit items with Email (email addresses) and Reference (ID references to other 1Password items) type fields.
• Type hinting: When developing with the Python SDK, the functions now show type hints on their parameters and return types.

FIXED

• Improved field matching logic for secret references: Retrieving a field from the item's default field section is now possible even if there is an identically named field in one of the item's named sections.

Release 0.1.5

Version 0.1.5 of the 1Password Python SDK brings:

• Support for generating passwords. You can now generate random, PIN, and memorable passwords using the onepassword.Secrets.generate_password function.
• Support for item subtitles. Creating and editing an item now sets the subtitle correctly, which is visible in the item preview in all client apps.
• Support for the Credit Card Number field type. You can now retrieve, create, and edit items containing credit card numbers.

Release 0.1.4

The v0.1.4 release of the Python SDK brings:

• Support for validating secret references. You can now check that a secret reference is formatted correctly without having to resolve it or even authenticate, using the 'ValidateSecretReference' function.

Release 0.1.3

The v0.1.3 release of the Python SDK brings:

• Support for item websites. You can now create, get, and edit websites within your 1Password items using item CRUD functions.

Release 0.1.2

The v0.1.2 release of the Python SDK brings:

• Support for item tags. You can now create, get, and edit tags within your 1Password items using item CRUD functions.
• Support for fetching one-time password codes using secret references. You can now fetch your TOTP code with the secrets.resolve function, using a secret reference for the TOTP field in your item. For example: op://vault/item/field?=attribute=totp
• PyPI wheels for the Python SDK. You can now install the Python SDK via pip install onepassword-sdk
• Full support for optional values. You no longer have to manually set details: None or section: None when instantiating ItemCreateParams.
• Item creation now only requires specifying the vault ID, item category, and item title.

Release 0.1.1

This is the v0 release of the 1Password Python SDK.

The 1Password Python SDK allows you to build secrets management integrations that can programmatically access secrets stored in 1Password. With this SDK, you can:

• Securely load secrets from 1Password into your code with secret references.
• Read, write, and update secrets stored in 1Password, including passwords, API keys, and one-time passwords.
• List items and vaults in a 1Password account.

Release v0.1.0-beta.13

In this release:

• support for listing items and vaults is introduced
• a bug where concurrent item updates could lead to unexpected overwrites is fixed
• a bug where the SDK was priorly not working with service account tokens generated by the 1Password CLI is fixed
• a bug where the items created by the SDK priorly did not have the password strength set correctly is fixed

Public beta 0.1.0-beta.12

This release includes:

• Support for reading and writing OTP field information such as the TOTP code and seed, through the Item API.
• The Update operation is renamed to Put to create more realistic expectation with regard to the effect of the operation.
• The item creation operation now takes as input ItemCreateParams.
• Support for a few more field types: Phone, Url, CreditCardType.

NOTE This release contains breaking changes:

Wherever you were using

item = await client.items.update(item)

you must now use

item = await client.items.put(item)

and wherever you were using:

to_create = Item(
        id="",
        title="MyName",
        category="Login",
        vault_id="q73bqltug6xoegr3wkk2zkenoq",
        fields=[],
        sections=[])

item = await client.items.create(to_create)

you must now use

params = ItemCreateParams(
        title="MyName",
        category="Login",
        vault_id="q73bqltug6xoegr3wkk2zkenoq",
        fields=[],
        sections=[])

item = await client.items.create(params)

Public beta v0.1.0-beta.11

This release fixes IDE errors shown for the Python SDK when using items and secrets APIs.

[FIXED] All SDK namespaces, function names and types get picked up in the IDE, and don't get misclassified as errors.

Public Beta 0.1.0-beta.10

This release removes some misguiding code comments.