Yi}J SrSSKrSSKJr SSKJrJrJrJr SSK J r J r SSK J r JrJr \(aSSKJr "SS \ \\\4\\\4\\\445rg) z/This module contains the DictPersistence class.N)deepcopy) TYPE_CHECKINGAnyOptionalcast)BasePersistencePersistenceInput)CDCDataConversationDictConversationKey)JSONDictc^\rSrSrSrSrS6S\\S\S\S\S \S \S \ 4U4S jjjr \ S \\ \ \ \\444Sj5r\ S \4Sj5r\ S \\ \ \ \\444Sj5r\ S \4Sj5r\ S \\ \\44Sj5r\ S \4Sj5r\ S \\4Sj5r\ S \4Sj5r\ S \\ \\44Sj5r\ S \4Sj5rS \ \ \ \\444SjrS \ \ \ \\444SjrS \ \\44SjrS \\4SjrS\S \4Sjr S\S\!S\\S S4S jr"S!\ S"\ \\4S S4S#jr#S$\ S"\ \\4S S4S%jr$S"\ \\4S S4S&jr%S"\S S4S'jr&S$\ S S4S(jr'S!\ S S4S)jr(S!\ S*\ \\4S S4S+jr)S$\ S,\ \\4S S4S-jr*S.\ \\4S S4S/jr+S7S0jr,\-S1\ \\4S \4S2j5r.\-S3\S \ \\44S4j5r/\-S"\S \ \ \ \\444S5j5r0Sr1U=r2$)8DictPersistencea Using Python's :obj:`dict` and :mod:`json` for making your bot persistent. Attention: The interface provided by this class is intended to be accessed exclusively by :class:`~telegram.ext.Application`. Calling any of the methods below manually might interfere with the integration of persistence into :class:`~telegram.ext.Application`. Note: * Data managed by :class:`DictPersistence` is in-memory only and will be lost when the bot shuts down. This is, because :class:`DictPersistence` is mainly intended as starting point for custom persistence classes that need to JSON-serialize the stored data before writing them to file/database. * This implementation of :class:`BasePersistence` does not handle data that cannot be serialized by :func:`json.dumps`. .. seealso:: :wiki:`Making Your Bot Persistent ` .. versionchanged:: 20.0 The parameters and attributes ``store_*_data`` were replaced by :attr:`store_data`. Args: store_data (:class:`~telegram.ext.PersistenceInput`, optional): Specifies which kinds of data will be saved by this persistence instance. By default, all available kinds of data will be saved. user_data_json (:obj:`str`, optional): JSON string that will be used to reconstruct user_data on creating this persistence. Default is ``""``. chat_data_json (:obj:`str`, optional): JSON string that will be used to reconstruct chat_data on creating this persistence. Default is ``""``. bot_data_json (:obj:`str`, optional): JSON string that will be used to reconstruct bot_data on creating this persistence. Default is ``""``. conversations_json (:obj:`str`, optional): JSON string that will be used to reconstruct conversation on creating this persistence. Default is ``""``. callback_data_json (:obj:`str`, optional): JSON string that will be used to reconstruct callback_data on creating this persistence. Default is ``""``. .. versionadded:: 13.6 update_interval (:obj:`int` | :obj:`float`, optional): The :class:`~telegram.ext.Application` will update the persistence in regular intervals. This parameter specifies the time (in seconds) to wait between two consecutive runs of updating the persistence. Defaults to 60 seconds. .. versionadded:: 20.0 Attributes: store_data (:class:`~telegram.ext.PersistenceInput`): Specifies which kinds of data will be saved by this persistence instance. ) _bot_data_bot_data_json_callback_data_callback_data_json _chat_data_chat_data_json_conversations_conversations_json _user_data_user_data_jsonN store_datauser_data_jsonchat_data_json bot_data_jsonconversations_jsoncallback_data_jsonupdate_intervalc >[T U]XS9 SUlSUlSUlSUlSUlSUlSUlSUl SUl SUl U(aURU5UlX lU(aURU5UlX0lU(aL[ R""U5UlX@l [%UR[&5(d [S5eU(a[ R""U5n U cSUlO@[)[*U SV V V s/sHupo[-U 5U 4PM sn n n U S45UlX`l UR bQ[1S UR S55(a"[%UR S[&5(d [S 5eU(aUR3U5UlXPl gg![[4an[S5UeSnAff=f![[4an[S5UeSnAff=f![[4an[S5UeSnAff=f![[4an[S5UeSnAff=fs sn n n f![[.4an[S 5UeSnAff=f![[4an[S 5UeSnAff=f) N)rr!z4Unable to deserialize user_data_json. Not valid JSONz4Unable to deserialize chat_data_json. Not valid JSONz3Unable to deserialize bot_data_json. Not valid JSONz%bot_data_json must be serialized dictz8Unable to deserialize callback_data_json. Not valid JSONrz0callback_data_json is not in the required formatc3|# UH2n[US[5=(a [US[5v M4 g7f)rN) isinstancedictstr).0entrys H/app/.venv/lib/python3.13/site-packages/telegram/ext/_dictpersistence.py +DictPersistence.__init__..s5!7uQx.L:eAh3LL!7s:<z8Unable to deserialize conversations_json. Not valid JSON)super__init__rrrrrrrrrr _decode_user_chat_data_from_json ValueErrorAttributeError TypeErrorjsonloadsr&r'rr float IndexErrorall_decode_conversations_from_json)selfrrrrrr r!excdataonetwothree __class__s r+r/DictPersistence.__init__]s JP"".2.2-126 26  a"&"G"G"W'5$  a"&"G"G"W'5$  `!%M!:&3#dnnd33 GHH  zz"45 ]<*.D'*.JNq'R'sc E2'RTXYZT[\+D',>("".!%!4!4Q!7"$"5"5a"8$?? RSS  &*&J&JK]&^#+=( [/ a VW]`` a / a VW]`` a / ` UV\__ `/ N S + ] RSY\\ ]/ N sG$H%!H,8II;-I4I;J$H4 HHH) H$$H),I < II I1 I,,I14I;;J JJK/ J;;KreturncUR$)z%:obj:`dict`: The user_data as a dict.)rr:s r+ user_dataDictPersistence.user_datac|UR(a UR$[R"UR5$)z6:obj:`str`: The user_data serialized as a JSON-string.)rr4dumpsrErDs r+rDictPersistence.user_data_json,   '' 'zz$..))rHcUR$)z%:obj:`dict`: The chat_data as a dict.)rrDs r+ chat_dataDictPersistence.chat_datarGrHc|UR(a UR$[R"UR5$)z6:obj:`str`: The chat_data serialized as a JSON-string.)rr4rJrNrDs r+rDictPersistence.chat_data_jsonrLrHcUR$)z$:obj:`dict`: The bot_data as a dict.)rrDs r+bot_dataDictPersistence.bot_datas~~rHc|UR(a UR$[R"UR5$)z5:obj:`str`: The bot_data serialized as a JSON-string.)rr4rJrSrDs r+rDictPersistence.bot_data_jsons,   && &zz$--((rHcUR$)ztuple[list[tuple[:obj:`str`, :obj:`float`, dict[:obj:`str`, :class:`object`]]], dict[:obj:`str`, :obj:`str`]]: The metadata on the stored callback data. .. versionadded:: 13.6 )rrDs r+ callback_dataDictPersistence.callback_datas"""rHc|UR(a UR$[R"UR5$)z_:obj:`str`: The metadata on the stored callback data as a JSON-string. .. versionadded:: 13.6 )rr4rJrXrDs r+r "DictPersistence.callback_data_jsons.  # #++ +zz$,,--rHcUR$)z):obj:`dict`: The conversations as a dict.)rrDs r+ conversationsDictPersistence.conversationss"""rHcUR(a UR$UR(aURUR5$[R"UR5$)z::obj:`str`: The conversations serialized as a JSON-string.)rr]_encode_conversations_to_jsonr4rJrDs r+r"DictPersistence.conversations_jsonsN  # #++ +   55d6H6HI Izz$,,--rHc\# URc0Ul[UR5$7f)zReturns the user_data created from the ``user_data_json`` or an empty :obj:`dict`. Returns: :obj:`dict`: The restored user data. )rErrrDs r+ get_user_dataDictPersistence.get_user_data' >> ! DO''*,c\# URc0Ul[UR5$7f)zReturns the chat_data created from the ``chat_data_json`` or an empty :obj:`dict`. Returns: :obj:`dict`: The restored chat data. )rNrrrDs r+ get_chat_dataDictPersistence.get_chat_datarerfc\# URc0Ul[UR5$7f)zReturns the bot_data created from the ``bot_data_json`` or an empty :obj:`dict`. Returns: :obj:`dict`: The restored bot data. )rSrrrDs r+ get_bot_dataDictPersistence.get_bot_datas' == DN &&rfc^# URcSUlg[UR5$7f)aDReturns the callback_data created from the ``callback_data_json`` or :obj:`None`. .. versionadded:: 13.6 Returns: tuple[list[tuple[:obj:`str`, :obj:`float`, dict[:obj:`str`, :class:`object`]]], dict[:obj:`str`, :obj:`str`]]: The restored metadata or :obj:`None`, if no data was stored. N)rXrrrDs r+get_callback_data!DictPersistence.get_callback_datas/    %"&D **++s+-namec# URc0UlURRU05R5$7f)zReturns the conversations created from the ``conversations_json`` or an empty :obj:`dict`. Returns: :obj:`dict`: The restored conversations data. )r]rgetcopy)r:rps r+get_conversations!DictPersistence.get_conversationss=    %"$D !!%%dB/4466s?Akey new_statec# UR(d0UlURRU05RU5U:XagX0RUU'SUlg7f)zWill update the conversations for the given handler. Args: name (:obj:`str`): The handler's name. key (:obj:`tuple`): The key the state is changed for. new_state (:obj:`tuple` | :class:`object`): The new state for the given key. N)r setdefaultrrr)r:rprvrws r+update_conversation#DictPersistence.update_conversation)s\"""$D     ) )$ 3 7 7 < I )2D!#&#' sA"A$user_idr<c# URc0UlURRU5U:XagX RU'SUlg7f)zWill update the user_data (if changed). Args: user_id (:obj:`int`): The user the data might have been changed for. data (:obj:`dict`): The :attr:`telegram.ext.Application.user_data` ``[user_id]``. N)rrrr)r:r|r<s r+update_user_data DictPersistence.update_user_data:F ?? " DO ??  w '4 / #' #A A chat_idc# URc0UlURRU5U:XagX RU'SUlg7f)zWill update the chat_data (if changed). Args: chat_id (:obj:`int`): The chat the data might have been changed for. data (:obj:`dict`): The :attr:`telegram.ext.Application.chat_data` ``[chat_id]``. N)rrrr)r:rr<s r+update_chat_data DictPersistence.update_chat_dataHrrcH# URU:XagXlSUlg7f)zuWill update the bot_data (if changed). Args: data (:obj:`dict`): The :attr:`telegram.ext.Application.bot_data`. N)rrr:r<s r+update_bot_dataDictPersistence.update_bot_dataVs# >>T ! " "cH# URU:XagXlSUlg7f)a#Will update the callback_data (if changed). .. versionadded:: 13.6 Args: data (tuple[list[tuple[:obj:`str`, :obj:`float`, dict[:obj:`str`, :class:`object`]]], dict[:obj:`str`, :obj:`str`]]): The relevant data to restore :class:`telegram.ext.CallbackDataCache`. N)rrrs r+update_callback_data$DictPersistence.update_callback_dataas&   $ & "#' rcn# URcgURRUS5 SUlg7f)zWill delete the specified key from the :attr:`chat_data`. .. versionadded:: 20.0 Args: chat_id (:obj:`int`): The chat id to delete from the persistence. N)rpopr)r:rs r+drop_chat_dataDictPersistence.drop_chat_datap0 ?? "  GT*#35cn# URcgURRUS5 SUlg7f)zWill delete the specified key from the :attr:`user_data`. .. versionadded:: 20.0 Args: user_id (:obj:`int`): The user id to delete from the persistence. N)rrr)r:r|s r+drop_user_dataDictPersistence.drop_user_data}rrrEc # g7f)zjDoes nothing. .. versionadded:: 13.6 .. seealso:: :meth:`telegram.ext.BasePersistence.refresh_user_data` N)r:r|rEs r+refresh_user_data!DictPersistence.refresh_user_datarNc # g7f)zjDoes nothing. .. versionadded:: 13.6 .. seealso:: :meth:`telegram.ext.BasePersistence.refresh_chat_data` Nr)r:rrNs r+refresh_chat_data!DictPersistence.refresh_chat_datarrrSc # g7f)ziDoes nothing. .. versionadded:: 13.6 .. seealso:: :meth:`telegram.ext.BasePersistence.refresh_bot_data` Nr)r:rSs r+refresh_bot_data DictPersistence.refresh_bot_datarrc # g7f)z^Does nothing. .. versionadded:: 20.0 .. seealso:: :meth:`telegram.ext.BasePersistence.flush` NrrDs r+flushDictPersistence.flushrrr]c0nUR5H=up#0X'UR5H upEXQU[R"U5'M" M? [R"U5$)a6Helper method to encode a conversations dict (that uses tuples as keys) to a JSON-serializable way. Use :meth:`self._decode_conversations_from_json` to decode. Args: conversations (:obj:`dict`): The conversations dict to transform to JSON. Returns: :obj:`str`: The JSON-serialized conversations dict )itemsr4rJ)r]tmphandlerstatesrvstates r+r`-DictPersistence._encode_conversations_to_jsons[$&,224OGCL$lln 05G TZZ_-- 5zz#rH json_stringc [R"U5n0nUR5HFup40X#'UR5H)upVXbU[[R"U55'M+ MH U$)a!Helper method to decode a conversations dict (that uses tuples as keys) from a JSON-string created with :meth:`self._encode_conversations_to_json`. Args: json_string (:obj:`str`): The conversations dict as JSON string. Returns: :obj:`dict`: The conversations dict after decoding )r4r5rtuple)rrr]rrrvrs r+r9/DictPersistence._decode_conversations_from_jsonsejj%57 "yy{OG%'M "$lln AFg&uTZZ_'=>- +rHc0n[R"U5nUR5H@up4[U5n0X'UR5Hupg[U5nXqUU'M MB U$![a UnNf=f)zHelper method to decode chat or user data (that uses ints as keys) from a JSON-string. Args: data (:obj:`str`): The user/chat_data dict as JSON string. Returns: :obj:`dict`: The user/chat_data defaultdict after decoding )r4r5rintr1) r<r decoded_datauserrE int_user_idrvvalue_ids r+r00DictPersistence._decode_user_chat_data_from_jsons02zz$' +113ODd)K!C 'oo/ c(C).K % 0 4 "Cs A// A>=A>)Nrrrr<)rBN)3__name__ __module__ __qualname____firstlineno____doc__ __slots__rr r(r6r/propertyr'rrrErrNrrSrr rXr r r]robjectrcrhrkrnrtr rzr~rrrrrrrrr staticmethodr`r9r0__static_attributes__ __classcell__)r@s@r+rrs.` I26  "$"$!#M-.MM M  M  M MMM^8Dd38n)<$=>*** 8Dd38n)<$=>*** (4S>2)s)) #x0##.C..#xS2B-B(CD##.C..(T#tFFN/C*C%D((T#tFFN/C*C%D('D$8' ,'): , 7C 74D 7((-(:B6:J( (" $c $c3h $D $ $c $c3h $D $ #$sCx. #T # (w (4 ( $C $D $ $C $D $ s tCH~ RV  s tCH~ RV  tCH~ $  T#?O:O5PUX"ST#GWBW=X$stCffnAUrsX&6 55:PP.Bod38nd38nd3PS8n&TUBrH