o
    vh                     @  s  d dl mZ d dlmZ d dlZd dlmZ d dlZd dlm	Z	m
Z
mZ d dlZd dlmZ d dlmZ d dlmZ d d	lmZ d d
lmZ e
rXd dlmZ d dlmZmZmZ ed-ddZed.ddZe	d/d0d d!Zed1d#d$Z ed2d3d%d&Z!d4d)d*Z"d5d+d,Z#dS )6    )annotations)contextmanagerN)Path)IOTYPE_CHECKINGAny)using_copy_on_write)PYPY)ChainedAssignmentError)
set_option)
get_handle)	Generator)
BaseBufferCompressionOptionsFilePathpathFilePath | BaseBuffercompressionr   return Generator[IO[bytes], None, None]c                 c  s@    t | d|dd}|jV  W d   dS 1 sw   Y  dS )a&  
    Open a compressed file and return a file object.

    Parameters
    ----------
    path : str
        The path where the file is read from.

    compression : {'gzip', 'bz2', 'zip', 'xz', 'zstd', None}
        Name of the decompression to use

    Returns
    -------
    file object
    rbF)r   is_textN)r   handle)r   r   r    r   V/var/www/html/hyperkenya/venv/lib/python3.10/site-packages/pandas/_testing/contexts.pydecompress_file!   s   
"r   tzstrGenerator[None, None, None]c                 #  sL    ddl  d fdd}tjd}||  z
dV  W || dS || w )	a  
    Context manager for temporarily setting a timezone.

    Parameters
    ----------
    tz : str
        A string representing a valid timezone.

    Examples
    --------
    >>> from datetime import datetime
    >>> from dateutil.tz import tzlocal
    >>> tzlocal().tzname(datetime(2021, 1, 1))  # doctest: +SKIP
    'IST'

    >>> with set_timezone('US/Eastern'):
    ...     tzlocal().tzname(datetime(2021, 1, 1))
    ...
    'EST'
    r   Nr   Nonec                   sP   t  dr&| d u rztjd= W d S  ty   Y d S w | tjd<    d S d S )NtzsetTZ)hasattrosenvironKeyErrorr    )r   timer   r   setTZP   s   

zset_timezone.<locals>.setTZr!   )r   r   )r'   r#   r$   get)r   r(   orig_tzr   r&   r   set_timezone8   s   r+   Freturn_filelikeboolkwargsr   Generator[Any, None, None]c              	   k  s    t t }| du rd} tt |  } ||  }|  t|}|dd}|rE|dd |du r;d|d vr;d}t	|fd|i|}z|V  W t
|tsS|  | r]|  dS dS t
|tsh|  | rq|  w w )az  
    Gets a temporary path and agrees to remove on close.

    This implementation does not use tempfile.mkstemp to avoid having a file handle.
    If the code using the returned path wants to delete the file itself, windows
    requires that no program has a file handle to it.

    Parameters
    ----------
    filename : str (optional)
        suffix of the created file.
    return_filelike : bool (default False)
        if True, returns a file-like which is *always* cleaned. Necessary for
        savefig and other functions which want to append extensions.
    **kwargs
        Additional keywords are passed to open().

    N encodingmodezw+bbzutf-8)r   tempfile
gettempdirr   uuiduuid4touchpop
setdefaultopen
isinstancecloseis_fileunlink)filenamer,   r.   folderr   handle_or_strr1   r   r   r   ensure_cleanc   s4   


rC   namec              	   k  sX    ddl }h d}| |v rtd|j| fi | zdV  W ||  dS ||  w )au  
    Context manager to temporarily register a CSV dialect for parsing CSV.

    Parameters
    ----------
    name : str
        The name of the dialect.
    kwargs : mapping
        The parameters for the dialect.

    Raises
    ------
    ValueError : the name of the dialect conflicts with a builtin one.

    See Also
    --------
    csv : Python's CSV library.
    r   N>   	excel-tabunixexcelz Cannot override builtin dialect.)csv
ValueErrorregister_dialectunregister_dialect)rD   r.   rH   _BUILTIN_DIALECTSr   r   r   with_csv_dialect   s   rM   c              	   c  sh    ddl m} |d u r|j}|j}|j}td|  ||_zd V  W ||_td| d S ||_td| w )Nr   )expressionszcompute.use_numexpr)pandas.core.computationrN   _MIN_ELEMENTSUSE_NUMEXPRr   )usemin_elementsexprolduseoldminr   r   r   use_numexpr   s   
rW   Tr   c                 C  s   ddl m} | sddlm} | S tr|sddlm} | S tr+|r+||d|dS t r3t}d}nt}d}|r?|g|R }||d|g|R dS )Nr   assert_produces_warningnullcontext|)matchzYA value is trying to be set on a copy of a DataFrame or Series through chained assignmentr
   )	pandas._testingrY   
contextlibr[   r	   joinr   r
   FutureWarning)warnextra_warningsextra_matchrY   r[   warningr]   r   r   r   raises_chained_assignment_error   s0   rf   c                 K  s>   ddl m} | sddlm} | S |sd}|tfd|i|S )aq  
    Assert that a warning is raised in the CoW warning mode.

    Parameters
    ----------
    warn : bool, default True
        By default, check that a warning is raised. Can be turned off by passing False.
    match : str
        The warning message to match against, if different from the default.
    kwargs
        Passed through to assert_produces_warning
    r   rX   rZ   zSetting a value on a viewr]   )r^   rY   r_   r[   ra   )rb   r]   r.   rY   r[   r   r   r   assert_cow_warning   s   rg   )r   r   r   r   r   r   )r   r   r   r   )NF)r,   r-   r.   r   r   r/   )rD   r   r   r   )N)r   r   )Tr   r   )TN)$
__future__r   r_   r   r#   pathlibr   r4   typingr   r   r   r6   pandas._configr   pandas.compatr	   pandas.errorsr
   pandasr   pandas.io.commonr   collections.abcr   pandas._typingr   r   r   r   r+   rC   rM   rW   rf   rg   r   r   r   r   <module>   s8    */!
$