U Cv f@sHddlZddlZddlmZejjZejjZejjZejjZ ddZ dS)N)wrapscsfdd}|S)aDecorator for methods that issues warnings for positional arguments Using the keyword-only argument syntax in pep 3102, arguments after the ``*`` will issue a warning when passed as a positional argument. Parameters ---------- version : str version of the library when the positional arguments were deprecated Examples -------- Deprecate passing `b` as positional argument: def func(a, b=1): pass @_deprecate_positional_args("v0.1.0") def func(a, *, b=2): pass func(1, 2) Notes ----- This function is adapted from scikit-learn under the terms of its license. See licences/SCIKIT_LEARN_LICENSE cst}gg|jD]H\}}|jttfkr>|q|jtkr||j t krt dqt fdd}|S)Nz.Keyword-only param without default disallowed.csj}t|t}|dkrdd|}tjd|d|ddtddtd||| d}|d d |D|d| |S||S) Nrz, z Passing 'z' as positional argument(s) to z was deprecated in version zS and will raise an error two releases later. Please pass them as keyword arguments.) stacklevelcSsi|]\}}||qSr).0nameargrrC/tmp/pip-unpacked-wheel-h316xyqg/xarray/util/deprecation_helpers.py mszQ_deprecate_positional_args.._decorator..inner..)__name__lenjoinwarningswarn FutureWarningzipupdate)argskwargsrZ n_extra_args extra_argsZzip_args)func kwonly_argspos_or_kw_argsversionrr innerZs z=_deprecate_positional_args.._decorator..inner) inspect signature parametersitemskindPOSITIONAL_OR_KEYWORDPOSITIONAL_ONLYappend KEYWORD_ONLYdefaultEMPTY TypeErrorr)rrrparamrr)rrrr _decoratorJs      z._deprecate_positional_args.._decoratorr)rr)rr(r _deprecate_positional_args,s +r*) rr functoolsr Parameterr r#r!emptyr%r*rrrr "s