Ë
|
oñúhÒB ã óF d dl mZ d dlmZ d dlZd dlmZ d dlmZm Z m
|
Z
|
m Z d dl Z d dl mZ d dlmZmZ d dlmZ erd d lmZ d dd
|
Z d dd Zdd Zdd Z d d dZd dZ G d d« Z G d d« Z d d dZ g d¢Z y)!é )Ú annotations)ÚwrapsN)Údedent)Ú TYPE_CHECKINGÚAnyÚCallableÚcast)Úcache_readonly)ÚFÚT)Úfind_stack_level)ÚMappingc óî |xs j }xs t |xs | d| d t « d fd « }|xs d| d}dj }j rj j d« dk r t |« j j dd« \ } }
|
} } | s| r |
|
s t |« t d |
|
j « d
|
| d | d t | « « |_ |S )a
|
Return a new function that emits a deprecation warning on use.
|
|
To use this method for a deprecated function, another function
|
`alternative` with the same signature must exist. The deprecated
|
function will emit a deprecation warning, and in the docstring
|
it will contain the deprecation directive with the provided version
|
so it can be detected for future removal.
|
|
Parameters
|
----------
|
name : str
|
Name of function to deprecate.
|
alternative : func
|
Function to use instead.
|
version : str
|
Version of pandas in which the method has been deprecated.
|
alt_name : str, optional
|
Name to use in preference of alternative.__name__.
|
klass : Warning, default FutureWarning
|
stacklevel : int, default 2
|
msg : str
|
The message to display in the warning.
|
Default is '{name} is deprecated. Use {alt_name} instead.'
|
z is deprecated, use ú instead.c óD t j ¬« | i |¤S )N©Ú
|
stacklevel)ÚwarningsÚwarn)ÚargsÚkwargsÚ alternativeÚklassr Ú warning_msgs úJH:\Change_password\venv_build\Lib\site-packages\pandas/util/_decorators.pyÚwrapperzdeprecate.<locals>.wrapper? s# ø ä k 5°ZÕ@ÙDÐ+ FÑ+Ð+ó zUse `z
|
` instead.z§deprecate needs a correctly formatted docstring in the target function (should have a one liner short summary, and opening quotes should be in their own line). Found:
|
ú
|
é z
|
z
|
|
.. deprecated:: z
|
z
|
|
|
©ÚreturnúCallable[..., Any]) Ú__name__Ú FutureWarningr Ú__doc__ÚcountÚAssertionErrorÚsplitr Ústrip)Únamer ÚversionÚalt_namer r Úmsgr Ú doc_error_msgÚempty1ÚsummaryÚempty2Ú
|
doc_stringr s ` `` @r Ú deprecater3 s0 û ðD Ò/;×/Ñ/HØ Ò "]EØÒID6Ð!5°h°Z¸yÐIKä
|
;Ó÷,ó ð,ð
|
Ò
|
-5
|
*Ð-Cð ð &×-Ñ-Ð.ð 0ð ð ×ÒØ × Ñ × $Ñ $ TÓ *¨QÒ .Ü Ó/Ð /Ø.9×.AÑ.A×.GÑ.GÈÈaÓ.PÑ+ Ù V¡GÜ Ó/Ð /Ü ð Ø Ðð à ð " Ø Eð ä
|
Ó Ð ð ó
|
ð Nr c óh "t d« st « s t d« d fd }|S )a¶
|
Decorator to deprecate a keyword argument of a function.
|
|
Parameters
|
----------
|
old_arg_name : str
|
Name of argument in function to deprecate
|
new_arg_name : str or None
|
Name of preferred argument in function. Use None to raise warning that
|
``old_arg_name`` keyword is deprecated.
|
mapping : dict or callable
|
If mapping is present, use it to translate old arguments to
|
new arguments. A callable must do its own value checking;
|
values not found in a dict will be forwarded unchanged.
|
|
Examples
|
--------
|
The following deprecates 'cols', using 'columns' instead
|
|
>>> @deprecate_kwarg(old_arg_name='cols', new_arg_name='columns')
|
... def f(columns=''):
|
... print(columns)
|
...
|
>>> f(columns='should work ok')
|
should work ok
|
|
>>> f(cols='should raise warning') # doctest: +SKIP
|
FutureWarning: cols is deprecated, use columns instead
|
warnings.warn(msg, FutureWarning)
|
should raise warning
|
|
>>> f(cols='should error', columns="can't pass do both") # doctest: +SKIP
|
TypeError: Can only specify 'cols' or 'columns', not both
|
|
>>> @deprecate_kwarg('old', 'new', {'yes': True, 'no': False})
|
... def f(new=False):
|
... print('yes!' if new else 'no!')
|
...
|
>>> f(old='yes') # doctest: +SKIP
|
FutureWarning: old='yes' is deprecated, use new=True instead
|
warnings.warn(msg, FutureWarning)
|
yes!
|
|
To raise a warning that a keyword will be removed entirely in the future
|
|
>>> @deprecate_kwarg(old_arg_name='cols', new_arg_name=None)
|
... def f(cols='', another_param=''):
|
... print(cols)
|
...
|
>>> f(cols='should raise warning') # doctest: +SKIP
|
FutureWarning: the 'cols' keyword is deprecated and will be removed in a
|
future version please takes steps to stop use of 'cols'
|
should raise warning
|
>>> f(another_param='should not raise warning') # doctest: +SKIP
|
should not raise warning
|
|
>>> f(cols='should raise warning', another_param='') # doctest: +SKIP
|
FutureWarning: the 'cols' keyword is deprecated and will be removed in a
|
future version please takes steps to stop use of 'cols'
|
should raise warning
|
ÚgetzAmapping from old to new argument values must be dict or callable!c óV t « d fd « }t t |« S )Nc
|
óF |j d « }|Cdt « dt « }t j |t ¬« ||< | i |¤S Ht « r |« }nj ||« }d dt |« d dt |« d }n |}dt « dt « d}t j |t ¬« |j « &dt « dt « d }t |« ||< | i |¤S )
|
Nzthe ze keyword is deprecated and will be removed in a future version. Please take steps to stop the use of r ú=z keyword is deprecated, use r zCan only specify z or z , not both.)ÚpopÚreprr r r$ Úcallabler5 Ú TypeError)
|
r r Ú old_arg_valuer- Ú new_arg_valueÚfuncÚmappingÚ new_arg_nameÚ old_arg_namer s
|
r r z:deprecate_kwarg.<locals>._deprecate_kwarg.<locals>.wrapper ss ø à "JJ |°TÓ :Mà Ñ(Ø Ð'à t LÓ 1Ð 2ð 34ä48¸ Ó4FÐ3GðIð ô
|
MM #¤}ÀÕLØ+8F<Ñ(Ù Ð0¨Ñ0Ð0à Ð(Ü Ô(Ù(/° Ó(> à(/¯ © °MÀ=Ó(Q à |n¨A¬d°=Ó.AÐ-Bð C+à'.¨¬$¨}Ó*=Ð)>¸iðIñ ð %2Mà t LÓ 1Ð 2ð 3 Ü # LÓ 1Ð 2°)ð=ð ô
|
c¤=¸ZÕHØ::lÓ+Ð7à+¬D° Ó,>Ð+?ð @ Ü " <Ó 0Ð 1°ð>ð ô $ C.Ð(Ø'4|Ñ$ÙÐ( Ñ(Ð (r r )r r r )r? r r@ rA rB r s ` r Ú_deprecate_kwargz)deprecate_kwarg.<locals>._deprecate_kwarg¬ s. ù Ü t÷' )ð ' )ó
|
ð' )ôR AwÓ Ð r ©r? r r! r )Úhasattrr; r< )rB rA r@ r rC s ```` r Údeprecate_kwargrF d s? û ðF Ф7¨7°EÔ#:Ä8ÈGÔCTÜØ Oó
|
ð
|
÷+ ð + ðZ Ðr c óÖ d| v r| j d« | syt | « dk( r d| d dS | d }dj | d d D cg c]
|
}d|z dz c}« }d
|
| d | dS c c}w ) a5
|
Convert the allow_args argument (either string or integer) of
|
`deprecate_nonkeyword_arguments` function to a string describing
|
it to be inserted into warning message.
|
|
Parameters
|
----------
|
allowed_args : list, tuple or int
|
The `allowed_args` argument for `deprecate_nonkeyword_arguments`,
|
but None value is not allowed.
|
|
Returns
|
-------
|
str
|
The substring describing the argument list in best way to be
|
inserted to the warning message.
|
|
Examples
|
--------
|
`format_argument_list([])` -> ''
|
`format_argument_list(['a'])` -> "except for the arguments 'a'"
|
`format_argument_list(['a', 'b'])` -> "except for the arguments 'a' and 'b'"
|
`format_argument_list(['a', 'b', 'c'])` ->
|
"except for the arguments 'a', 'b' and 'c'"
|
ÚselfÚ é z except for the argument 'r ú'éÿÿÿÿz, Nz except for the arguments z and ')ÚremoveÚlenÚjoin)Ú
|
allow_argsÚlastÚxr s r Ú_format_argument_listrS Ü s ð4 ÑØ×Ñ&Ô!Ù ØÜ Z AÒ Ø+¨J°q©M¨?¸!Ð<Ð<à"~Øyy°¸C¸R° ÖA¨A# ' C-ÒAÓBØ+¨D¨6°¸°v¸QÐ?Ð?ùò Bs ÁA&c ó | yd| S )zCSpecify which version of pandas the deprecation will take place in.z In a future version of pandasz Starting with pandas version © )r+ s r Úfuture_version_msgrV s àØ.à.¨w¨iÐ8Ð8r c ó fd}|S )a
|
Decorator to deprecate a use of non-keyword arguments of a function.
|
|
Parameters
|
----------
|
version : str, optional
|
The version in which positional arguments will become
|
keyword-only. If None, then the warning message won't
|
specify any particular version.
|
|
allowed_args : list, optional
|
In case of list, it must be the list of names of some
|
first arguments of the decorated functions that are
|
OK to be given as positional arguments. In case of None value,
|
defaults to list of all arguments not having the
|
default value.
|
|
name : str, optional
|
The specific name of the function to show in the warning
|
message. If None, then the Qualified name of the function
|
is used.
|
c óö t j « } nn|j j « D cg c]J }|j |j
|
|j fv r$|j |j u r |j L c}|j j « D cg c]R }|j |j
|
|j fv r*|j vr |j |j ¬« n|T }}|j d ¬« |j |¬« }t « t « d
|
xs j dt! « fd« }||_ |S c c}w c c}w )N©Úkindc ó | j S ©NrY )Úps r ú<lambda>zBdeprecate_nonkeyword_arguments.<locals>.decorate.<locals>.<lambda>< s
|
a§f¡f r )Úkey)Ú
|
parametersz all arguments of z!{arguments} will be keyword-only.c óª t | « kD r=t j j t « ¬« t
|
t « ¬« | i |¤S )N)Ú argumentsr )rN r r ÚformatrS r$ r )r r rP r? r- Únum_allow_argss r r zAdeprecate_nonkeyword_arguments.<locals>.decorate.<locals>.wrapperE sJ ø ä4y>Ò)Ü ØJJÔ)>¸zÓ)JJÓKÜ!Ü /Ó 1õñ
|
Ð( Ñ(Ð (r )ÚinspectÚ signaturer` ÚvaluesrZ ÚPOSITIONAL_ONLYÚPOSITIONAL_OR_KEYWORDÚdefaultÚemptyr* ÚreplaceÚ KEYWORD_ONLYÚsortrN rV Ú __qualname__r Ú __signature__) r? Úold_sigr] Ú
|
new_paramsÚnew_sigr rP r- rd Ú allowed_argsr* r+ s ` @@@r Údecoratez0deprecate_nonkeyword_arguments.<locals>.decorate& su ü Ü×#Ñ# DÓ)à Ð #Ø%Jð !×+Ñ+×2Ñ2Ó4öàØ66a× /Ñ /°×1HÑ1HÐ IÑIØII §¡Ñ(ð òJð ×'Ñ'×.Ñ.Ó0ö
|
ð ð 1×,Ñ,¨a×.EÑ.EÐFÑFØFF *Ñ,ð II1>>IÔ *ð
|
ñ ð
|
|
ð
|
ð Ñ ,Ô-Ø//¨Z/Ó8ä Z ä! 'Ó*Ð+Ð+=ØÒ(t×(Ñ(Ð)Ð)Lð Nð ô
|
|
tö )ó
|
ð )ð !(Ô ØùòMùò
|
s ¼AE1Â*AE6rU )r+ rt r* ru s ``` r Ú deprecate_nonkeyword_argumentsrv
|
s ú ö8,ð\ Or c ó d fd }|S )aÔ
|
A decorator to take docstring templates, concatenate them and perform string
|
substitution on them.
|
|
This decorator will add a variable "_docstring_components" to the wrapped
|
callable to keep track the original docstring template for potential usage.
|
If it should be consider as a template, it will be saved as a string.
|
Otherwise, it will be saved as callable, and later user __doc__ and dedent
|
to get docstring.
|
|
Parameters
|
----------
|
*docstrings : None, str, or callable
|
The string / docstring / docstring template to be appended in order
|
after default docstring under callable.
|
**params
|
The string which would be used to format docstring template.
|
c óf g }| j r$|j t | j « « D ][ }|t |d« r |j |j
|
« .t |t « s |j sK|j |« ] |D cg c]4 }t |t « r t « dkD r |j di ¤n|6 }}dj |D cg c]- }t |t « r|nt |j xs d« / c}« | _ || _ | S c c}w c c}w )NÚ_docstring_componentsr rI rU ) r% Úappendr rE Úextendry Ú
|
isinstanceÚstrrN rc rO )Ú decoratedÚdocstring_componentsÚ docstringÚ componentÚparams_appliedÚ
|
docstringsÚparamss r Ú decoratorzdoc.<locals>.decoratork sF ø à57Ð Ø × Ò Ø × 'Ñ '¬¨y×/@Ñ/@Ó(AÔ Bà#ò 7IØÐ ØÜyÐ"9Ô:Ø$×+Ñ+Ø ×3Ñ3õô I¤sÔ+¨y×/@Ó/@Ø$×+Ñ+¨IÕ6ð 7ð 2ö
|
ð ô )¤SÔ)¬c°&«k¸Aªoð I× Ñ Ñ &vÒ &àñ ð
|
ð
|
ð GGð
|
"0ö ð ô i¬Ô-ñ äI× -Ñ -Ò 3°Ó4ñ5ò ó
|
Ôð !ð Ô'ð Ðùò)
|
ùò s Â9D)Ã"2D.)r~ r r! r rU )r r r
s `` r Údocr W s ù ö($ðL Ðr c ó( e Zd ZdZddZddZddZy)Ú Substitutiona/
|
A decorator to take a function's docstring and perform string
|
substitution on it.
|
|
This decorator should be robust even if func.__doc__ is None
|
(for example, if -OO was passed to the interpreter)
|
|
Usage: construct a docstring.Substitution with a sequence or
|
dictionary suitable for performing substitution; then
|
decorate a suitable function with the constructed object. e.g.
|
|
sub_author_name = Substitution(author='Jason')
|
|
@sub_author_name
|
def some_function(x):
|
"%(author)s wrote this function"
|
|
# note that some_function.__doc__ is now "Jason wrote this function"
|
|
One can also use positional arguments.
|
|
sub_first_last_names = Substitution('Edgar Allen', 'Poe')
|
|
@sub_first_last_names
|
def some_function(x):
|
"%s %s wrote the Raven"
|
c ó8 |r |r t d« |xs || _ y )Nz+Only positional or keyword args are allowed)r' r ©rH r r s r Ú__init__zSubstitution.__init__µ s Ù FÜ Ð!NÓOÐ Oànf r c ó^ |j xr |j | j z |_ |S r\ )r% r )rH r? s r Ú__call__zSubstitution.__call__» s$ Ø||ÒB¨¯ © °t·{±{Ñ(B Ø r c ór t | j t « r | j j |i |¤ yy)z8
|
Update self.params with supplied args.
|
N)r| r ÚdictÚupdater s r r zSubstitution.update¿ s0 ô dkk¤4Ô (Ø DKK× Ñ Ð /¨Ó /ð )r N)r! ÚNonerD )r# Ú
|
__module__ro r% r r r rU r r r r s ñó8%ó ô0r r c ó. e Zd ZU dZded< dddZd dZy)
|
ÚAppenderaf
|
A function decorator that will append an addendum to the docstring
|
of the target function.
|
|
This decorator should be robust even if func.__doc__ is None
|
(for example, if -OO was passed to the interpreter).
|
|
Usage: construct a docstring.Appender with a string to be joined to
|
the original docstring. An optional 'join' parameter may be supplied
|
which will be used to join the docstring and addendum. e.g.
|
|
add_copyright = Appender("Copyright (c) 2009", join='
|
')
|
|
@add_copyright
|
def my_dog(has='fleas'):
|
"This docstring will have a copyright below"
|
pass
|
ú
|
str | NoneÚaddendumc ó^ |dkD rt ||¬« | _ || _ y || _ || _ y )Nr )Úindents)Úindentr rO )rH r rO r s r r zAppender.__init__Ý s0 Ø Q;Ü " 8°WÔ =DMð ð %DMØ r c ó |j r |j nd|_ | j r | j nd| _ |j | j g}t | j j |« « |_ |S )NrI )r% r r rO )rH r? Údocitemss r r zAppender.__call__ä sX Ø'+§|¢|t||¸ Ø)-¯ ª ¸B ØLL $§-¡-Ð0Ü diinn¨XÓ 6Ó7 Ø r N)rI r )r r rO r} r Úintr! r )r? r r! r )r# r ro r% Ú__annotations__r r rU r r r r Ç s
ñð& Óôôr r c ó | rt | t « sydj dgdg|z z « }|j | j d« « S )NrI r z )r| r} rO r( )Útextr Újointexts r r r ì sE Ù z $¬Ô,ØØwwv ¨7Ñ 2Ñ2Ó3HØ == DÓ)Ó *Ð*r )r r
|
r3 rF rv r rV r )NNé N)r* r} r r" r+ r} r, r r ztype[Warning] | Noner r r- r r! úCallable[[F], F])Nr¡ )
|
rB r} rA r r@ z/Mapping[Any, Any] | Callable[[Any], Any] | Noner r r! r¢ )rP z list[str]r! r} )r+ r r! r} )NN)r+ r rt zlist[str] | Noner* r r! r¢ )r zNone | str | Callabler! r¢ )rJ )r r r r r! r} ) Ú
|
__future__r Ú functoolsr re Útextwrapr Útypingr r r r r Úpandas._libs.propertiesr
|
Úpandas._typingr r Úpandas.util._exceptionsr Úcollections.abcr r3 rF rS rV rv r r r r Ú__all__rU r r ú<module>r¬ sK ðÝ "å Û Ý ÷ó ó å 2÷õ 5áÝ'ð Ø"&ØØðHØ
|
ðHà#ðHð ðHð ð Hð
|
ð Hð ð Hð
|
ðHð óHð\ @DØð u Øðu à ðu ð =ðu ð ð u ð
|
ó u óp#@óL9ð &*ØðJØ ðJà"ðJð ðJð ó JóZ:÷B,0ñ ,0÷^"ñ "ôJ+ò r
|
