iiddlmZddlZddlmZddlmZmZmZm Z ddl m Z ddl m Z dZe dZe d Zed Zdddd d d%dZdddd ddd&dZddddd dd'd$ZdS)() annotationsNwraps)AnyCallableLiteralTypeVar)warn) ParamSpec)check_for_deprecated_parameters deprecatedwarn_deprecationTP) functionmethod classmethod attributepropertydefaultclass parameterimportF) removal_in alternativeinfopendingversionstrdeprecated_namekindDeprecatedKindr str | NonerrrboolreturnNonecg}|dkrd}n |dvrd}nd}|r||d|d|n||d|d||d |d |d |pd f|r|d |d|r||d|} |rtnt} t | | ddS)a Warn about a call to a (soon to be) deprecated function. Args: version: Polyfactory version where the deprecation will occur. deprecated_name: Name of the deprecated function. removal_in: Polyfactory version where the deprecated function will be removed. alternative: Name of a function that should be used instead. info: Additional information. pending: Use ``PendingDeprecationWarning`` instead of ``DeprecationWarning``. kind: Type of the deprecated thing. rz Import of>rrzCall tozUse of z awaiting deprecation z deprecated zDeprecated in polyfactory zThis z will be removed in zthe next major versionzUse z insteadz. ) stacklevelN)appendextendjoinPendingDeprecationWarningDeprecationWarningr ) rr r!rrrrparts access_typetext warning_classs u/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/polyfactory/utils/deprecation.pyrrsM* E x! ' ' '  M UUdUU/UUVVVV KKKKKKLLL LL 2 2 2 VD V Vj.TPM}++++++)rrrrr!?Literal['function', 'method', 'classmethod', 'property'] | None*Callable[[Callable[P, T]], Callable[P, T]]c(dfd }|S)aCreate a decorator wrapping a function, method or property with a warning call about a (pending) deprecation. Args: version: Polyfactory version where the deprecation will occur. removal_in: Polyfactory version where the deprecated function will be removed. alternative: Name of a function that should be used instead. info: Additional information. pending: Use ``PendingDeprecationWarning`` instead of ``DeprecationWarning``. kind: Type of the deprecated callable. If ``None``, will use ``inspect`` to figure out if it's a function or method. Returns: A decorator wrapping the function call with a warning funcCallable[P, T]r%c Ltdfd }|S) NargsP.argskwargsP.kwargsr%rc ztjptjrdnd|i|S)Nrrrr rrrrr!)r__name__inspectismethod) r<r>rr9rr!rrrs r4wrappedz.deprecated..decorator..wrappedbsa  $ '%Q'*:4*@*@Phhj    4((( (r5)r<r=r>r?r%rr)r9rErrr!rrrs` r4 decoratorzdeprecated..decoratorasW t ) ) ) ) ) ) ) ) ) ) )  )r5)r9r:r%r:)rrrrrr!rFs`````` r4r r IsG0 r5) default_valuerrrr parameterstuple[tuple[str, Any], ...]rHrc P|D]"\}}||kr t||||||d#dS)aWarn about a call to a (soon to be) deprecated argument to a function. Args: version: Polyfactory version where the deprecation will occur. parameters: Parameters to trigger warning if used. default_value: Default value for parameter to detect if supplied or not. removal_in: Polyfactory version where the deprecated function will be removed. alternative: Name of a function that should be used instead. info: Additional information. pending: Use ``PendingDeprecationWarning`` instead of ``DeprecationWarning``. kind: Type of the deprecated callable. If ``None``, will use ``inspect`` to figure out if it's a function or method. rrAN)r) rrIrHrrrrparameter_namevalues r4r r tsa.",    M ! ! *#!       r5)rrr rr!r"rr#rr#rr#rr$r%r&)rrrr#rr#rr#rr$r!r6r%r7)rrrIrJrHrrr#rr#rr#rr$r%r&) __future__rrC functoolsrtypingrrrr warningsr typing_extensionsr __all__rrr"rr r rGr5r4rTs>""""""222222222222'''''' O GCLL IcNNk""2,2,2,2,2,2,p""LP((((((^!"# # # # # # # # r5