3
®ybˆ4  ã               @   sœ   d Z ddlmZmZ ddlZddlZddlmZ dd„ Z	dd„ Z
d	d
„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zddd„Zeeee f ejdœdd„ZdS )zV
Module that contains many useful utilities
for validating data or function arguments
é    )ÚIterableÚUnionN)Úis_boolc          	   C   sl   |dk rt dƒ‚t|ƒt|ƒkrht|ƒ| }t|ƒ| }|dkrDdnd}t| › d|› d|› d|› d	�ƒ‚d
S )zÀ
    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.
    r   z*'max_fname_arg_count' must be non-negativeé   ÚargumentÚ	argumentsz() takes at most ú z (z given)N)Ú
ValueErrorÚlenÚ	TypeError)ÚfnameÚargsÚmax_fname_arg_countÚcompat_argsZmax_arg_countZactual_arg_countr   © r   ú;/tmp/pip-install-4cy230dp/pandas/pandas/util/_validators.pyÚ_check_arg_length   s    r   c             C   s¤   xž|D ]–}yR|| }|| }|dk	r,|dks<|dkrB|dk	rBd}n||k}t |ƒsZtdƒ‚W n$ tk
r€   || || k}Y nX |std|› d| › d�ƒ‚qW dS )zø
    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
    NFz'match' is not a booleanzthe 'z=' parameter is not supported in the pandas implementation of z())r   r	   )r   Zarg_val_dictr   ÚkeyZv1Zv2Úmatchr   r   r   Ú_check_for_default_values!   s    
 r   c             C   s,   t | |||ƒ tt||ƒƒ}t| ||ƒ dS )a  
    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.

    Parameters
    ----------
    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 : dict
        A 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, a dict ensures that the original
        order of the keyword arguments is enforced.

    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)r   ÚdictÚzipr   )r   r   r   r   Úkwargsr   r   r   Úvalidate_argsG   s     r   c             C   s8   t |ƒt |ƒ }|r4t|ƒd }t| › d|› d�ƒ‚dS )z}
    Checks whether 'kwargs' contains any keys that are not
    in 'compat_args' and raises a TypeError if there is one.
    r   z'() got an unexpected keyword argument 'ú'N)ÚsetÚlistr   )r   r   r   ZdiffZbad_argr   r   r   Ú_check_for_invalid_keysp   s    r   c             C   s$   |j ƒ }t| ||ƒ t| ||ƒ dS )aÞ  
    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)Úcopyr   r   )r   r   r   Úkwdsr   r   r   Úvalidate_kwargs}   s    r    c             C   sl   t | |t|jƒ ƒ ||ƒ tt||ƒƒ}x(|D ] }||kr.t| › d|› d�ƒ‚q.W |j|ƒ t| ||ƒ dS )aý  
    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: dict
        A dictionary of keys that `kwargs` is allowed to
        have and their associated default values.

    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.

    z-() got multiple values for keyword argument 'r   N)r   ÚtupleÚvaluesr   r   r   Úupdater    )r   r   r   r   r   Z	args_dictr   r   r   r   Úvalidate_args_and_kwargs˜   s    &

