
    WhN                    .   d 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
mZmZ ddlmZ ddlmZ ddlmZ dd	lmZ  eed
         ed         dz            dej        dfdd            Z eed
         ed         dz            	 	 dd d            ZdS )!z pickle compat     )annotationsN)Any)CompressionOptionsFilePathReadPickleBufferStorageOptionsWriteBuffer)pickle_compat)doc)_shared_docs)
get_handlestorage_optionscompression_optionsfilepath_or_buffer)r   r   inferobjr   FilePath | WriteBuffer[bytes]compressionr   protocolintr   returnNonec                D   |dk     rt           j        }t          |d|d|          5 }|j        d         dv r5|dk    r/|j                            t          j        | |                     nt          j        | |j        |           d	d	d	           d	S # 1 swxY w Y   d	S )
az  
    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.

        .. versionchanged:: 1.0.0
           Accept 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}

        .. versionadded:: 1.2.0

        .. [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r   is_textr   method)bz2xz   )r   N)pickleHIGHEST_PROTOCOLr   r   handlewritedumpsdump)r   r   r   r   r   handless         V/var/www/html/movieo_spanner_bot/venv/lib/python3.11/site-packages/pandas/io/pickle.py	to_pickler)      s   N !||*	'
 
 
 @ 
x(M99h!mm
 N  cH!E!E!EFFFF KW^h????@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @s   A!BBBdecompression_options)r   r*   FilePath | ReadPickleBufferc                H   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xY w Y   n2# |$ r* t          j
        |j        d          cY cddd           S w xY wn7# t          $ r* t          j
        |j        d	          cY cddd           S w xY w	 ddd           dS # 1 swxY w Y   dS )
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.

        .. versionchanged:: 1.0.0
           Accept URL. URL is not limited to S3 and GCS.

    {decompression_options}

        .. versionchanged:: 1.4.0 Zstandard support.

    {storage_options}

        .. versionadded:: 1.2.0

    Returns
    -------
    unpickled : 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_pickler=   s   s(   T $[2EyQM	'
 
 
 ? 
	?	>,D999 7 7)(G<<<!;w~667 7 7 7 7 7 7? ? ? ? ? ? ? ?7 7 7 7 7 7 7 7 7 ! > > > ww~=====/? ? ? ? ? ? ? ?&>	7 " 	? 	? 	?77>I>>>>>5? ? ? ? ? ? ? ?0	?7? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?sv   DB3B:BB	BB	BC C?CCCD%D7DDDDD)r   r   r   r   r   r   r   r   r   r   r   r   )r   N)r   r+   r   r   r   r   )__doc__
__future__r   r!   typingr   r5   pandas._typingr   r   r   r   r	   pandas.compatr
   r:   pandas.util._decoratorsr   pandas.core.shared_docsr   pandas.io.commonr   r"   r)   r=        r(   <module>rH      s     " " " " " "                      . - - - - - ' ' ' ' ' ' 0 0 0 0 0 0 ' ' ' ' ' '  !23$%:;>RR   '.+&*U@ U@ U@ U@	 U@p  !23&'>?BVV   '.&*a? a? a? a?	 a? a? a?rG   