o HEDi/ @sddlZddlZddlZddlZddlmZmZmZmZm Z ddefddZ e dfddZ dd e d e d e d efddZdde d e d efddZedZedZGdddeeefZdS)N)CallableGenericTypeVarTypeOptionalreturncsvttrfdd}|Ststr3tr"dndtfdd}|Sttt )a This is a decorator which can be used to mark functions as deprecated. It will result in a warning being emitted when the function is used. Source: https://stackoverflow.com/questions/2536307/decorators-in-the-python-standard-lib-deprecated-specifically cs4trdndtfdd}|S)Nz+Call to deprecated class {name} ({reason}).z.Call to deprecated function {name} ({reason}).cs2tjjddtdt|i|S)N)namereason stackleveldefault)warn_deprecatedformat__name__warnings simplefilterDeprecationWarningargskwargs)funcmsgr r g/var/www/www-root/data/www/ovozai.pdev.uz/venv/lib/python3.10/site-packages/aiogram/utils/deprecated.pywrapper"s z.deprecated..decorator..wrapper)inspectisclass functoolswraps)rr)r r )rrr decorators zdeprecated..decoratorz Call to deprecated class {name}.z#Call to deprecated function {name}.cs$tjjdd|i|S)N)r r )rrrr)func1msg1r rrwrapper1=szdeprecated..wrapper1) isinstancestrrr isfunctionrr TypeErrorreprtype)r r r r#r)r!r"r r r deprecateds   r*cCs,td|tj|||dtd|dS)Nalways)categoryr r )rrwarn)messagewarningr rrrrGs rold_namenew_name until_versionr csfdd}|S)al A meta-decorator to mark an argument as deprecated. .. code-block:: python3 @renamed_argument("chat", "chat_id", "3.0") # stacklevel=3 by default @renamed_argument("user", "user_id", "3.0", stacklevel=4) def some_function(user_id, chat_id=None): print(f"user_id={user_id}, chat_id={chat_id}") some_function(user=123) # prints 'user_id=123, chat_id=None' with warning some_function(123) # prints 'user_id=123, chat_id=None' without warning some_function(user_id=123) # prints 'user_id=123, chat_id=None' without warning :param old_name: :param new_name: :param until_version: the version in which the argument is scheduled to be removed :param stacklevel: leave it to default if it's the first decorator used. Increment with any new decorator used. :return: decorator cs\tfddr tfdd}|Stfdd}|S)Nc s`rdnd}|vr.td|djddd d|}||i|S) < Returns updated version of kwargs. coroutinefunctionIn z 'z ' argument 'z' is renamed to 'z!' and will be removed in aiogram r )rrcopyupdatepopr routine_type)r is_coroutiner2r1r r3rr _handlinghs z6renamed_argument..decorator.._handlingc|}|i|IdHSNrrr>rrrwrappedwz4renamed_argument..decorator..wrappedc|}|i|Sr@rrrArrrB|asyncioiscoroutinefunctionrrrrBr2r1r r3r>rr=rr es  z#renamed_argument..decoratorr)r1r2r3r r rrJrrenamed_argumentMsrLr csfdd}|S)a A meta-decorator to mark an argument as removed. .. code-block:: python3 @removed_argument("until_date", "3.0") # stacklevel=3 by default def some_function(user_id, chat_id=None): print(f"user_id={user_id}, chat_id={chat_id}") :param name: :param until_version: the version in which the argument is scheduled to be removed :param stacklevel: leave it to default if it's the first decorator used. Increment with any new decorator used. :return: decorator csZtfddrtfdd}|Stfdd}|S)Nc sLrdnd}|vr$td|djddd|}|=|S)r4r5r6r7 z argument z% is planned to be removed in aiogram r )rrr8r;)rr=r r r3rrr>s z6removed_argument..decorator.._handlingcr?r@rrrArrrBrCz4removed_argument..decorator..wrappedcrDr@rrrArrrBrErFrIr r r3rKrr s  z#removed_argument..decoratorr)r r3r r rrNrremoved_argumentsrO_VT _OwnerClsc@sJeZdZdZdZdedeegeffddZ de ede efd d Z d S) DeprecatedReadOnlyClassVaraf DeprecatedReadOnlyClassVar[Owner, ValueType] :param warning_message: Warning message when getter gets called :param new_value_getter: Any callable with (owner_class: Type[Owner]) -> ValueType signature that will be executed Usage example: >>> class MyClass: ... some_attribute: DeprecatedReadOnlyClassVar[MyClass, int] = ... DeprecatedReadOnlyClassVar( ... "Warning message.", lambda owner: 15) ... >>> MyClass.some_attribute # does warning.warn with `Warning message` and returns 15 in the current case )_new_value_getter_warning_messagewarning_messagenew_value_gettercCs||_||_dSr@)rTrS)selfrUrVrrr__init__s z#DeprecatedReadOnlyClassVar.__init__instanceownercCst|jdd||S)Nr0r )rrTrS)rWrYrZrrr__get__s z"DeprecatedReadOnlyClassVar.__get__N) r __module__ __qualname____doc__ __slots__r%rrQrPrXrrr[rrrrrRs rR)r)r0)rGrrrtypingrrrrrr*rrr%intrLrOrPrQrRrrrrs?93