o E,W@sdZddlZddlmZmZddlmZmZddlm Z ddl m Z m Z m Z mZmZmZmZedZedZd Zd ZGd ddeZdd dZddZdddZddZddZddZdS)arCollection 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.N) SS_PREFIXSS_PATH)LockedExceptionItemNotFoundException)Item)bus_get_objectInterfaceWrapperexec_prompt_glib format_secret open_session to_unicodeunlock_objects CollectionServicez(/org/freedesktop/secrets/aliases/defaultz+/org/freedesktop/secrets/collection/sessionc@sveZdZdZedfddZddZddZdd d Zd d Z d dZ ddZ ddZ ddZ ddZ  dddZdS)rzRepresents a collection.NcCsLt||}||_||_||_t|t|_t|tj|_ |j j tddddS)NLabelss signature) rbussessioncollection_pathrCOLLECTION_IFACEcollection_ifacedbusPROPERTIES_IFACEcollection_props_ifaceGet)selfrrrcollection_objrJ/var/www/html/env/lib/python3.10/site-packages/secretstorage/collection.py__init__!s   zCollection.__init__cCst|jjtdddS)zDReturns :const:`True` if item is locked, otherwise :const:`False`.Lockedrr)boolrrrrrrr is_locked-szCollection.is_lockedcCs|rtddS)zSIf collection is locked, raises :exc:`~secretstorage.exceptions.LockedException`.zCollection is locked!N)r%rr$rrr ensure_not_locked3szCollection.ensure_not_lockedcCst|j|jg|S)aRequests unlocking the collection. If `callback` is specified, calls it when unlocking is complete (see :func:`~secretstorage.util.exec_prompt` description for details). Otherwise, uses loop from GLib API and returns a boolean representing whether the operation was dismissed.)r rr)rcallbackrrr unlock9szCollection.unlockcCs,t|jt}t|t}|j|jgdddS)zLocks the collection.aorN)rrrr SERVICE_IFACELockr)r service_obj service_ifacerrr lockAs  zCollection.lockcCs||jjdddS)z/Deletes the collection and all items inside it.rN)r&rDeleter$rrr deleteGszCollection.deleteccs0|jjtdddD] }t|j||jVq dS)z3Returns a generator of all items in the collection.ItemsrrN)rrrrrr)r item_pathrrr get_all_itemsLs  zCollection.get_all_itemsccs2|jj|dd}|D] }t|j||jVq dS)z^Returns a generator of items with the given attributes. `attributes` should be a dictionary.a{ss}rN)r SearchItemsrrr)r attributesresultr3rrr search_itemsRszCollection.search_itemscCs|jjtddd}t|S)zReturns the collection label.rrr)rrrr rlabelrrr get_labelZszCollection.get_labelcCs ||jjtd|dddS)z!Sets collection label to `label`.rssvrN)r&rSetrr:rrr set_label`s  zCollection.set_labelF text/plainc Csr||js t|j|_t|j||}tj|dd}td|td|i}|jj |||dd\}}t |j||jS)acCreates 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.rrz Item.LabelzItem.Attributesza{sv}(oayays)b) r&rr rr r Dictionaryrr CreateItemr) rr;r7secretreplace content_type propertiesnew_itempromptrrr create_itemfs  zCollection.create_itemN)Fr@)__name__ __module__ __qualname____doc__DEFAULT_COLLECTIONr!r%r&r(r.r1r4r9r<r?rIrrrr rs  r/c Cs|st|}td|i}t|t}t|t}|j||dd\}}t|dkr.t |||dSt ||\} } | r;t dt || |dS)aCreates a new :class:`Collection` with the given `label` and `alias` and returns it. This action requires prompting. If prompt is dismissed, raises :exc:`~secretstorage.exceptions.ItemNotFoundException`. This is synchronous function, uses loop from GLib API.zCollection.Labelza{sv}sr)rzPrompt dismissed.) r rrrr Interfacer*CreateCollectionlenrr r) rr;aliasrrFr,r-rrH dismissedunlockedrrr create_collection{s    rWccs@t|t}t|tj}|jtdddD]}t||VqdS)z1Returns a generator of all available collections. CollectionsrrN)rrrrQrrr*r)rr,service_props_ifacerrrr get_all_collectionss  rZcCs,zt|WStyt|dd|YSw)zAReturns the default collection. If it doesn't exist, creates it.Defaultdefault)rrrW)rrrrr get_default_collections  r]cCs^zt|WStyYnwzt|tWStyYnwtt|}|r+|dStd)zReturns any collection, in the following order of preference: - The default collection; - The "session" collection (usually temporary); - The first collection in the collections list.rzNo collections found.)rrSESSION_COLLECTIONlistrZ)r collectionsrrr get_any_collections     racCsBt|t}t|t}|j|dd}t|dkrtdt||S)zReturns the collection with the given `alias`. If there is no such collection, raises :exc:`~secretstorage.exceptions.ItemNotFoundException`.srrPzNo collection with such alias.) rrrrQr* ReadAliasrSrr)rrTr,r-rrrr get_collection_by_aliass    rdccsHt|t}t|t}|j|dd\}}||D]}t||VqdS)zpReturns a generator of items in all collections with the given attributes. `attributes` should be a dictionary.r5rN)rrrrQr*r6r)rr7r,r-lockedrVr3rrr r9s   r9)r/NrJ)rNrsecretstorage.definesrrsecretstorage.exceptionsrrsecretstorage.itemrsecretstorage.utilrrr r r r r rr*rOr^objectrrWrZr]rardr9rrrr s"  $ ]