o h@sddlmZddlZddlZddlZddlmZmZejdkr&ddlm Z nddl m Z er@ejdkr:ddlm Z nddl m Z gdZ Gd d d eZd(ddZddeddd)ddZ dedddd*d!d"Ze Z Gd#d$d$Zead+d&d'ZdS),) annotationsN) TYPE_CHECKINGLiteral) ) deprecated)r ) LiteralString)AltairDeprecationWarningrdeprecated_static_onlydeprecated_warnc@s eZdZdS)r N)__name__ __module__ __qualname__rrL/var/www/vscode/kcb/lib/python3.10/site-packages/altair/utils/deprecation.pyr s r versionr alternativeLiteralString | NonemessagereturncCs6d|d}|r|d|d}|r|d|S|S)Nz Deprecated since `altair=z`.z Use z instead. r)rrroutputrrr_format_messages r)rrcategory stacklevelr%type[AltairDeprecationWarning] | NonerintcCst|||}t|||dS)a Indicate that a class, function or overload is deprecated. When this decorator is applied to an object, the type checker will generate a diagnostic on usage of the deprecated object. Parameters ---------- version ``altair`` version the deprecation first appeared. alternative Suggested replacement class/method/function. message Additional message appended to ``version``, ``alternative``. category If the *category* is ``None``, no warning is emitted at runtime. stacklevel The *stacklevel* determines where the warning is emitted. If it is ``1`` (the default), the warning is emitted at the direct caller of the deprecated object; if it is higher, it is emitted further up the stack. Static type checker behavior is not affected by the *category* and *stacklevel* arguments. References ---------- [PEP 702](https://peps.python.org/pep-0702/) rr)r _deprecated)rrrrrmsgrrrr-s $r)rrractiontype[AltairDeprecationWarning]r#Literal['once'] | NoneNonecCsJt|||}|durtj|||ddS|dkr!t|||ddSt|)ar Indicate that the current code path is deprecated. This should be used for non-trivial cases *only*. ``@deprecated`` should always be preferred as it is recognized by static type checkers. Parameters ---------- message Explanation of the deprecated behaviour. .. note:: Unlike ``@deprecated``, this is *not* optional. version ``altair`` version the deprecation first appeared. alternative Suggested replacement argument/method/function. category The runtime warning type emitted. stacklevel How far up the call stack to make this warning appear. A value of ``2`` attributes the warning to the caller of the code calling ``deprecated_warn()``. References ---------- [warnings.warn](https://docs.python.org/3/library/warnings.html#warnings.warn) Nronce)rwarningswarn _warn_onceNotImplementedError)rrrrrr#r!rrrr Us &r c@s4eZdZdddZddd Zdd d Zdd d ZdS)_WarningsMonitorrr&cCsi|_t|_dSN)_warned threadingLock_lockselfrrr__init__sz_WarningsMonitor.__init__keyr boolcCs4|j ||jvWdS1swYdSr-r1r.r3r5rrr __contains__s$z_WarningsMonitor.__contains__cCs6|jd|j|<WddS1swYdS)NTr7r8rrrhit "z_WarningsMonitor.hitcCs6|j|jWddS1swYdSr-)r1r.clearr2rrrr<r;z_WarningsMonitor.clearN)rr&)r5r rr6)r5r rr&)r rrr4r9r:r<rrrrr,s    r,r!cCs.|tvrdSt|tj|||dddS)Nrr)_warnings_monitorr:r(r))r!rrrrrr*s r*)rr rrrrrr ) rr rrrrrrrr)rr rr rrrr$rrr#r%rr&)r!r rr$rrrr&) __future__rsysr/r(typingrr version_inforr typing_extensionsr __all__DeprecationWarningr rr r r,r=r*rrrrs<      ,/"