Hd |dZddlmZmZmZddlmZddlmZm Z ddl m Z ddl m Z mZmZddlmZddlmZmZmZmZmZed zZed zZd Zd ZGd d eZ ddedededee def dZdedeefdZ ddedee defdZ!dedefdZ"dededefdZ#dedeeefdeefdZ$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 eZdZdZedfdededeeddfdZ de fdZ dd Z de fd Z dd Zdd Zdeefd ZdeeefdeefdZdefdZdeddfdZ ddedeeefdede dedef dZdS)rzRepresents a collection.N connectioncollection_pathsessionreturnc||_||_||_t|t||_|jddS)NLabel)rrrrCOLLECTION_IFACE _collection get_property)selfrrrs 8lib/python3.11/site-packages/secretstorage/collection.py__init__zCollection.__init__$sQ$/$,($'$j22$(((((cPt|jdS)zDReturns :const:`True` if item is locked, otherwise :const:`False`.Locked)boolrrrs r is_lockedzCollection.is_locked.s# d++H55 6 66r"cL|rtddS)zSIf collection is locked, raises :exc:`~secretstorage.exceptions.LockedException`.zCollection is locked!N)r'r r&s r ensure_not_lockedzCollection.ensure_not_locked3s/ ^^2 0 1 1122r"c8t|j|jgS)aRequests 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.unlock9s $*>)? @ @@r"cttt|j}|dd|jgdS)zLocks the collection.LockaoN)rr SERVICE_IFACErcallr)rservices r lockzCollection.lockEs7 w t G G' ,,vtd2344444r"c||jdd\}|dkr)t|j|\}}|rt ddSdS)z/Deletes the collection and all items inside it.Delete/Prompt dismissed.N)r)rr0rrr )rprompt dismissed_results r deletezCollection.deleteJs{   ! !(B / /'& s]8#DOV<<9g8 "#6 7 778888r"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_itemsSsO#009988i doy$, 7 7777788r" attributesc#K|jdd|\}|D]}t|j||jV dS)z^Returns a generator of items with the given attributes. `attributes` should be a dictionary. SearchItemsa{ss}N)rr0r rr)rr@resultr>s r search_itemszCollection.search_itemsXs\   ! !-* E E'&88i doy$, 7 7777788r"ch|jd}t|tsJ|S)zReturns the collection label.r)rr isinstancestrrlabels r get_labelzCollection.get_label_s3   ' ' 0 0% E3   ,r"rJcf||jdd|dS)z!Sets collection label to `label`.rsN)r)r set_propertyrIs r set_labelzCollection.set_labeles5e44444r"F text/plainsecretreplace content_typecB||jst|j|_t |j||}t dzd|ft dzd|fi}|jdd|||\}} 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.z Item.LabelrMzItem.AttributesrC CreateItemza{sv}(oayays)b) r)rrrrrrr0r ) rrJr@rQrRrS_secret propertiesnew_itemr8s r create_itemzCollection.create_itemjs 0t//4< $, = =' |c5\   7J"7*%**<9I+5wII(F dox 6 66r")rN)FrP)__name__ __module__ __qualname____doc__DEFAULT_COLLECTIONrrHrr r!r%r'r)r+r2r;rr r?rrErKrObytesrYr"r rr!s&8+/)))")()48))))77777 2222 AT A A A A5555 88888HTN8888 8DcN8x~8888 5C5D5555 16%177c7tCH~77)-7"76:777777r"r5NrrJaliasrrc||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.LabelrMCreateCollectionza{sv}s)rr7o) rrrrr/r0lenrrr ) rrJrarrWr1rr8r9rD signatures r create_collectionrhs %  $ $'--U|< g}j A A"<<(:H(2E;;&1B J A A AA V44F 6 !4555$OS:@@@@r"c#Kttt|}|dD]}t ||VdS)z1Returns a generator of all available collections. CollectionsN)rrr/rr)rr1rs r get_all_collectionsrksW g}j A A,,];;00_://////00r"cf t|S#t$rt|dd|cYSwxYw)zAReturns the default collection. If it doesn't exist, creates it.Defaultdefault)rr rh)rrs r get_default_collectionrosU J   :y W  s 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.)rr SESSION_COLLECTIONlistrk)r collectionss r get_any_collectionrts  J  $ J 2 3 33$' 33447 Q5666s 7 AActtt|}|dd|\}t |dkrt dt ||S)zReturns the collection with the given `alias`. If there is no such collection, raises :exc:`~secretstorage.exceptions.ItemNotFoundException`. ReadAliasrMrdzNo collection with such alias.)rrr/r0rfr r)rrar1rs r get_collection_by_aliasrwsb g}j A ALLc599A@>???:///r"r@c#Kttt|}|dd|\}}||zD]}t ||VdS)zpReturns a generator of items in all collections with the given attributes. `attributes` should be a dictionary.rBrCN)rrr/r0r )rr@r1lockedunlockedr>s r rErEsj g}j A ALLDD8#$$Y Z######$$r")r5N)N)%r]typingrrrjeepney.io.blockingrsecretstorage.definesrrsecretstorage.dhcryptor secretstorage.exceptionsr r r secretstorage.itemr secretstorage.utilrrrrrrr/r^rqobjectrrHrhrkrortrwrEr`r"r rs   ,+++++++++......44444444******######--------------|+y( ?B\7\7\7\7\7\7\7\7|LN37AA.AASA'0A7j7777, 0 0#& 0+5 0 0 0 0$^$!#s(^$08$$$$$$r"