File: //usr/lib/python3/dist-packages/secretstorage/__pycache__/collection.cpython-310.pyc
o
j�_� � @ sN d Z ddlmZmZmZ ddlmZ ddlmZm Z ddl
m Z ddl m
Z
mZmZ ddlmZ ddlmZmZmZmZmZ ed Zed
Zd Zd ZG d
d � d e �Z d"dede de dee de f
dd�Z dedee fdd�Z d#dedee de fdd�Z!dede fdd �Z"dede de fd d �Z#ded ee e f dee fd d!�Z$dS )$ar Collection is a place where secret items are stored. Normally, only
the default collection should be used, but this module allows to use any
registered collection. Use :func:`get_default_collection` to get the
default collection (and create it, if necessary).
Collections are usually automatically unlocked when user logs in, but
collections can also be locked and unlocked using
:meth:`Collection.lock` and :meth:`Collection.unlock` methods (unlocking
requires showing the unlocking prompt to user and can be synchronous or
asynchronous). Creating new items and editing existing ones is possible
only in unlocked collection.� )�Dict�Iterator�Optional)�DBusConnection)� SS_PREFIX�SS_PATH)�Session)�LockedException�ItemNotFoundException�PromptDismissedException)�Item)�DBusAddressWrapper� exec_prompt�
format_secret� open_session�unlock_objects�
Collection�Servicez(/org/freedesktop/secrets/aliases/defaultz+/org/freedesktop/secrets/collection/sessionc
@ s� e Zd ZdZedfdededee ddfdd�Z de
fd d
�Z d$d d �Z de
fd
d�Z
d$dd�Zd$dd�Zdee fdd�Zdeeef dee fdd�Zdefdd�Zdeddfdd �Z d%dedeeef d ed e
d!edef d"d#�ZdS )&r zRepresents a collection.N�
connection�collection_path�session�returnc C s0 || _ || _|| _t|t|�| _| j�d� d S )N�Label)r r r r
�COLLECTION_IFACE� _collection� get_property)�selfr r r � r �:/usr/lib/python3/dist-packages/secretstorage/collection.py�__init__$ s �zCollection.__init__c C s t | j�d��S )zDReturns :const:`True` if item is locked, otherwise
:const:`False`.�Locked)�boolr r �r r r r � is_locked. s zCollection.is_lockedc C s | � � rtd��dS )zSIf collection is locked, raises
:exc:`~secretstorage.exceptions.LockedException`.zCollection is locked!N)r# r r" r r r �ensure_not_locked3 s �z Collection.ensure_not_lockedc C s t | j| jg�S )a Requests unlocking the collection.
Returns a boolean representing whether the prompt has been
dismissed; that means :const:`False` on successful unlocking
and :const:`True` if it has been dismissed.
.. versionchanged:: 3.0
No longer accepts the ``callback`` argument.
)r r r r" r r r �unlock9 s
zCollection.unlockc C s$ t tt| j�}|�dd| jg� dS )zLocks the collection.�Lock�aoN)r
r �
SERVICE_IFACEr �callr )r �servicer r r �lockE s zCollection.lockc C sD | � � | j�dd�\}|dkr t| j|�\}}|r td��dS dS )z/Deletes the collection and all items inside it.�Delete� �/�Prompt dismissed.N)r$ r r) r r r )r �prompt� dismissed�_resultr r r �deleteJ s �zCollection.deletec c s* � | j �d�D ] }t| j|| j�V qdS )z3Returns a generator of all items in the collection.�ItemsN)r r r r r )r � item_pathr r r �
get_all_itemsS s ��zCollection.get_all_items�
attributesc c s4 � | j �dd|�\}|D ] }t| j|| j�V q dS )z^Returns a generator of items with the given attributes.
`attributes` should be a dictionary.� SearchItems�a{ss}N)r r) r r r )r r7 �resultr5 r r r � search_itemsX s
��zCollection.search_itemsc C s | j �d�}t|t�s
J �|S )z Returns the collection label.r )r r �
isinstance�str�r �labelr r r � get_label_ s zCollection.get_labelr? c C s | � � | j�dd|� dS )z!Sets collection label to `label`.r �sN)r$ r � set_propertyr> r r r � set_labele s zCollection.set_labelF�
text/plain�secret�replace� content_typec
C sl | � � | js
t| j�| _t| j||�}td d|ftd d|fi}| j�dd|||�\}} t| j|| j�S )ac Creates a new :class:`~secretstorage.item.Item` with given
`label` (unicode string), `attributes` (dictionary) and `secret`
(bytestring). If `replace` is :const:`True`, replaces the existing
item with the same attributes. If `content_type` is given, also
sets the content type of the secret (``text/plain`` by default).
Returns the created item.z
Item.LabelrA zItem.Attributesr9 �
CreateItemza{sv}(oayays)b) r$ r r r r r r r) r )
r r? r7 rE rF rG �_secret�
properties�new_itemr0 r r r � create_itemj s �
�zCollection.create_item)r N)FrD )�__name__�
__module__� __qualname__�__doc__�DEFAULT_COLLECTIONr r= r r r r! r# r$ r% r+ r3 r r r6 r r; r@ rC �bytesrL r r r r r ! s> ���
�
�����r- Nr r? �aliasr r c C s� |st | �}td d|fi}ttt| �}|�dd||�\}}t|�dkr+t| ||d�S t| |�\}} |r8t d��| \}
}|
dksBJ �t| ||d�S ) z�Creates a new :class:`Collection` with the given `label` and `alias`
and returns it. This action requires prompting.
:raises: :exc:`~secretstorage.exceptions.PromptDismissedException`
if the prompt is dismissed.
zCollection.LabelrA �CreateCollectionza{sv}s� )r r/ �o)
r r r
r r( r) �lenr r r ) r r? rS r rJ r* r r0 r1 r: � signaturer r r �create_collection s � rY c c s. � t tt| �}|�d�D ]}t| |�V q dS )z1Returns a generator of all available collections.� CollectionsN)r
r r( r r )r r* r r r r �get_all_collections� s
� �r[ c C s, zt | �W S ty t| dd|� Y S w )zAReturns the default collection. If it doesn't exist,
creates it.�Default�default)r r
rY )r r r r r �get_default_collection� s
��r^ c C s^ zt | �W S ty Y nw zt | t�W S ty Y nw tt| ��}|r+|d S td��)z�Returns any collection, in the following order of preference:
- The default collection;
- The "session" collection (usually temporary);
- The first collection in the collections list.r zNo collections found.)r r
�SESSION_COLLECTION�listr[ )r � collectionsr r r �get_any_collection� s
� � rb c C s: t tt| �}|�dd|�\}t|�dkrtd��t| |�S )z�Returns the collection with the given `alias`. If there is no
such collection, raises
:exc:`~secretstorage.exceptions.ItemNotFoundException`.� ReadAliasrA rU z No collection with such alias.)r
r r( r) rW r
r )r rS r* r r r r �get_collection_by_alias� s
rd r7 c c s> � t tt| �}|�dd|�\}}|| D ]}t| |�V qdS )zpReturns a generator of items in all collections with the given
attributes. `attributes` should be a dictionary.r8 r9 N)r
r r( r) r )r r7 r* �locked�unlockedr5 r r r r; � s � �r; )r- N)N)%rP �typingr r r �jeepney.io.blockingr �secretstorage.definesr r �secretstorage.dhcryptor �secretstorage.exceptionsr r
r �secretstorage.itemr �secretstorage.utilr
r r r r r r( rQ r_ �objectr r= rY r[ r^ rb rd r; r r r r �<module> sL ^��
���
�
�
�
��