Dje& fdZddlmZddlmZddlmZmZddlm Z ddl m Z m Z m Z ddlmZddlmZmZmZmZmZed zZed zZd Zd ZGd d Z ddededede dzdef dZdedeefdZ ddede dzdefdZdedefdZdededefdZ dede!eefdeefdZ"dS)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 dZdefdZdS)rzRepresents a collection.N connectioncollection_pathsessionreturnc||_||_||_t|t||_|jddS)NLabel)rrrr COLLECTION_IFACE _collection get_property)selfrrrs S/home/thesage/.hermes/venv/lib/python3.11/site-packages/secretstorage/collection.py__init__zCollection.__init__0sQ% .- -z;; %%g.....cPt|jdS)zJReturns :const:`True` if item is locked, otherwise :const:`False`.Locked)boolrrrs r is_lockedzCollection.is_locked:s#D$11(;;<<>   ;!"9:: : ; ;r timeoutc<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. :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! do0D/EwWWWWr cttt|j}|dd|jgdS)zLocks the collection.LockaoN)r r SERVICE_IFACErcallr)rservices rlockzCollection.lockWs7$WmT_MM VTD$8#9:::::r c||jdd\}|dkr)t|j|\}}|rt ddSdS)z/Deletes the collection and all items inside it.Delete/Prompt dismissed.N)r'rr/r rr )rprompt dismissed_results rdeletezCollection.delete\sx    "''"55 S==!,T_f!E!E Iw D./BCCC = D Dr c#~K|jdD]}t|j||jV dS)z3Returns a generator of all items in the collection.ItemsN)rrr rr)r item_paths r get_all_itemszCollection.get_all_itemsesS)66w?? A AIt 4<@@ @ @ @ @ A Ar attributesc#K|jdd|\}|D]}t|j||jV dS)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_itemsjs`"'' w KK A AIt 4<@@ @ @ @ @ A Ar ch|jd}t|tsJ|S)zReturns the collection label.r)rr isinstancestrrlabels r get_labelzCollection.get_labelqs3 --g66%%%%%% r rIcf||jdd|dS)z!Sets collection label to `label`.rsN)r'r set_propertyrHs r set_labelzCollection.set_labelws5     %%gsE:::::r F text/plainsecretreplace content_typec ||jst|j|_t |j||}t dzd|ft dzd|fi}|jdd|||\}} t|dkrt|j||jSt|j| \} } | rtd| \} }| d ksJt|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.LabelrLzItem.AttributesrB CreateItemza{sv}(oayays)br6o) r'rrrrrrr/lenr r r ) rrIr?rPrQrR_secret propertiesr=r7r8rC signatures r create_itemzCollection.create_item|s    | 9'88DL flCC  $sEl ) )GZ+@ !,11         6 y>>A  DLAA A'@@ 6  @*+>?? ?% 9CDOY ===r cBd|d|jdS)Nz )rJrr$s r__repr__zCollection.__repr__s(Qdnn..QQ8LQQQQr )rNN)FrO)__name__ __module__ __qualname____doc__DEFAULT_COLLECTIONrrGrrr#r%r'floatr*r1r:rr r>dictrDrJrNbytesr[r^r rrr-s"");+///>/"%/!D./48////=4==== ;;;; XXedlXdXXXX$;;;; DDDDAx~AAAA AtCH~A(4.AAAA3 ;s;t;;;; 49(4>>>$sCx.>!>,0>"%>9=>>>>BR#RRRRRRr r4NrrIaliasrrc||st|}tdzd|fi}ttt|}|dd||\}}t |dkrt|||St||\}} |rtd| \} }| dksJt|||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.LabelrLCreateCollectionza{sv}srU)rr6rV) rrr rr.r/rWrr r ) rrIrirrYr0rr7r8rCrZs rcreate_collectionrls +z**003,?J -DDG%ll+=x+5u>>OV ?a*owGGGG#J77Iv<&':;;;!'I      j/7 C C CCr c#Kttt|}|dD]}t ||VdS)z1Returns a generator of all available collections. CollectionsN)r rr.rr)rr0rs rget_all_collectionsrosW -DDG"// >>66_55555566r cf t|S#t$rt|dd|cYSwxYw)zDReturns the default collection. If it doesn't exist, creates it.Defaultdefault)rrrl)rrs rget_default_collectionrssOL*%%% LLL Y 7KKKKKLs 00c 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_collectionrxs  *%%%       *&8999      *:6677K=1~#$;<<rs  %$$$$$......44444444****** $#####|+I% ?BqRqRqRqRqRqRqRqRhLN04DD.DDSD&~D9CDDDD06N6x 7K66666:LL~L$+dNL>HLLLL=>=j====. 3 3#& 3+5 3 3 3 3*^*!#s(^*08******r