r$   c             C   s0   t | ƒp| dks,td|› dt| ƒj› d�ƒ‚| S )z; Ensures that argument passed in arg_name is of type bool. NzFor argument "z$" expected type bool, received type Ú.)r   r	   ÚtypeÚ__name__)ÚvalueÚarg_namer   r   r   Úvalidate_bool_kwargÐ   s    r*   c                sr  i }dˆ kr0t ‡ fdd„| jD ƒƒr0d}t|ƒ‚|ˆ krr|rT|› d|› d�}t|ƒ‚| jˆ jddƒƒ}ˆ | ||< x@ˆ jƒ D ]4\}}	y| j|ƒ}
W n tk
r¦   Y q|X |	||
< q|W t|ƒdkrÂn¬t|ƒdkrî| jˆ jddƒƒ}|d ||< n€t|ƒd	k�rZdˆ k�rd
}t|ƒ‚d|› d|› d�}tj	|t
dd� |d || jdƒ< |d || jdƒ< nd|› d�}t|ƒ‚|S )aw  
    Argument handler for mixed index, columns / axis functions

    In an attempt to handle both `.method(index, columns)`, and
    `.method(arg, axis=.)`, we have to do some bad things to argument
    parsing. This translates all arguments to `{index=., columns=.}` style.

    Parameters
    ----------
    data : DataFrame
    args : tuple
        All positional arguments from the user
    kwargs : dict
        All keyword arguments from the user
    arg_name, method_name : str
        Used for better error messages

    Returns
    -------
    kwargs : dict
        A dictionary of keyword arguments. Doesn't modify ``kwargs``
        inplace, so update them with the return value here.

    Examples
    --------
    >>> df._validate_axis_style_args((str.upper,), {'columns': id},
    ...                              'mapper', 'rename')
    {'columns': <function id>, 'index': <method 'upper' of 'str' objects>}

    This emits a warning
    >>> df._validate_axis_style_args((str.upper, id), {},
    ...                              'mapper', 'rename')
    {'columns': <function id>, 'index': <method 'upper' of 'str' objects>}
    Úaxisc             3   s   | ]}|ˆ kV  qd S )Nr   )Ú.0Úx)r   r   r   ú	<genexpr>  s    z+validate_axis_style_args.<locals>.<genexpr>z;Cannot specify both 'axis' and any of 'index' or 'columns'.z# got multiple values for argument 'r   r   r   é   z:Cannot specify both 'axis' and any of 'index' or 'columns'zInterpreting call
	'.z(a, b)' as 
	'.z (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'.é   )Ú
stacklevelzCannot specify all of 'z', 'index', 'columns'.)ÚanyZ_AXIS_TO_AXIS_NUMBERr   Z_get_axis_nameÚgetÚitemsr	   r
   ÚwarningsÚwarnÚFutureWarning)Údatar   r   r)   Úmethod_nameÚoutÚmsgr+   ÚkÚvZaxr   )r   r   Úvalidate_axis_style_argsÚ   s@    % 
r>   Tc             C   sš   ddl m} | dkr&|dkr&tdƒ‚nl| dkr@|dk	r@||ƒ}nR| dk	rz|dkrz|r’t| ttfƒr’tdt| ƒj› d�ƒ‚n| dk	r’|dk	r’tdƒ‚| |fS )a$  
    Validate 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
    r   )Úclean_fill_methodNz(Must specify a fill 'value' or 'method'.z>"value" parameter must be a scalar or dict, but you passed a "ú"z)Cannot specify both 'value' and 'method'.)	Zpandas.core.missingr?   r	   Ú
isinstancer   r!   r   r&   r'   )r(   ÚmethodZvalidate_scalar_dict_valuer?   r   r   r   Úvalidate_fillna_kwargs9  s    

rC   )ÚqÚreturnc             C   sl   t j| ƒ}d}|jdkrDd|  ko*dkn  sht|j|d ƒƒ‚n$tdd„ |D ƒƒsht|j|d ƒƒ‚|S )aå  
    Validate percentiles (used by describe and quantile).

    This function checks if the given float or iterable of floats is a valid percentile
    otherwise raises a ValueError.

    Parameters
    ----------
    q: float or iterable of floats
        A single percentile or an iterable of percentiles.

    Returns
    -------
    ndarray
        An ndarray of the percentiles if valid.

    Raises
    ------
    ValueError if percentiles are not in given interval([0, 1]).
    zApercentiles should all be in the interval [0, 1]. Try {} instead.r   r   g      Y@c             s   s&   | ]}d |  kodkn  V  qdS )r   r   Nr   )r,   Úqsr   r   r   r.   }  s    z&validate_percentile.<locals>.<genexpr>)ÚnpZasarrayÚndimr	   ÚformatÚall)rD   Zq_arrr;   r   r   r   Úvalidate_percentile`  s    

rK   )T)Ú__doc__Útypingr   r   r5   ZnumpyrG   Zpandas.core.dtypes.commonr   r   r   r   r   r    r$   r*   r>   rC   ÚfloatZndarrayrK   r   r   r   r   Ú<module>   s   &)8
_
'