a
    ”˜ëj  ã                   @   sN   d Z ddlZdZg d¢Zdd„ Zedfdd„Zedfd	d
„Zedfdd„ZdS )zTee function implementations.é    Ni   )ÚteeÚtee_to_fileÚtee_to_bytearrayc                 c   s(   | j j||d�D ]}||ƒ |V  qd S )N)ÚamtÚdecode_content)ÚrawÚstream)ÚresponseÚcallbackÚ	chunksizer   Úchunk© r   úb/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/requests_toolbelt/downloadutils/tee.pyÚ_tee	   s
    ÿ
r   c                 C   s4   dt |ddƒv s$t|tjƒs$tdƒ‚t| |j||ƒS )a"  Stream the response both to the generator and a file.

    This will stream the response body while writing the bytes to
    ``fileobject``.

    Example usage:

    .. code-block:: python

        resp = requests.get(url, stream=True)
        with open('save_file', 'wb') as save_file:
            for chunk in tee(resp, save_file):
                # do stuff with chunk

    .. code-block:: python

        import io

        resp = requests.get(url, stream=True)
        fileobject = io.BytesIO()

        for chunk in tee(resp, fileobject):
            # do stuff with chunk

    :param response: Response from requests.
    :type response: requests.Response
    :param fileobject: Writable file-like object.
    :type fileobject: file, io.BytesIO
    :param int chunksize: (optional), Size of chunk to attempt to stream.
    :param bool decode_content: (optional), If True, this will decode the
        compressed content of the response.
    :raises: TypeError if the fileobject wasn't opened with the right mode
        or isn't a BytesIO object.
    ÚbÚmodeÚ zƒtee() will write bytes directly to this fileobject, it must be opened with the "b" flag if it is a file or inherit from io.BytesIO.)ÚgetattrÚ
isinstanceÚioÚBytesIOÚ	TypeErrorr   Úwrite)r	   Ú
fileobjectr   r   r   r   r   r      s
    (
ÿr   c                 c   sH   t |dƒ�*}t| |||ƒD ]
}|V  qW d  ƒ n1 s:0    Y  dS )aÔ  Stream the response both to the generator and a file.

    This will open a file named ``filename`` and stream the response body
    while writing the bytes to the opened file object.

    Example usage:

    .. code-block:: python

        resp = requests.get(url, stream=True)
        for chunk in tee_to_file(resp, 'save_file'):
            # do stuff with chunk

    :param response: Response from requests.
    :type response: requests.Response
    :param str filename: Name of file in which we write the response content.
    :param int chunksize: (optional), Size of chunk to attempt to stream.
    :param bool decode_content: (optional), If True, this will decode the
        compressed content of the response.
    ÚwbN)Úopenr   )r	   Úfilenamer   r   Úfdr   r   r   r   r   A   s    r   c                 C   s"   t |tƒstdƒ‚t| |j||ƒS )ax  Stream the response both to the generator and a bytearray.

    This will stream the response provided to the function, add them to the
    provided :class:`bytearray` and yield them to the user.

    .. note::

        This uses the :meth:`bytearray.extend` by default instead of passing
        the bytearray into the ``readinto`` method.

    Example usage:

    .. code-block:: python

        b = bytearray()
        resp = requests.get(url, stream=True)
        for chunk in tee_to_bytearray(resp, b):
            # do stuff with chunk

    :param response: Response from requests.
    :type response: requests.Response
    :param bytearray bytearr: Array to add the streamed bytes to.
    :param int chunksize: (optional), Size of chunk to attempt to stream.
    :param bool decode_content: (optional), If True, this will decode the
        compressed content of the response.
    z4tee_to_bytearray() expects bytearr to be a bytearray)r   Ú	bytearrayr   r   Úextend)r	   Zbytearrr   r   r   r   r   r   \   s    
r   )Ú__doc__r   Z_DEFAULT_CHUNKSIZEÚ__all__r   r   r   r   r   r   r   r   Ú<module>   s   ÿ
1ÿ
ÿ