ó šxŠ\c@szdZddlZddlmZd„Zd„Zd„Zd„Zd„Zd „Z d „Z d „Z e d „Z dS( sV Module that contains many useful utilities for validating data or function arguments iÿÿÿÿN(tis_boolc Csœ|dkrtdƒ‚nt|ƒt|ƒkr˜t|ƒ|}t|ƒ|}|dkrednd}tdjd|d|d|d |ƒƒ‚nd S( sÁ Checks whether 'args' has length of at most 'compat_args'. Raises a TypeError if that is not the case, similar to in Python when a function is called with too many arguments. is*'max_fname_arg_count' must be non-negativeitargumentt argumentss@{fname}() takes at most {max_arg} {argument} ({given_arg} given)tfnametmax_argt given_argN(t ValueErrortlent TypeErrortformat(Rtargstmax_fname_arg_countt compat_argst max_arg_counttactual_arg_countR((s6lib/python2.7/site-packages/pandas/util/_validators.pyt_check_arg_length s   cCsÜxÕ|D]Í}yx||}||}|dk r<|dksT|dkr]|dk r]t}n ||k}t|ƒs„tdƒ‚nWn%tk r¬||||k}nX|stdjd|d|ƒƒ‚qqWdS(sù Check that the keys in `arg_val_dict` are mapped to their default values as specified in `compat_args`. Note that this function is to be called only when it has been checked that arg_val_dict.keys() is a subset of compat_args s'match' is not a booleansPthe '{arg}' parameter is not supported in the pandas implementation of {fname}()RtargN(tNonetFalseRRR (Rt arg_val_dictR tkeytv1tv2tmatch((s6lib/python2.7/site-packages/pandas/util/_validators.pyt_check_for_default_values s        cCs<t||||ƒtt||ƒƒ}t|||ƒdS(sG Checks whether the length of the `*args` argument passed into a function has at most `len(compat_args)` arguments and whether or not all of these elements in `args` are set to their default values. fname: str The name of the function being passed the `*args` parameter args: tuple The `*args` parameter passed into a function max_fname_arg_count: int The maximum number of arguments that the function `fname` can accept, excluding those in `args`. Used for displaying appropriate error messages. Must be non-negative. compat_args: OrderedDict A ordered dictionary of keys and their associated default values. In order to accommodate buggy behaviour in some versions of `numpy`, where a signature displayed keyword arguments but then passed those arguments **positionally** internally when calling downstream implementations, an ordered dictionary ensures that the original order of the keyword arguments is enforced. Note that if there is only one key, a generic dict can be passed in as well. Raises ------ TypeError if `args` contains more values than there are `compat_args` ValueError if `args` contains values that do not correspond to those of the default values specified in `compat_args` N(RtdicttzipR(RR R R tkwargs((s6lib/python2.7/site-packages/pandas/util/_validators.pyt validate_argsHs!cCsQt|ƒt|ƒ}|rMt|ƒd}tdjd|d|ƒƒ‚ndS(s~ Checks whether 'kwargs' contains any keys that are not in 'compat_args' and raises a TypeError if there is one. is4{fname}() got an unexpected keyword argument '{arg}'RRN(tsettlistRR (RRR tdifftbad_arg((s6lib/python2.7/site-packages/pandas/util/_validators.pyt_check_for_invalid_keysrs  cCs0|jƒ}t|||ƒt|||ƒdS(sß Checks whether parameters passed to the **kwargs argument in a function `fname` are valid parameters as specified in `*compat_args` and whether or not they are set to their default values. Parameters ---------- fname: str The name of the function being passed the `**kwargs` parameter kwargs: dict The `**kwargs` parameter passed into `fname` compat_args: dict A dictionary of keys that `kwargs` is allowed to have and their associated default values Raises ------ TypeError if `kwargs` contains keys not in `compat_args` ValueError if `kwargs` contains keys in `compat_args` that do not map to the default values specified in `compat_args` N(tcopyR!R(RRR tkwds((s6lib/python2.7/site-packages/pandas/util/_validators.pytvalidate_kwargs‚s cCs—t||t|jƒƒ||ƒtt||ƒƒ}x;|D]3}||kr?tdjd|d|ƒƒ‚q?q?W|j|ƒt|||ƒdS(se Checks whether parameters passed to the *args and **kwargs argument in a function `fname` are valid parameters as specified in `*compat_args` and whether or not they are set to their default values. Parameters ---------- fname: str The name of the function being passed the `**kwargs` parameter args: tuple The `*args` parameter passed into a function kwargs: dict The `**kwargs` parameter passed into `fname` max_fname_arg_count: int The minimum number of arguments that the function `fname` requires, excluding those in `args`. Used for displaying appropriate error messages. Must be non-negative. compat_args: OrderedDict A ordered dictionary of keys that `kwargs` is allowed to have and their associated default values. Note that if there is only one key, a generic dict can be passed in as well. Raises ------ TypeError if `args` contains more values than there are `compat_args` OR `kwargs` contains keys not in `compat_args` ValueError if `args` contains values not at the default value (`None`) `kwargs` contains keys in `compat_args` that do not map to the default value as specified in `compat_args` See Also -------- validate_args : Purely args validation. validate_kwargs : Purely kwargs validation. s:{fname}() got multiple values for keyword argument '{arg}'RRN( RttupletvaluesRRRR tupdateR$(RR RR R t args_dictR((s6lib/python2.7/site-packages/pandas/util/_validators.pytvalidate_args_and_kwargs s-     cCsFt|ƒp|dksBtdjd|dt|ƒjƒƒ‚n|S(s; Ensures that argument passed in arg_name is of type bool. s=For argument "{arg}" expected type bool, received type {typ}.RttypN(RRRR ttypet__name__(tvaluetarg_name((s6lib/python2.7/site-packages/pandas/util/_validators.pytvalidate_bool_kwargÝs  c síi}dˆkrFt‡fd†|jDƒƒrFd}t|ƒ‚n|ˆkr¥|rydj||ƒ}t|ƒ‚n|jˆjddƒƒ}ˆ|||>> df._validate_axis_style_args((str.upper,), {'columns': id}, ... 'mapper', 'rename') {'columns': , 'index': } This emits a warning >>> df._validate_axis_style_args((str.upper, id), {}, ... 'mapper', 'rename') {'columns': , 'index': } taxisc3s|]}|ˆkVqdS(N((t.0tx(R(s6lib/python2.7/site-packages/pandas/util/_validators.pys ss;Cannot specify both 'axis' and any of 'index' or 'columns'.s({} got multiple values for argument '{}'iiis:Cannot specify both 'axis' and any of 'index' or 'columns'sßInterpreting call '.{method_name}(a, b)' as '.{method_name}(index=a, columns=b)'. Use named arguments to remove any ambiguity. In the future, using positional arguments for 'index' or 'columns' will raise a 'TypeError'.t method_namet stacklevelis/Cannot specify all of '{}', 'index', 'columns'.( tanyt _AXIS_NUMBERSRR t_get_axis_nametgettitemsRRtwarningstwarnt FutureWarningt _AXIS_NAMES( tdataR RR.R3touttmsgR0tktvtax((Rs6lib/python2.7/site-packages/pandas/util/_validators.pytvalidate_axis_style_argsæsD$+    cCsæddlm}|dkr7|dkr7tdƒ‚n¥|dkr^|dk r^||ƒ}n~|dk rµ|dkrµ|rÜt|ttfƒrÜtdjt |ƒj ƒƒ‚qÜn'|dk rÜ|dk rÜtdƒ‚n||fS(sValidate the keyword arguments to 'fillna'. This checks that exactly one of 'value' and 'method' is specified. If 'method' is specified, this validates that it's a valid method. Parameters ---------- value, method : object The 'value' and 'method' keyword arguments for 'fillna'. validate_scalar_dict_value : bool, default True Whether to validate that 'value' is a scalar or dict. Specifically, validate that it is not a list or tuple. Returns ------- value, method : object iÿÿÿÿ(tclean_fill_methods(Must specify a fill 'value' or 'method'.sB"value" parameter must be a scalar or dict, but you passed a "{0}"s)Cannot specify both 'value' and 'method'.N( tpandas.core.missingRERRt isinstanceRR%RR R+R,(R-tmethodtvalidate_scalar_dict_valueRE((s6lib/python2.7/site-packages/pandas/util/_validators.pytvalidate_fillna_kwargsEs (t__doc__R:tpandas.core.dtypes.commonRRRRR!R$R)R/RDtTrueRJ(((s6lib/python2.7/site-packages/pandas/util/_validators.pyts   ( *   = _