The secretstorage.item module

SecretStorage item contains a secret, some attributes and a label visible to user. Editing all these properties and reading the secret is possible only when the collection storing the item is unlocked. The collection can be unlocked using collection’s unlock() method.

class secretstorage.item.Item(bus, item_path, session=None)

Represents a secret item.

delete()

Deletes the item.

ensure_not_locked()

If collection is locked, raises LockedException.

get_attributes()

Returns item attributes (dictionary).

get_created()

Returns UNIX timestamp (integer) representing the time when the item was created.

get_label()

Returns item label (unicode string).

get_modified()

Returns UNIX timestamp (integer) representing the time when the item was last modified.

get_secret()

Returns item secret (bytestring).

get_secret_content_type()

Returns content type of item secret (string).

is_locked()

Returns True if item is locked, otherwise False.

set_attributes(attributes)

Sets item attributes to attributes (dictionary).

set_label(label)

Sets item label to label.

set_secret(secret, content_type='text/plain')

Sets item secret to secret. If content_type is given, also sets the content type of the secret (text/plain by default).

to_tuple()

Returns (attributes, secret) tuple representing the item.