k7iSSKJr SSKJrJrJrJr \"SS\55r\"SS\55r\"SS\55r \"S S \55r \"S S \55r \"S S\55r "SS\\5r g))Sequence)AnyProtocol SupportsFloatruntime_checkablec \rSrSrSrSS.S\S\S-S\\\4S-4SjjrSS.S\S\S-S\ \\\4S-\ S-44S jjr SSS .S\S \\\4S\S-S \ S-SS4 S jjr SS.S\S\S-S\4SjjrSS.S\\S\S-S\\\\4S-4SjjrSS.S\\S\S-S\\ \\\4S-\ S-44SjjrSSS .S\\S\\\\4S\S-S \\ S-S-SS4 SjjrSS.S\\S\S-S\4SjjrSrg)AsyncKeyValueProtocolzQA subset of KV operations: get/put/delete and TTL variants, including bulk calls.N) collectionkeyr returnc # g7f)aIRetrieve a value by key from the specified collection. Args: key: The key to retrieve the value from. collection: The collection to retrieve the value from. If no collection is provided, it will use the default collection. Returns: The value associated with the key. If the key is not found, None will be returned. Nselfr r s [/home/james-whalen/.local/lib/python3.13/site-packages/key_value/aio/protocols/key_value.pygetAsyncKeyValueProtocol.get s  c # g7f)aRetrieve the value and TTL information for a key-value pair from the specified collection. Args: key: The key to retrieve the TTL information from. collection: The collection to retrieve the TTL information from. If no collection is provided, it will use the default collection. Returns: The value and TTL information for the key. If the key is not found, (None, None) will be returned. Nrrs rttlAsyncKeyValueProtocol.ttl  r)r rvaluerc # g7f)aStore a key-value pair in the specified collection with optional TTL. Args: key: The key to store the value in. value: The value to store. collection: The collection to store the value in. If no collection is provided, it will use the default collection. ttl: The optional time-to-live (expiry duration) in seconds for the key-value pair. Defaults to no TTL. Note: The backend store will convert the provided format to its own internal format. Nr)rr rr rs rputAsyncKeyValueProtocol.put'  rc # g7f)zDelete a key-value pair from the specified collection. Args: key: The key to delete the value from. collection: The collection to delete the value from. If no collection is provided, it will use the default collection. Nrrs rdeleteAsyncKeyValueProtocol.delete3  rkeysc # g7f)aXRetrieve multiple values by key from the specified collection. Args: keys: The keys to retrieve the values from. collection: The collection to retrieve keys from. If no collection is provided, it will use the default collection. Returns: A list of values for the keys. Each value is either a dict or None if the key is not found. Nrrr#r s rget_manyAsyncKeyValueProtocol.get_many<rrc # g7f)aRetrieve multiple values and TTL information by key from the specified collection. Args: keys: The keys to retrieve the values and TTL information from. collection: The collection to retrieve keys from. If no collection is provided, it will use the default collection. Returns: A list of tuples containing (value, ttl) for each key. Each tuple contains either (dict, float) or (None, None) if the key is not found. Nrr%s rttl_manyAsyncKeyValueProtocol.ttl_manyHrrvaluesc # g7f)aStore multiple key-value pairs in the specified collection. Args: keys: The keys to store the values in. values: The values to store. collection: The collection to store keys in. If no collection is provided, it will use the default collection. ttl: The optional time-to-live (expiry duration) in seconds for the key-value pairs. Defaults to no TTL. Note: The backend store will convert the provided format to its own internal format. Nr)rr#r+r rs rput_manyAsyncKeyValueProtocol.put_manyUs " rc # g7f)aDelete multiple key-value pairs from the specified collection. Args: keys: The keys to delete the values from. collection: The collection to delete keys from. If no collection is provided, it will use the default collection. Returns: The number of keys deleted. Nrr%s r delete_many!AsyncKeyValueProtocol.delete_manyhrrr)__name__ __module__ __qualname____firstlineno____doc__strdictrrtuplefloatrrrboolr listr&r)rr-intr0__static_attributes__rrr r s+[ "&   $J  c3h$   "?C  S  t  uTRUWZRZ^^bMbdilpdpMpGq  VZw{  S  c3h  d  `mpt`t  AE  BF  C$J $ KO  49  S4Z  SWX\]`be]eXfimXmSn  KO  49  S4Z  SWX]^bcfhkck^los^suz~BvB_BYCTD  $"&59  3i c3h( $J  md* +d 2    &NR  d3i  d  VY   r?r c\rSrSrSSjrSrg)AsyncCullProtocoluNc # g7f)zCCull the store. This will remove all expired keys from the store. Nrrs rcullAsyncCullProtocol.cullw rr)r N)r2r3r4r5rEr>rr?rrArAus r?rAc L\rSrSrSrS SS.S\S-S\S-S\\4SjjjrS r g) AsyncEnumerateKeysProtocolz3Protocol segment to enumerate keys in a collection.Nlimitr rLr c # g7f)aList all keys in the specified collection. Args: collection: The collection to list the keys from. If no collection is provided, it will use the default collection. limit: The maximum number of keys to list. The behavior when no limit is provided is store-dependent. Nr)rr rLs rr#AsyncEnumerateKeysProtocol.keysr"rr)N) r2r3r4r5r6r7r=r<r#r>rr?rrIrIs:= t S4Z #* X\]`Xa  r?rIc:\rSrSrSS.S\S-S\\4SjjrSrg)!AsyncEnumerateCollectionsProtocolNrKrLr c # g7f)zList all available collection names (may include empty collections). Args: limit: The maximum number of collections to list. The behavior when no limit is provided is store-dependent. Nr)rrLs r collections-AsyncEnumerateCollectionsProtocol.collections rr) r2r3r4r5r=r<r7rSr>rr?rrPrPs%7; #* S   r?rPc&\rSrSrSrS\4SjrSrg)AsyncDestroyStoreProtocolz1Protocol segment for store-destruction semantics.r c # g7f)zPDestroy the keystore. This will clear all collections and keys from the store. NrrDs rdestroy!AsyncDestroyStoreProtocol.destroyrGrrN)r2r3r4r5r6r;rZr>rr?rrWrWs; t r?rWc&\rSrSrS\S\4SjrSrg)AsyncDestroyCollectionProtocolr r c # g7f)zTDestroy the specified collection. Args: collection: The collection to destroy. Nr)rr s rdestroy_collection1AsyncDestroyCollectionProtocol.destroy_collectionrUrrN)r2r3r4r5r7r;r`r>rr?rr]r]s 3 4 r?r]c\rSrSrSrSrg) AsyncKeyValuezA protocol for key-value store operations. Includes basic operations: get, put, delete, ttl Includes bulk operations: get_many, put_many, delete_many, ttl_many. rN)r2r3r4r5r6r>rr?rrcrcsr?rcN)collections.abcrtypingrrrrr rArIrPrWr]rcrr?rrgs$BBl Hl l ^                X  )8r?