
    Owg                    B   d Z ddlmZ ddlZddl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 erdd	lmZmZmZmZmZ dd
lmZmZ  eed   ed   dz        dej4                  df	 	 	 	 	 	 	 	 	 	 	 dd       Z eed   ed   dz        	 	 d	 	 	 	 	 	 	 dd       Zy)z pickle compat     )annotationsN)TYPE_CHECKINGAny)pickle_compat)doc)_shared_docs)
get_handle)CompressionOptionsFilePathReadPickleBufferStorageOptionsWriteBuffer)	DataFrameSeriesstorage_optionscompression_optionsfilepath_or_buffer)r   r   inferc                    |dk  rt         j                  }t        |d|d|      5 }t        j                  | |j                  |       ddd       y# 1 sw Y   yxY w)a9  
    Pickle (serialize) object to file.

    Parameters
    ----------
    obj : any object
        Any python object.
    filepath_or_buffer : str, path object, or file-like object
        String, path object (implementing ``os.PathLike[str]``), or file-like
        object implementing a binary ``write()`` function.
        Also accepts URL. URL has to be of S3 or GCS.
    {compression_options}

        .. versionchanged:: 1.4.0 Zstandard support.

    protocol : int
        Int which indicates which protocol should be used by the pickler,
        default HIGHEST_PROTOCOL (see [1], paragraph 12.1.2). The possible
        values for this parameter depend on the version of Python. For Python
        2.x, possible values are 0, 1, 2. For Python>=3.0, 3 is a valid value.
        For Python >= 3.4, 4 is a valid value. A negative value for the
        protocol parameter is equivalent to setting its value to
        HIGHEST_PROTOCOL.

    {storage_options}

        .. [1] https://docs.python.org/3/library/pickle.html

    See Also
    --------
    read_pickle : Load pickled pandas object (or any object) from file.
    DataFrame.to_hdf : Write DataFrame to an HDF5 file.
    DataFrame.to_sql : Write DataFrame to a SQL database.
    DataFrame.to_parquet : Write a DataFrame to the binary parquet format.

    Examples
    --------
    >>> original_df = pd.DataFrame({{"foo": range(5), "bar": range(5, 10)}})  # doctest: +SKIP
    >>> original_df  # doctest: +SKIP
       foo  bar
    0    0    5
    1    1    6
    2    2    7
    3    3    8
    4    4    9
    >>> pd.to_pickle(original_df, "./dummy.pkl")  # doctest: +SKIP

    >>> unpickled_df = pd.read_pickle("./dummy.pkl")  # doctest: +SKIP
    >>> unpickled_df  # doctest: +SKIP
       foo  bar
    0    0    5
    1    1    6
    2    2    7
    3    3    8
    4    4    9
    r   wbFcompressionis_textr   )protocolN)pickleHIGHEST_PROTOCOLr	   dumphandle)objr   r   r   r   handless         G/var/www/horilla/myenv/lib/python3.12/site-packages/pandas/io/pickle.py	to_pickler"   !   s\    F !|**	'
 < 
C(;< < <s   #AAdecompression_options)r   r#   c                <   t         t        t        t        f}t	        | d|d|      5 }	 	 t        j                  d      5  t        j                  dt               t        j                  |j                        cddd       cddd       S # 1 sw Y   nxY wn5# |$ r- t        j                  |j                  d      cY cddd       S w xY wn9# t        $ r- t        j                  |j                  d	      cY cddd       S w xY w	 ddd       y# 1 sw Y   yxY w)
a  
    Load pickled pandas object (or any object) from file.

    .. warning::

       Loading pickled data received from untrusted sources can be
       unsafe. See `here <https://docs.python.org/3/library/pickle.html>`__.

    Parameters
    ----------
    filepath_or_buffer : str, path object, or file-like object
        String, path object (implementing ``os.PathLike[str]``), or file-like
        object implementing a binary ``readlines()`` function.
        Also accepts URL. URL is not limited to S3 and GCS.

    {decompression_options}

        .. versionchanged:: 1.4.0 Zstandard support.

    {storage_options}

    Returns
    -------
    same type as object stored in file

    See Also
    --------
    DataFrame.to_pickle : Pickle (serialize) DataFrame object to file.
    Series.to_pickle : Pickle (serialize) Series object to file.
    read_hdf : Read HDF5 file into a DataFrame.
    read_sql : Read SQL query or database table into a DataFrame.
    read_parquet : Load a parquet object, returning a DataFrame.

    Notes
    -----
    read_pickle is only guaranteed to be backwards compatible to pandas 0.20.3
    provided the object was serialized with to_pickle.

    Examples
    --------
    >>> original_df = pd.DataFrame(
    ...     {{"foo": range(5), "bar": range(5, 10)}}
    ...    )  # doctest: +SKIP
    >>> original_df  # doctest: +SKIP
       foo  bar
    0    0    5
    1    1    6
    2    2    7
    3    3    8
    4    4    9
    >>> pd.to_pickle(original_df, "./dummy.pkl")  # doctest: +SKIP

    >>> unpickled_df = pd.read_pickle("./dummy.pkl")  # doctest: +SKIP
    >>> unpickled_df  # doctest: +SKIP
       foo  bar
    0    0    5
    1    1    6
    2    2    7
    3    3    8
    4    4    9
    rbFr   T)recordignoreN)encodingzlatin-1)AttributeErrorImportErrorModuleNotFoundError	TypeErrorr	   warningscatch_warningssimplefilterWarningr   loadr   pcUnicodeDecodeError)r   r   r   excs_to_catchr    s        r!   read_pickler5   r   s   L $[2EyQM	'
 ? 

	?	>,,D9 7))(G<!;;w~~67 7? ?7 7 7 ! > www~~==-? ?$>	7 " 	?777>>I>>3? ?.	?7? ? ?sd   DB 9B9	BB	BC&C?C
CCD*D9DDDD)r   r   r   zFilePath | WriteBuffer[bytes]r   r
   r   intr   StorageOptions | NonereturnNone)r   N)r   zFilePath | ReadPickleBufferr   r
   r   r7   r8   zDataFrame | Series)__doc__
__future__r   r   typingr   r   r-   pandas.compatr   r2   pandas.util._decoratorsr   pandas.core.shared_docsr   pandas.io.commonr	   pandas._typingr
   r   r   r   r   pandasr   r   r   r"   r5        r!   <module>rE      s    "   - ' 0 '   !23$%:;>RR '.++-1J<	J<5J< $J< 	J<
 +J< 
J<	J<Z  !23&'>?BVV '.-1\?3\?#\? +\? 	\?	\?rD   