B 0[ @s0dZddlmZmZmZddlmZddlmZm Z ddl m Z ddl m Z mZmZddlmZddlmZmZmZmZmZed Zed Zd Zd ZGd d d eZd!eeeee edddZeeedddZ d"eee edddZ!eedddZ"eeedddZ#eeeefeeddd 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 CollectionZServicez(/org/freedesktop/secrets/aliases/defaultz+/org/freedesktop/secrets/collection/sessionc@seZdZdZedfeeeeddddZ e dddZ ddd d Z e dd d Z ddd dZddddZeedddZeeefeedddZedddZeddddZd eeeefee eedddZdS)!rzRepresents a collection.N) connectioncollection_pathsessionreturncCs0||_||_||_t|t||_|jddS)NLabel)rrrr COLLECTION_IFACE _collection get_property)selfrrrr7lib/python3.7/site-packages/secretstorage/collection.py__init__$s  zCollection.__init__)rcCst|jdS)zDReturns :const:`True` if item is locked, otherwise :const:`False`.ZLocked)boolrr)rrrr is_locked.szCollection.is_lockedcCs|rtddS)zSIf collection is locked, raises :exc:`~secretstorage.exceptions.LockedException`.zCollection is locked!N)r r )rrrrensure_not_locked3szCollection.ensure_not_lockedcCst|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. )rrr)rrrrunlock9s zCollection.unlockcCs$ttt|j}|dd|jgdS)zLocks the collection.ZLockZaoN)r r SERVICE_IFACErcallr)rservicerrrlockEszCollection.lockcCs@||jdd\}|dkrrrrrr!s  r'N)rr5aliasrrc Cs|s t|}tdd|fi}ttt|}|dd||\}}t|dkrVt|||dSt||\}} |rpt d| \} }| dkst t|||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.Labelr7ZCreateCollectionza{sv}s)rzPrompt dismissed.o) rrr rr#r$lenrrr r4) rr5rErr=r%rr)r*r0Z signaturerrrcreate_collections    rI)rrccs0ttt|}x|dD]}t||VqWdS)z1Returns a generator of all available collections.Z CollectionsN)r rr#rr)rr%rrrrget_all_collectionss rJ)rrrcCs,yt|Stk r&t|dd|SXdS)zAReturns the default collection. If it doesn't exist, creates it.ZDefaultdefaultN)rr rI)rrrrrget_default_collections rLcCsbyt|Stk rYnXy t|tStk r<YnXtt|}|rV|dStddS)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.N)rr SESSION_COLLECTIONlistrJ)r collectionsrrrget_any_collections  rP)rrErcCs:ttt|}|dd|\}t|dkr0tdt||S)zReturns the collection with the given `alias`. If there is no such collection, raises :exc:`~secretstorage.exceptions.ItemNotFoundException`.Z ReadAliasr7rFzNo collection with such alias.)r rr#r$rHr r)rrEr%rrrrget_collection_by_aliass   rQ)rr.rccs@ttt|}|dd|\}}x||D]}t||Vq(WdS)zpReturns a generator of items in all collections with the given attributes. `attributes` should be a dictionary.r/za{ss}N)r rr#r$r )rr.r%lockedZunlockedr,rrrr1s r1)r'N)N)%rBtypingrrrZjeepney.integrate.blockingrZsecretstorage.definesrrZsecretstorage.dhcryptorZsecretstorage.exceptionsr r r Zsecretstorage.itemr Zsecretstorage.utilr rrrrrr#rCrMobjectrr3rIrJrLrPrQr1rrrrs*   ^