ҙie& LdZddlmZddlmZddlmZmZddlm Z ddl m Z m Z m Z ddlmZddlmZmZmZmZmZed zZed zZd Zd ZGd d Z ddededede dzdef dZdedeefdZ ddede dzdefdZdedefdZdededefdZ dede!eefdeefdZ"y)azCollection 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 blocks until user accepts or declines it). Creating new items and editing existing ones is possible only in unlocked collections. )Iterator)DBusConnection)SS_PATH SS_PREFIX)Session)ItemNotFoundExceptionLockedExceptionPromptDismissedException)Item)DBusAddressWrapper exec_prompt format_secret open_sessionunlock_objects CollectionServicez(/org/freedesktop/secrets/aliases/defaultz+/org/freedesktop/secrets/collection/sessionc eZdZdZedfdedededzddfdZde fdZ dd Z dd e dzde fd Z dd Zdd ZdeefdZdeeefdeefdZdefdZdeddfdZ ddedeeefdede dedef dZdefdZy)rzRepresents a collection.N connectioncollection_pathsessionreturnc||_||_||_t|t||_|j j dy)NLabel)rrrr COLLECTION_IFACE _collection get_property)selfrrrs T/mnt/e/genesis-system/.venv/lib/python3.12/site-packages/secretstorage/collection.py__init__zCollection.__init__0sC% .- -z; %%g.cJt|jjdS)zJReturns :const:`True` if item is locked, otherwise :const:`False`.Locked)boolrrrs r is_lockedzCollection.is_locked:s D$$11(;<> !"9: : r timeoutcHt|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. :raises: ``TimeoutError`` if `timeout` (in seconds) passed and the prompt was neither accepted nor dismissed. .. versionchanged:: 3.0 No longer accepts the ``callback`` argument. .. versionchanged:: 3.5 Added ``timeout`` argument. )r()rrr)rr(s runlockzCollection.unlockEs doo0D0D/EwWWr c~ttt|j}|j dd|j gy)zLocks the collection.LockaoN)r r SERVICE_IFACErcallr)rservices rlockzCollection.lockWs-$WmT__M VTD$8$8#9:r c|j|jjdd\}|dk7r't|j|\}}|r t dyy)z/Deletes the collection and all items inside it.Delete/Prompt dismissed.N)r'rr/r rr )rprompt dismissed_results rdeletezCollection.delete\s]  ""''"5 S=!,T__f!E Iw./BCC r c#K|jjdD]%}t|j||j'yw)z3Returns a generator of all items in the collection.ItemsN)rrr rr)r item_paths r get_all_itemszCollection.get_all_itemses?))66w? AIt 4<<@ @ AAA attributesc#K|jjdd|\}|D]%}t|j||j'yw)zdReturns a generator of items with the given attributes. `attributes` should be a dictionary. SearchItemsa{ss}N)rr/r rr)rr@resultr=s r search_itemszCollection.search_itemsjsL""'' w K AIt 4<<@ @ AsA A c`|jjd}t|tsJ|S)zReturns the collection label.r)rr isinstancestrrlabels r get_labelzCollection.get_labelqs-  --g6%%%% r rJc^|j|jjdd|y)z!Sets collection label to `label`.rsN)r'r set_propertyrIs r set_labelzCollection.set_labelws&   %%gsE:r secretreplace content_typec|j|jst|j|_t |j||}t dzd|ft dzd|fi}|j jdd|||\}} t|dkDr!t|j||jSt|j| \} } | r td| \} }| d k(sJt|j||jS) aCreates 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.LabelrMzItem.AttributesrC CreateItemza{sv}(oayays)br6o) r'rrrrrrr/lenr r r ) rrJr@rPrQrR_secret propertiesr=r7r8rD signatures r create_itemzCollection.create_item|s  ||'8DL flC  $sEl ) )GZ+@ !,,11        6 y>A DLLA A'@ 6 *+>? ?% 9CDOOY ==r cDd|jd|jdS)Nz )rKrr$s r__repr__zCollection.__repr__s&dnn.18L8L7OqQQr )rNN)Fz text/plain)__name__ __module__ __qualname____doc__DEFAULT_COLLECTIONrrHrrr#r%r'floatr*r1r:rr r>dictrErKrObytesr[r^r rrr-s");+//>/"%/!D./48/=4= ; XedlXdX$; DAx~A AtCH~A(4.A3 ;s;t; 49(4>>$sCx.>!>,0>"%>9=>BR#Rr NrrJaliasrrc2|s t|}tdzd|fi}ttt|}|j dd||\}}t |dkDrt|||St||\}} |r td| \} }| dk(sJt|||S) 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.LabelrMCreateCollectionza{sv}srU)rr6rV) rrr rr.r/rWrr r ) rrJrirrYr0rr7r8rDrZs rcreate_collectionrls z*003,?J -DG%ll+=x+5u>OV ?a*owGG#J7Iv&':;;!'I    j/7 CCr c#~Kttt|}|jdD]}t ||yw)z1Returns a generator of all available collections. CollectionsN)r rr.rr)rr0rs rget_all_collectionsros; -DG"// >6_556s;=cT t|S#t$rt|dd|cYSwxYw)zDReturns the default collection. If it doesn't exist, creates it.Defaultdefault)rrrl)rrs rget_default_collectionrss5L*%% L Y 7KKLs ''c t|S#t$rYnwxYw t|tS#t$rYnwxYwtt |}|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_COLLECTIONlistro)r collectionss rget_any_collectionrxst  *%%     *&899    *:67K1~#$;<rs9 %.4* $|+I% ?BqRqRhLN04D.DDSD&~D9CD06N6x 7K66:L~L$+dNL>HL=>=j=. 3 3#& 3+5 3*^*!#s(^*08*r