1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
# SecretStorage module for Python
# Access passwords using the SecretService DBus API
# Author: Dmitry Shachnev, 2012-2018
# License: 3-clause BSD, see LICENSE file
"""All secretstorage functions may raise various exceptions when
something goes wrong. All exceptions derive from base
:exc:`SecretStorageException` class."""
class SecretStorageException(Exception):
"""All exceptions derive from this class."""
class SecretServiceNotAvailableException(SecretStorageException):
"""Raised by :class:`~secretstorage.item.Item` or
:class:`~secretstorage.collection.Collection` constructors, or by
other functions in the :mod:`secretstorage.collection` module, when
the Secret Service API is not available."""
class LockedException(SecretStorageException):
"""Raised when an action cannot be performed because the collection
is locked. Use :meth:`~secretstorage.collection.Collection.is_locked`
to check if the collection is locked, and
:meth:`~secretstorage.collection.Collection.unlock` to unlock it.
"""
class ItemNotFoundException(SecretStorageException):
"""Raised when an item does not exist or has been deleted. Example of
handling:
>>> import secretstorage
>>> connection = secretstorage.dbus_init()
>>> item_path = '/not/existing/path'
>>> try:
... item = secretstorage.Item(connection, item_path)
... except secretstorage.ItemNotFoundException:
... print('Item not found!')
...
Item not found!
"""
class PromptDismissedException(ItemNotFoundException):
"""Raised when a prompt was dismissed by the user.
.. versionadded:: 3.1
"""
|
