ง
    q-Phิ	  ใ                  ๓    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	 d dl
mZ  eฆ   ซ         ddd	ddฆ   ซ         ZdS )้    )ฺannotations)ฺTYPE_CHECKING)ฺunstableฉฺ_scan_pyarrow_dataset)ฺ	LazyFrame)ฺpyarrowTNฉฺallow_pyarrow_filterฺ
batch_sizeฺsource๚pa.dataset.Datasetr   ฺboolr   ๚
int | Noneฺreturnr   c               ๓&    t          | ||ฌฆ  ซ        S )us  
    Scan a pyarrow dataset.

    .. warning::
        This functionality is considered **unstable**. It may be changed
        at any point without it being considered a breaking change.

    This can be useful to connect to cloud or partitioned datasets.

    Parameters
    ----------
    source
        Pyarrow dataset to scan.
    allow_pyarrow_filter
        Allow predicates to be pushed down to pyarrow. This can lead to different
        results if comparisons are done with null values as pyarrow handles this
        different than polars does.
    batch_size
        The maximum row count for scanned pyarrow record batches.

    Warnings
    --------
    This method can only can push down predicates that are allowed by PyArrow
    (e.g. not the full Polars API).

    If :func:`scan_parquet` works for your source, you should use that instead.

    Notes
    -----
    When using partitioning, the appropriate `partitioning` option must be set on
    `pyarrow.dataset.dataset` before passing to Polars or the partitioned-on column(s)
    may not get passed to Polars.

    Examples
    --------
    >>> import pyarrow.dataset as ds
    >>> dset = ds.dataset("s3://my-partitioned-folder/", format="ipc")  # doctest: +SKIP
    >>> (
    ...     pl.scan_pyarrow_dataset(dset)
    ...     .filter("bools")
    ...     .select("bools", "floats", "date")
    ...     .collect()
    ... )  # doctest: +SKIP
    shape: (1, 3)
    โโโโโโโโโฌโโโโโโโโโฌโโโโโโโโโโโโโ
    โ bools โ floats โ date       โ
    โ ---   โ ---    โ ---        โ
    โ bool  โ f64    โ date       โ
    โโโโโโโโโชโโโโโโโโโชโโโโโโโโโโโโโก
    โ true  โ 2.0    โ 1970-05-04 โ
    โโโโโโโโโดโโโโโโโโโดโโโโโโโโโโโโโ
    r
   r   )r   r   r   s      ๚c/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/polars/io/pyarrow_dataset/functions.pyฺscan_pyarrow_datasetr      s%    ๕v !ุุ1ุ๐๑ ๔ ๐ ๓    )r   r   r   r   r   r   r   r   )ฺ
__future__r   ฺtypingr   ฺpolars._utils.unstabler   ฺ(polars.io.pyarrow_dataset.anonymous_scanr   ฺpolarsr   ฺpolars.dependenciesr	   ฺpar   ฉ r   r   ๚<module>r      sป   ๐ุ "ะ "ะ "ะ "ะ "ะ "เ  ะ  ะ  ะ  ะ  ะ  เ +ะ +ะ +ะ +ะ +ะ +ุ Jะ Jะ Jะ Jะ Jะ Jเ๐ 2ุ ะ ะ ะ ะ ะ ุ1ะ1ะ1ะ1ะ1ะ1๐ 
๐ "&ุ!๐	>๐ >๐ >๐ >๐ >๑ ๐>๐ >๐ >r   