o V h$ @sLdZddlmZmZmZddlmZddlmZm Z ddl m Z ddl m Z mZmZddlmZddlmZmZmZmZmZed Zed Zd Zd ZGd d d Z  d"dedededee def ddZdedeefddZ d#dedee defddZ dedefddZ!dededefddZ"dedeeefdeefd d!Z#dS)$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.)DictIteratorOptional)DBusConnection) SS_PREFIXSS_PATH)Session)LockedExceptionItemNotFoundExceptionPromptDismissedException)Item)DBusAddressWrapper exec_prompt format_secret open_sessionunlock_objects CollectionServicez(/org/freedesktop/secrets/aliases/defaultz+/org/freedesktop/secrets/collection/sessionc @seZdZdZedfdededeeddfddZ de fd d Z d$d d Z de fd dZ d$ddZd$ddZdeefddZdeeefdeefddZdefddZdeddfddZ  d%dedeeefded e d!edef d"d#ZdS)&rzRepresents a collection.N connectioncollection_pathsessionreturncCs0||_||_||_t|t||_|jddS)NLabel)rrrr COLLECTION_IFACE _collection get_property)selfrrrrl/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/secretstorage/collection.py__init__%szCollection.__init__cCst|jdS)zJReturns :const:`True` if item is locked, otherwise :const:`False`.Locked)boolrrrrrr is_locked/szCollection.is_lockedcCs|rtddS)zYIf collection is locked, raises :exc:`~secretstorage.exceptions.LockedException`.zCollection is locked!N)r#r r"rrrensure_not_locked4szCollection.ensure_not_lockedcCst|j|jgS)aARequests 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. )rrrr"rrrunlock:s zCollection.unlockcCs$ttt|j}|dd|jgdS)zLocks the collection.LockaoN)r r SERVICE_IFACErcallr)rservicerrrlockFszCollection.lockcCsD||jdd\}|dkrt|j|\}}|r tddSdS)z/Deletes the collection and all items inside it.Delete/Prompt dismissed.N)r$rr)rrr )rprompt dismissed_resultrrrdeleteKszCollection.deleteccs*|jdD] }t|j||jVqdS)z3Returns a generator of all items in the collection.ItemsN)rrr rr)r item_pathrrr get_all_itemsTszCollection.get_all_items attributesccs4|jdd|\}|D] }t|j||jVq dS)zdReturns a generator of items with the given attributes. `attributes` should be a dictionary. SearchItemsa{ss}N)rr)r rr)rr7resultr5rrr search_itemsYs zCollection.search_itemscCs|jd}t|ts J|S)zReturns the collection label.r)rr isinstancestrrlabelrrr get_label`s zCollection.get_labelr?cCs||jdd|dS)z!Sets collection label to `label`.rsN)r$r set_propertyr>rrr set_labelfszCollection.set_labelF text/plainsecretreplace content_typec Cs||js t|j|_t|j||}tdd|ftdd|fi}|jdd|||\}} t|dkr    r-Nrr?aliasrrc Cs|st|}tdd|fi}ttt|}|dd||\}}t|dkr+t|||dSt||\}} |r8t d| \} }| dksBJt|||dS) zCreates 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.LabelrACreateCollectionza{sv}srI)rr/rJ) rrr rr(r)rKrrr ) rr?rVrrMr*rr0r1r:rNrrrcreate_collections   rXccs.ttt|}|dD]}t||Vq dS)z1Returns a generator of all available collections. CollectionsN)r rr(rr)rr*rrrrget_all_collectionss  rZcCs,zt|WStyt|dd|YSw)zDReturns the default collection. If it doesn't exist, creates it.Defaultdefault)rr rX)rrrrrget_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.)rr SESSION_COLLECTIONlistrZ)r collectionsrrrget_any_collections     racCs:ttt|}|dd|\}t|dkrtdt||S)zReturns the collection with the given `alias`. If there is no such collection, raises :exc:`~secretstorage.exceptions.ItemNotFoundException`. ReadAliasrArIzNo collection with such alias.)r rr(r)rKr r)rrVr*rrrrget_collection_by_aliass   rcr7ccs>ttt|}|dd|\}}||D]}t||VqdS)zsReturns a generator of items in all collections with the given attributes. `attributes` should be a dictionary.r8r9N)r rr(r)r )rr7r*lockedunlockedr5rrrr;s   r;)r-N)N)$rStypingrrrjeepney.io.blockingrsecretstorage.definesrrsecretstorage.dhcryptorsecretstorage.exceptionsr r r secretstorage.itemr secretstorage.utilr rrrrrr(rTr^rr=rXrZr]rarcr;rrrrsL   k