b$ TdZddlmZmZmZddlmZddlmZm Z ddl m Z ddl m Z mZmZddlmZddlmZmZmZmZmZed zZed zZd Zd ZGd d Z ddedededee def dZdedeefdZ ddedee defdZ dedefdZ!dededefdZ"dedeeefdeefdZ#y)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 eZdZdZedfdededeeddfdZ de fdZ dd Z de fd Z dd Zdd Zdeefd ZdeeefdeefdZdefdZdeddfdZ ddedeeefdede dedef dZy)rzRepresents a collection.N connectioncollection_pathsessionreturnc||_||_||_t|t||_|j j dy)NLabel)rrrrCOLLECTION_IFACE _collection get_property)selfrrrs :/usr/lib/python3/dist-packages/secretstorage/collection.py__init__zCollection.__init__%sC% .- -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"cDt|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&s r unlockzCollection.unlock:sdoo0D0D/EFFr"c~ttt|j}|j dd|j gy)zLocks the collection.LockaoN)rr SERVICE_IFACErcallr)rservices r lockzCollection.lockFs-$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)rr0rrr )rprompt dismissed_results r deletezCollection.deleteKs]  ""''"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_itemsTs?))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)rr0r rr)rrAresultr>s r search_itemszCollection.search_itemsYsL""'' w K AIt 4<<@ @ AsA A c`|jjd}t|tsJ|S)zReturns the collection label.r)rr isinstancestrrlabels r get_labelzCollection.get_label`s-  --g6%%%% r"rKc^|j|jjdd|y)z!Sets collection label to `label`.rsN)r)r set_propertyrJs r set_labelzCollection.set_labelfs&   %%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.LabelrNzItem.AttributesrD CreateItemza{sv}(oayays)br7o) r)rrrrrrr0lenr rr ) rrKrArQrRrS_secret propertiesr>r8r9rE signatures r create_itemzCollection.create_itemks  ||'8DL flC  $sEl ) )GZ+@ !,,11        6 y>A DLLA A'@ 6 *+>? ?% 9CDOOY ==r")rN)Fz text/plain)__name__ __module__ __qualname____doc__DEFAULT_COLLECTIONrrIrr r!r%r'r)r+r2r;rr r?rrFrLrPbytesr\r"r rr"s");.2/>/"%/"7+/7;/=4= ; G G; DAx~A AtCH~A(4.A3 ;s;t; 49(4>>$sCx.>!>,0>"%>9=>r"NrrKaliasrrc2|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.LabelrNCreateCollectionza{sv}srV)rr7rW) rrrrr/r0rXrrr ) rrKrdrrZr1rr8r9rEr[s r create_collectionrgs 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)rrr/rr)rr1rs r get_all_collectionsrjs; -DG"// >6_556s;=cT t|S#t$rt|dd|cYSwxYw)zDReturns the default collection. If it doesn't exist, creates it.Defaultdefault)rr rg)rrs r get_default_collectionrns5L*%% 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.)rr SESSION_COLLECTIONlistrj)r collectionss r get_any_collectionrsst  *%%     *&899    *:67K1~#$;<s r rFrFsN!-DG||M7JGFHh&* :y))*r@)r5N)N)$r`typingrrrjeepney.io.blockingrsecretstorage.definesrrsecretstorage.dhcryptor secretstorage.exceptionsr r r secretstorage.itemr secretstorage.utilrrrrrrr/rarprrIrgrjrnrsrvrFrcr"r rs:  ,+.4*#--|+I% ?Bh>h>VLN37D.DDSD'0D=j=. 3 3#& 3+5 3*^*!#s(^*08*r"