§
    Ò¬¸jë  ã                  óh  — d Z ddlmZ ddlZddlmZmZ ddlmZ ddl	m
Z
 ddlmZmZmZmZmZmZ ddlmZ dd	lmZmZ dd
lmZ ddlmZ ddlmZmZ ddlmZm Z  ddl!m"Z" ddl#m$Z$ ddl%m&Z& erZddl'm(Z(m)Z)m*Z* ddl+m,Z, ddl-m.Z.m/Z/ ddl0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9 ddl:m;Z; ddl<m=Z= ddl>m?Z? ddl@mAZAmBZB ddlCmDZD ddlEmFZF ddl%mGZG d3d„ZHd4d$„ZI G d%„ d&e¦  «        ZJ G d'„ d(eJ¦  «        ZK G d)„ d*¦  «        ZL G d+„ d,eK¦  «        ZM G d-„ d.eK¦  «        ZN G d/„ d0eK¦  «        ZO G d1„ d2eK¦  «        ZPdS )5zQuery execution engines.é    )ÚannotationsN)ÚABCÚabstractmethod)Úpartial)ÚPath)ÚIOÚTYPE_CHECKINGÚAnyÚClassVarÚLiteralÚoverload)Úimport_optional)Ú_AioDataFrameResultÚ_GeventDataFrameResult©Úissue_deprecation_warning)Úissue_unstable_warning)Únormalize_filepathÚqualified_type_name)Úwrap_dfÚwrap_ldf)Úissue_warning)ÚInProcessQuery)ÚSingleNodeQueryResult)ÚCallableÚIterableÚMapping)ÚDeviceMemoryResource)ÚPyCollectBatchesÚPyLazyFrame)	ÚArrowSchemaExportableÚAsyncResultÚCsvQuoteStyleÚIpcCompressionÚParquetCompressionÚParquetMetadataÚPostOptCallbackÚStorageOptionsDictÚSyncOnCloseMethod)Ú	DataFrame©ÚCompatLevel)ÚCredentialProviderFunction)ÚPartitionByÚSinkedPathsCallback)Ú	LazyFrame)ÚQueryOptFlags)ÚQueryResultÚpathú.str | Path | IO[bytes] | IO[str] | PartitionByÚreturnc                óD  — ddl m} t          | t          t          f¦  «        rt          | ¦  «        S t          | t          j        ¦  «        r| S t          | |¦  «        r| S t          t          | dd ¦  «        ¦  «        r| S dt          | ¦  «        ›d�}t          |¦  «        ‚)Nr   )r.   Úwritez!`path` argument has invalid type z), and cannot be turned into a sink target)Úpolars.io.partitionr.   Ú
isinstanceÚstrr   r   ÚioÚIOBaseÚcallableÚgetattrr   Ú	TypeError)r3   r.   Úmsgs      úg/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/polars/lazyframe/engine.pyÚ_to_sink_targetrB   /   s°   € ð 0Ð/Ð/Ð/Ð/Ð/å�$��d˜Ñ$Ô$ð Ý! $Ñ'Ô'Ð'Ý	�D�"œ)Ñ	$Ô	$ð 	ØˆÝ	�D˜+Ñ	&Ô	&ð ØˆÝ	•'˜$ ¨Ñ.Ô.Ñ	/Ô	/ð àˆàxÕ2EÀdÑ2KÔ2KÐxÐxÐxˆÝ˜‰nŒnÐó    Úretriesú
int | NoneÚstorage_optionsúStorageOptionsDict | Nonec                ó>   — | �d}t          |¦  «         |pi }| |d<   |S )Nzethe `retries` parameter was deprecated in 1.37.1; specify 'max_retries' in `storage_options` instead.Úmax_retriesr   )rD   rF   r@   s      rA   Ú_apply_retries_deprecationrJ   B   s7   € ð ÐØuˆÝ! #Ñ&Ô&Ð&Ø)Ð/¨RˆØ)0ˆ˜Ñ&ØÐrC   c                  óL  — e Zd ZdZeedjd„¦   «         ¦   «         Zedjd„¦   «         Zdjd„Ze	dddœdkd„¦   «         Z
e	ddœdld„¦   «         Z
e	ddœdmd„¦   «         Z
edddœdmd„¦   «         Z
ednd„¦   «         Zddœdod"„Zd#ddd$œdpd*„Zdqd.„Zddœdrd0„ZdsdI„ZdtdO„Zdude„Zdvdf„Zdwdi„ZdS )xÚEnginea  
    Base class for query execution engines.

    Subclass this to plug a new backend into Polars.

    .. warning::
        This functionality is considered **unstable**. It may be changed
        at any point without it being considered a breaking change.
    r5   r:   c                ó   — dS )zEngine identifier.N© ©Úselfs    rA   ÚnamezEngine.nameX   ó   € € € rC   c                ó   — | j         S )z'Engine name used to render query plans.)rQ   rO   s    rA   Úplan_enginezEngine.plan_engine]   s   € ð ŒyÐrC   c                ó0   — t          | ¦  «        j        › d�S )Nz())ÚtypeÚ__name__rO   s    rA   Ú__repr__zEngine.__repr__b   s   € Ý�t‘*”*Ô%Ð)Ð)Ð)Ð)rC   .©Ú
backgroundÚpost_opt_callbackÚlfr0   Úoptimizationsr1   rZ   úLiteral[False]r[   úPostOptCallback | Noner*   c               ó   — d S ©NrN   ©rP   r\   r]   rZ   r[   s        rA   ÚcollectzEngine.collecte   ó	   € ð �CrC   ©r[   úLiteral[True]r   c               ó   — d S ra   rN   rb   s        rA   rc   zEngine.collecto   ó	   € ð ˜rC   ÚboolúDataFrame | InProcessQueryc               ó   — d S ra   rN   rb   s        rA   rc   zEngine.collecty   ó	   € ð &) SrC   FNc               ó   — dS )a‰  
        Execute `lf`, returning a `DataFrame` or a background query handle.

        Parameters
        ----------
        lf
            The query to execute.
        optimizations
            Optimization passes to apply.
        background
            Run in the background and return an `InProcessQuery`.
        post_opt_callback
            Internal post-optimization callback.
        NrN   rb   s        rA   rc   zEngine.collectƒ   rR   rC   r2   c               ó   — dS )aÃ  
        Execute the query into a `QueryResult`.

        This method of materializing a `LazyFrame` makes no guarantees as to where
        the result is materialized. This can be on the GPU for the GPU-engine,
        on the cluster or remote storage for the distributed engine and the streaming
        engine could spill the result if it needed to.

        The `QueryResult` can always be consumed as a new `LazyFrame` by calling `.lazy`
        NrN   )rP   r\   r]   s      rA   ÚexecutezEngine.execute›   rR   rC   ©Úgeventrq   úAsyncResult[DataFrame]c               óN   — dt          | ¦  «        j        › �}t          |¦  «        ‚)zExecute `lf` asynchronously.z$`collect_async` is not supported by ©rV   rW   ÚNotImplementedError)rP   r\   r]   rq   r@   s        rA   Úcollect_asynczEngine.collect_async¨   s)   € ð KµT¸$±Z´ZÔ5HÐJÐJˆÝ! #Ñ&Ô&Ð&rC   T©Úmaintain_orderÚ
chunk_sizeÚlazyrx   ry   rE   rz   Ú_CollectBatchesc               óN   — dt          | ¦  «        j        › �}t          |¦  «        ‚)z-Execute `lf`, yielding its result in batches.z&`collect_batches` is not supported by rt   )rP   r\   r]   rx   ry   rz   r@   s          rA   Úcollect_batcheszEngine.collect_batches³   s)   € ð Mµt¸D±z´zÔ7JÐLÐLˆÝ! #Ñ&Ô&Ð&rC   ÚlfsúIterable[LazyFrame]úlist[DataFrame]c               óN   — dt          | ¦  «        j        › �}t          |¦  «        ‚)z1Execute several queries, potentially in parallel.z"`collect_all` is not supported by rt   )rP   r~   r]   r@   s       rA   Úcollect_allzEngine.collect_allÀ   s)   € ð Iµ4¸±:´:Ô3FÐHÐHˆÝ! #Ñ&Ô&Ð&rC   úAsyncResult[list[DataFrame]]c               óN   — dt          | ¦  «        j        › �}t          |¦  «        ‚)z'Execute several queries asynchronously.z(`collect_all_async` is not supported by rt   )rP   r~   r]   rq   r@   s        rA   Úcollect_all_asynczEngine.collect_all_asyncÇ   s)   € ð O½¸d¹¼Ô9LÐNÐNˆÝ! #Ñ&Ô&Ð&rC   r3   ú$str | Path | IO[bytes] | PartitionByÚcompressionr%   Úcompression_levelÚ
statisticsúbool | str | dict[str, bool]Úrow_group_sizeÚdata_page_sizerF   rG   Úcredential_providerú3CredentialProviderFunction | Literal['auto'] | NonerD   Úsync_on_closeúSyncOnCloseMethod | NoneÚmetadataúParquetMetadata | NoneÚarrow_schemaúArrowSchemaExportable | NoneÚmkdirÚsinked_paths_callbackúSinkedPathsCallback | NoneúLazyFrame | Nonec               óN   — dt          | ¦  «        j        › �}t          |¦  «        ‚)z*See :meth:`polars.LazyFrame.sink_parquet`.z#`sink_parquet` is not supported by rt   )rP   r\   r3   r‡   rˆ   r‰   r‹   rŒ   rx   rF   r�   rD   r�   r‘   r“   r•   rz   r]   r–   r@   s                       rA   Úsink_parquetzEngine.sink_parquetÒ   s)   € ð. JµD¸±J´JÔ4GÐIÐIˆÝ! #Ñ&Ô&Ð&rC   úIpcCompression | NoneÚcompat_levelúCompatLevel | NoneÚrecord_batch_sizeÚ_record_batch_statisticsc               óN   — dt          | ¦  «        j        › �}t          |¦  «        ‚)z&See :meth:`polars.LazyFrame.sink_ipc`.z`sink_ipc` is not supported by rt   )rP   r\   r3   r‡   rœ   rž   rx   rF   r�   rD   r�   r•   rz   r]   rŸ   r–   r@   s                    rA   Úsink_ipczEngine.sink_ipcì   s)   € ð( Fµ°T±
´
Ô0CÐEÐEˆÝ! #Ñ&Ô&Ð&rC   r4   Úinclude_bomú'Literal['uncompressed', 'gzip', 'zstd']Úcheck_extensionÚinclude_headerÚ	separatorÚline_terminatorÚ
quote_charÚ
batch_sizeÚintÚdatetime_formatú
str | NoneÚdate_formatÚtime_formatÚfloat_scientificúbool | NoneÚfloat_precisionÚdecimal_commaÚ
null_valueÚquote_styleúCsvQuoteStyle | Nonec               óN   — dt          | ¦  «        j        › �}t          |¦  «        ‚)z&See :meth:`polars.LazyFrame.sink_csv`.z`sink_csv` is not supported by rt   )rP   r\   r3   r¢   r‡   rˆ   r¤   r¥   r¦   r§   r¨   r©   r«   r­   r®   r¯   r±   r²   r³   r´   rx   rF   r�   rD   r�   r•   rz   r]   r@   s                                rA   Úsink_csvzEngine.sink_csv  s*   € ð@ Fµ°T±
´
Ô0CÐEÐEˆÝ! #Ñ&Ô&Ð&rC   c               óN   — dt          | ¦  «        j        › �}t          |¦  «        ‚)z)See :meth:`polars.LazyFrame.sink_ndjson`.z"`sink_ndjson` is not supported by rt   )rP   r\   r3   r‡   rˆ   r¤   rx   rF   r�   rD   r�   r•   rz   r]   r@   s                  rA   Úsink_ndjsonzEngine.sink_ndjson&  s)   € ð$ Iµ4¸±:´:Ô3FÐHÐHˆÝ! #Ñ&Ô&Ð&rC   Úfunctionú"Callable[[DataFrame], bool | None]c               óN   — dt          | ¦  «        j        › �}t          |¦  «        ‚)z*See :meth:`polars.LazyFrame.sink_batches`.z#`sink_batches` is not supported by rt   )rP   r\   rº   ry   rx   rz   r]   r@   s           rA   Úsink_batcheszEngine.sink_batches;  s)   € ð JµD¸±J´JÔ4GÐIÐIˆÝ! #Ñ&Ô&Ð&rC   ©r5   r:   ©
r\   r0   r]   r1   rZ   r^   r[   r_   r5   r*   ©
r\   r0   r]   r1   rZ   rf   r[   r_   r5   r   ©
r\   r0   r]   r1   rZ   ri   r[   r_   r5   rj   ©r\   r0   r]   r1   r5   r2   ©r\   r0   r]   r1   rq   ri   r5   rr   ©r\   r0   r]   r1   rx   ri   ry   rE   rz   ri   r5   r{   ©r~   r   r]   r1   r5   r€   ©r~   r   r]   r1   rq   ri   r5   rƒ   ©&r\   r0   r3   r†   r‡   r%   rˆ   rE   r‰   rŠ   r‹   rE   rŒ   rE   rx   ri   rF   rG   r�   rŽ   rD   rE   r�   r�   r‘   r’   r“   r”   r•   ri   rz   ri   r]   r1   r–   r—   r5   r˜   © r\   r0   r3   r†   r‡   r›   rœ   r�   rž   rE   rx   ri   rF   rG   r�   rŽ   rD   rE   r�   r�   r•   ri   rz   ri   r]   r1   rŸ   ri   r–   r—   r5   r˜   ©8r\   r0   r3   r4   r¢   ri   r‡   r£   rˆ   rE   r¤   ri   r¥   ri   r¦   r:   r§   r:   r¨   r:   r©   rª   r«   r¬   r­   r¬   r®   r¬   r¯   r°   r±   rE   r²   ri   r³   r¬   r´   rµ   rx   ri   rF   rG   r�   rŽ   rD   rE   r�   r�   r•   ri   rz   ri   r]   r1   r5   r˜   ©r\   r0   r3   r4   r‡   r£   rˆ   rE   r¤   ri   rx   ri   rF   rG   r�   rŽ   rD   rE   r�   r�   r•   ri   rz   ri   r]   r1   r5   r˜   ©r\   r0   rº   r»   ry   rE   rx   ri   rz   ri   r]   r1   r5   r˜   )rW   Ú
__module__Ú__qualname__Ú__doc__Úpropertyr   rQ   rT   rX   r   rc   ro   rv   r}   r‚   r…   rš   r¡   r·   r¹   r½   rN   rC   rA   rL   rL   M   sF  € € € € € ðð ð Øð!ð !ð !ñ „^ñ „Xð!ð ðð ð ñ „Xðð*ð *ð *ð *ð ð &)Ø47ðð ð ð ð ñ „Xðð ð 58ðð ð ð ð ñ „Xðð ð 58ð)ð )ð )ð )ð )ñ „Xð)ð ð !Ø48ðð ð ð ð ñ „^ðð. ð
ð 
ð 
ñ „^ð
ð" ð	'ð 	'ð 	'ð 	'ð 	'ð 	'ð   $Ø!%Øð'ð 'ð 'ð 'ð 'ð 'ð'ð 'ð 'ð 'ð ð	'ð 	'ð 	'ð 	'ð 	'ð 	'ð'ð 'ð 'ð 'ð4'ð 'ð 'ð 'ð.!'ð !'ð !'ð !'ðF'ð 'ð 'ð 'ð*'ð 'ð 'ð 'ð 'ð 'rC   rL   c                  óF  — e Zd ZU dZded<   dZded<   	 ddœdud
„Zdvd„Zedvd„¦   «         Z	dwd„Z
dxd„Zdyd„Zedddœdzd„¦   «         Zedd œd{d#„¦   «         Zedd œd|d%„¦   «         Zd&ddœd|d'„Zd&d(œd}d+„Zd,dd&d-œd~d3„Zdd7„Zd&d(œd€d9„Zd�d=„Zd‚dU„Zdƒd[„Zd„dp„Zd…dq„Zd†dt„ZdS )‡Ú_LocalEnginez4Base for in-process engines backed by `PyLazyFrame`.zClassVar[str]Ú_nameNr°   Ú
monitoring©rÓ   r5   ÚNonec               ó8   — |rddl m}  |¦   «          || _        d S )Nr   )Úactivate_monitoring)Úpolars._utils.monitoringr×   rÓ   )rP   rÓ   r×   s      rA   Ú__init__z_LocalEngine.__init__S  s6   € Øð 	"ØDÐDÐDÐDÐDÐDàÐÑ!Ô!Ð!Ø$ˆŒˆˆrC   r:   c                ó\   — | j         €dn	d| j         ›�}t          | ¦  «        j        › d|› d�S )NÚ zmonitoring=ú(ú))rÓ   rV   rW   )rP   Úargss     rA   rX   z_LocalEngine.__repr__Z  s=   € Ø”_Ð,ˆrˆrÐ2SÀÄÐ2SÐ2SˆÝ�t‘*”*Ô%Ð/Ð/¨Ð/Ð/Ð/Ð/rC   c                ó   — | j         S )zName of the engine.)rÒ   rO   s    rA   rQ   z_LocalEngine.name^  s   € ð ŒzÐrC   r]   r1   c                óê   — ddl m}m}m} | j        €
 |¦   «         n| j        }|r.ddlm} |                     d |¦   «          |¦   «         ¬¦  «         |                     ¦   «         }||j	        _
        |S )zDRegister the query observer when enabled and update `optimizations`.r   )Úmonitoring_enabled_globallyÚmonitoring_organizationÚmonitoring_workspaceNT)Ú	workspaceÚorganization)rØ   rá   râ   rã   rÓ   Úpolars._plrÚ_plrÚset_query_monitoringÚ__copy__Ú_pyoptflagsÚquery_monitoring)rP   r]   rá   râ   rã   ÚmonitorÚplrs          rA   Ú_with_monitoringz_LocalEngine._with_monitoringc  sÑ   € ð	
ð 	
ð 	
ð 	
ð 	
ð 	
ð 	
ð 	
ð 	
ð 	
ð ŒÐ&ð (Ð'Ñ)Ô)Ð)à”ð 	ð
 ð 	Ø%Ð%Ð%Ð%Ð%Ð%à×$Ò$ØØ.Ð.Ñ0Ô0Ø4Ð4Ñ6Ô6ð %ñ ô ð ð &×.Ò.Ñ0Ô0ˆØ5<ˆÔ!Ô2ØÐrC   r\   r0   r2   c               óN   — |                       ||¬¦  «        }t          |¦  «        S )N©r]   )rc   r   )rP   r\   r]   Údfs       rA   ro   z_LocalEngine.execute}  s%   € Ø�\Š\˜"¨Mˆ\Ñ:Ô:ˆÝ$ RÑ(Ô(Ð(rC   rZ   ri   Úeagerr_   c               ó   — d S ra   rN   )rP   rZ   rò   s      rA   Ú_post_opt_callbackz_LocalEngine._post_opt_callback�  s	   € ð ˆtrC   .rY   r^   r[   r*   c               ó   — d S ra   rN   rb   s        rA   rc   z_LocalEngine.collect‰  rd   rC   re   rf   r   c               ó   — d S ra   rN   rb   s        rA   rc   z_LocalEngine.collect“  rh   rC   rj   c               ó   — d S ra   rN   rb   s        rA   rc   z_LocalEngine.collect�  rl   rC   Fc               óh  — |                       ||j        j        ¬¦  «        }|                      |¦  «        }|j                             |j        ¦  «        }|r0t          d¦  «         t          |                     ¦   «         ¦  «        S |�|}t          | 
                    | j        |¦  «        ¦  «        S )N)rZ   rò   z'background mode is considered unstable.)rô   rê   rò   rî   Ú_ldfÚwith_optimizationsr   r   Úcollect_concurrentlyr   rc   rQ   )rP   r\   r]   rZ   r[   ÚcallbackÚldfs          rA   rc   z_LocalEngine.collect§  s°   € ð ×*Ò*Ø!¨Ô)BÔ)Hð +ñ 
ô 
ˆð ×-Ò-¨mÑ<Ô<ˆàŒg×(Ò(¨Ô)BÑCÔCˆØð 	>Ý"Ð#LÑMÔMÐMÝ! #×":Ò":Ñ"<Ô"<Ñ=Ô=Ð=àÐ(Ø(ˆHÝ�s—{’{ 4¤9¨hÑ7Ô7Ñ8Ô8Ð8rC   rp   rq   rr   c               ó  — | j         dk    rt          d¦  «         |                      |¦  «        }|j                             |j        ¦  «        }|rt          ¦   «         nt          ¦   «         }|                     | j         |j	        ¦  «         |S )NÚ	streamingz&streaming mode is considered unstable.)
rQ   r   rî   rù   rú   rê   r   r   Úcollect_with_callbackÚ	_callback)rP   r\   r]   rq   rý   Úresults         rA   rv   z_LocalEngine.collect_async½  s�   € ð Œ9˜Ò#Ð#Ý"Ð#KÑLÔLÐLà×-Ò-¨mÑ<Ô<ˆØŒg×(Ò(¨Ô)BÑCÔCˆà(.ÐIÕ"Ñ$Ô$Ð$Õ4GÑ4IÔ4Ið 	ð 	×!Ò! $¤)¨VÔ-=Ñ>Ô>Ð>ØˆrC   Trw   rx   ry   rE   rz   r{   c               óÀ   — |                       |¦  «        }|j                             |j        ¦  «        }t	          |                     | j        |||¬¦  «        ¦  «        S )N)Úenginerx   ry   rz   )rî   rù   rú   rê   r{   r}   rQ   )rP   r\   r]   rx   ry   rz   rý   s          rA   r}   z_LocalEngine.collect_batchesÏ  sg   € ð ×-Ò-¨mÑ<Ô<ˆØŒg×(Ò(¨Ô)BÑCÔCˆÝØ×ÒØ”yØ-Ø%Øð	  ñ ô ñ
ô 
ð 	
rC   r~   r   r€   c               ó¦   — dd l m} |                      |¦  «        }|                     d„ |D ¦   «         | j        |j        ¦  «        }d„ |D ¦   «         S )Nr   c                ó   — g | ]	}|j         ‘Œ
S rN   ©rù   ©Ú.0r\   s     rA   ú
<listcomp>z,_LocalEngine.collect_all.<locals>.<listcomp>ê  ó   € Ð#Ð#Ð#˜ˆRŒWÐ#Ð#Ð#rC   c                ó,   — g | ]}t          |¦  «        ‘ŒS rN   ©r   )r	  Úpydfs     rA   r
  z,_LocalEngine.collect_all.<locals>.<listcomp>ì  s   € Ð.Ð.Ð. $•˜‘”Ð.Ð.Ð.rC   )ræ   rç   rî   r‚   rQ   rê   )rP   r~   r]   rí   Úouts        rA   r‚   z_LocalEngine.collect_allã  sl   € ð 	"Ð!Ð!Ð!Ð!Ð!à×-Ò-¨mÑ<Ô<ˆØ�oŠoØ#Ð#˜sÐ#Ñ#Ô# T¤Y°Ô0Iñ
ô 
ˆð /Ð.¨#Ð.Ñ.Ô.Ð.rC   rƒ   c               óÚ   — dd l m} |                      |¦  «        }|rt          ¦   «         nt	          ¦   «         }|                     d„ |D ¦   «         | j        |j        |j        ¦  «         |S )Nr   c                ó   — g | ]	}|j         ‘Œ
S rN   r  r  s     rA   r
  z2_LocalEngine.collect_all_async.<locals>.<listcomp>ü  r  rC   )	ræ   rç   rî   r   r   Úcollect_all_with_callbackrQ   rê   Ú_callback_all)rP   r~   r]   rq   rí   r  s         rA   r…   z_LocalEngine.collect_all_asyncî  sŒ   € ð 	"Ð!Ð!Ð!Ð!Ð!à×-Ò-¨mÑ<Ô<ˆà(.ÐIÕ"Ñ$Ô$Ð$Õ4GÑ4IÔ4Ið 	ð 	×%Ò%Ø#Ð#˜sÐ#Ñ#Ô#ØŒIØÔ%ØÔ ñ		
ô 	
ð 	
ð ˆrC   Úldf_pyr    r˜   c               óZ   — t          |¦  «        }|r|S |                      ||¬¦  «         dS )z'Return a lazy sink plan, or execute it.rð   N)r   rc   )rP   r  rz   r]   r\   s        rA   Ú_finish_sinkz_LocalEngine._finish_sink  s9   € õ �fÑÔˆØð 	ØˆIØ�Š�R }ˆÑ5Ô5Ð5ØˆtrC   r3   r†   r‡   r%   rˆ   r‰   rŠ   r‹   rŒ   rF   rG   r�   rŽ   rD   r�   r�   r‘   r’   r“   r”   r•   r–   r—   c               óž  — ddl m} ddlm} ddlm} |�d}t          |¦  «         |�d}t          |¦  «         t          |t          ¦  «        r
|rddddd	œ}n't          |t          ¦  «        r|si }n|d
k    rddddd	œ}t          ||	¦  «        }	 ||
||	d¦  «        }~
t          |¦  «        }t          |t          ¦  «        r'|r"t          |                     ¦   «         ¦  «        }nd }nt          |¦  «        r ||¦  «        } |||||	||¬¦  «        }|j                             |||||||||¬¦	  «	        }|                      |||¬¦  «        S )Nr   )Úwrap_parquet_metadata_callback©Ú!_init_credential_provider_builder©Ú_SinkOptionsz/`metadata` parameter is considered experimentalz/`arrow_schema` parameter is considered unstableTF)ÚminÚmaxÚdistinct_countÚ
null_countÚfullrš   ©r•   rx   r�   rF   r�   r–   )	ÚtargetÚsink_optionsr‡   rˆ   r‰   r‹   rŒ   r‘   r“   ©rz   r]   )Úpolars._utils.parquetr  Ú,polars.io.cloud.credential_provider._builderr  r8   r  r   r9   ri   rJ   rB   ÚdictÚlistÚitemsr=   rù   rš   r  )rP   r\   r3   r‡   rˆ   r‰   r‹   rŒ   rx   rF   r�   rD   r�   r‘   r“   r•   rz   r]   r–   r  r  r  r@   Úcredential_provider_builderr#  r$  r  s                              rA   rš   z_LocalEngine.sink_parquet  s  € ð, 	IÐHÐHÐHÐHÐHð	
ð 	
ð 	
ð 	
ð 	
ð 	
ð 	5Ð4Ð4Ð4Ð4Ð4àÐØCˆCÝ" 3Ñ'Ô'Ð'àÐ#ØCˆCÝ" 3Ñ'Ô'Ð'å�j¥$Ñ'Ô'ð 	¨Jð 	àØØ"'Ø"ð	ð ˆJˆJõ ˜
¥DÑ)Ô)ð 	°*ð 	ØˆJˆJØ˜6Ò!Ð!àØØ"&Ø"ð	ð ˆJõ 5°W¸oÑNÔNˆà&GÐ&GØ  ¸ñ'
ô '
Ð#ð  å  Ñ&Ô&ˆå�h¥Ñ%Ô%ð 	@Øð  Ý §¢Ñ 0Ô 0Ñ1Ô1��ð  ��Ý�hÑÔð 	@Ø5Ð5°hÑ?Ô?ˆHà#�|ØØ)Ø'Ø+Ø ;Ø"7ð
ñ 
ô 
ˆð ”×%Ò%ØØ%Ø#Ø/Ø!Ø)Ø)ØØ%ð &ñ 

ô 

ˆð × Ò  ¨dÀ-Ð ÑPÔPÐPrC   r›   rœ   r�   rž   rŸ   c               ó˜  — ddl m} ddlm} ddlm} t          |	|¦  «        } ||||d¦  «        }~t          |¦  «        }|€d}n9t          ||¦  «        r|j	        }n!dt          |¦  «        ›�}t          |¦  «        ‚|€d} ||||
|||¬	¦  «        }|j                             ||||||¬
¦  «        }|                      |||¬¦  «        S )Nr   r+   r  r  r¡   Tz!`compat_level` has invalid type: Úuncompressedr"  )r#  r$  r‡   rœ   rž   Úrecord_batch_statisticsr%  )Úpolars.interchange.protocolr,   r'  r  r8   r  rJ   rB   r9   Ú_versionr   r?   rù   r¡   r  )rP   r\   r3   r‡   rœ   rž   rx   rF   r�   rD   r�   r•   rz   r]   rŸ   r–   r,   r  r  r+  r#  Úcompat_level_pyr@   r$  r  s                            rA   r¡   z_LocalEngine.sink_ipcj  sR  € ð& 	<Ð;Ð;Ð;Ð;Ð;ð	
ð 	
ð 	
ð 	
ð 	
ð 	
ð 	5Ð4Ð4Ð4Ð4Ð4å4°W¸oÑNÔNˆà&GÐ&GØ  ¸
ñ'
ô '
Ð#ð  å  Ñ&Ô&ˆð ÐØ"ˆOˆOÝ˜ kÑ2Ô2ð 	!Ø*Ô3ˆOˆOà[Õ6IÈ,Ñ6WÔ6WÐ[Ð[ˆCÝ˜C‘.”.Ð àÐØ(ˆKà#�|ØØ)Ø'Ø+Ø ;Ø"7ð
ñ 
ô 
ˆð ”×!Ò!ØØ%Ø#Ø(Ø/Ø$<ð "ñ 
ô 
ˆð × Ò  ¨dÀ-Ð ÑPÔPÐPrC   r4   r¢   r£   r¤   r¥   r¦   r§   r¨   r©   rª   r«   r¬   r­   r®   r¯   r±   r²   r³   r´   rµ   c               ó   — ddl m} ddlm} ddlm}  |d|d¬¦  «          |d|
d¬¦  «         |sd } ||||d	¦  «        }~t          |¦  «        } t          ||¦  «        } ||||||¬
¦  «        }!|j         	                    | |!|||||t          |¦  «        |	t          |
¦  «        |||||||||¬¦  «        }"|                      |"||¬¦  «        S )Nr   r  )Ú_check_arg_is_1byter  r¦   F)Úcan_be_emptyr¨   r·   ©r•   rx   r�   rF   r�   )r#  r$  r¢   r‡   rˆ   r¤   r¥   r¦   r§   r¨   r©   r«   r­   r®   r¯   r±   r²   r³   r´   r%  )r'  r  Úpolars.io.csv._utilsr3  r8   r  rB   rJ   rù   r·   Úordr  )#rP   r\   r3   r¢   r‡   rˆ   r¤   r¥   r¦   r§   r¨   r©   r«   r­   r®   r¯   r±   r²   r³   r´   rx   rF   r�   rD   r�   r•   rz   r]   r  r3  r  r+  r#  r$  r  s#                                      rA   r·   z_LocalEngine.sink_csv«  se  € ð>	
ð 	
ð 	
ð 	
ð 	
ð 	
ð 	=Ð<Ð<Ð<Ð<Ð<Ø4Ð4Ð4Ð4Ð4Ð4àÐ˜K¨ÀÐGÑGÔGÐGØÐ˜L¨*À5ÐIÑIÔIÐIØð 	ØˆJà&GÐ&GØ  ¸
ñ'
ô '
Ð#ð  å  Ñ&Ô&ˆå4°W¸oÑNÔNˆà#�|ØØ)Ø'Ø+Ø ;ð
ñ 
ô 
ˆð ”×!Ò!ØØ%Ø#Ø#Ø/Ø+Ø)Ý˜)‘n”nØ+Ý˜:‘”Ø!Ø+Ø#Ø#Ø-Ø+Ø'Ø!Ø#ð' "ñ 
ô 
ˆð* × Ò  ¨dÀ-Ð ÑPÔPÐPrC   c               ó  — ddl m} ddlm} t	          |	|¦  «        } ||||d¦  «        }~t          |¦  «        } ||||
||¬¦  «        }|j                             |||||¬¦  «        }|                      |||¬¦  «        S )Nr   r  r  r¹   r5  )r#  r‡   rˆ   r¤   r$  r%  )	r'  r  r8   r  rJ   rB   rù   r¹   r  )rP   r\   r3   r‡   rˆ   r¤   rx   rF   r�   rD   r�   r•   rz   r]   r  r  r+  r#  r$  r  s                       rA   r¹   z_LocalEngine.sink_ndjsoný  sà   € ð"	
ð 	
ð 	
ð 	
ð 	
ð 	
ð 	5Ð4Ð4Ð4Ð4Ð4å4°W¸oÑNÔNˆà&GÐ&GØ  ¸ñ'
ô '
Ð#ð  å  Ñ&Ô&ˆà#�|ØØ)Ø'Ø+Ø ;ð
ñ 
ô 
ˆð ”×$Ò$ØØ#Ø/Ø+Ø%ð %ñ 
ô 
ˆð × Ò  ¨dÀ-Ð ÑPÔPÐPrC   rº   r»   c               óŠ   ‡‡	— ddl mŠ	 d
ˆˆ	fd„}|j                             |||¬¦  «        }|                      |||¬	¦  «        S )Nr   r  r  r
   r5   ri   c                óF   •— t           ‰ ‰| ¦  «        ¦  «        ¦  «        S ra   )ri   )r  rº   r   s    €€rA   Ú_wrapz(_LocalEngine.sink_batches.<locals>._wrap9  s#   ø€ Ý˜˜  ¨¡¤Ñ/Ô/Ñ0Ô0Ð0rC   )rº   rx   ry   r%  )r  r
   r5   ri   )Úpolars._utils.wrapr   rù   r½   r  )
rP   r\   rº   ry   rx   rz   r]   r;  r  r   s
     `      @rA   r½   z_LocalEngine.sink_batches-  s   øø€ ð 	/Ð.Ð.Ð.Ð.Ð.ð	1ð 	1ð 	1ð 	1ð 	1ð 	1ð 	1ð ”×%Ò%ØØ)Ø!ð &ñ 
ô 
ˆð
 × Ò  ¨dÀ-Ð ÑPÔPÐPrC   )rÓ   r°   r5   rÕ   r¾   )r]   r1   r5   r1   rÂ   )rZ   ri   rò   ri   r5   r_   r¿   rÀ   rÁ   rÃ   rÄ   rÅ   rÆ   )r  r    rz   ri   r]   r1   r5   r˜   rÇ   rÈ   rÉ   rÊ   rË   )rW   rÌ   rÍ   rÎ   Ú__annotations__rÓ   rÙ   rX   rÏ   rQ   rî   ro   rô   r   rc   rv   r}   r‚   r…   r  rš   r¡   r·   r¹   r½   rN   rC   rA   rÑ   rÑ   J  s¢  € € € € € € Ø>Ð>àÐÐÑð #€JÐ"Ð"Ð"Ñ"ØOà48ð %ð %ð %ð %ð %ð %ð0ð 0ð 0ð 0ð ðð ð ñ „Xððð ð ð ð4)ð )ð )ð )ðð ð ð ð ð &)Ø47ðð ð ð ð ñ „Xðð ð 58ðð ð ð ð ñ „Xðð ð 58ð)ð )ð )ð )ð )ñ „Xð)ð !Ø48ð9ð 9ð 9ð 9ð 9ð 9ð6 ðð ð ð ð ð ð.  $Ø!%Øð
ð 
ð 
ð 
ð 
ð 
ð(	/ð 	/ð 	/ð 	/ð  ðð ð ð ð ð ð*ð ð ð ð[Qð [Qð [Qð [Qðz?Qð ?Qð ?Qð ?QðBPQð PQð PQð PQðd.Qð .Qð .Qð .Qð`Qð Qð Qð Qð Qð QrC   rÑ   c                  ó4   — e Zd ZdZdd„Zdd„Zdd	„Zddd„Zd
S )r{   z?Iterator over the batches produced by `Engine.collect_batches`.Úinnerr   r5   rÕ   c                ó   — || _         d S ra   )Ú_inner)rP   r?  s     rA   rÙ   z_CollectBatches.__init__G  s   € ØˆŒˆˆrC   c                ó   — | S ra   rN   rO   s    rA   Ú__iter__z_CollectBatches.__iter__J  s   € ØˆrC   r*   c                óD   — t          t          | j        ¦  «        ¦  «        S ra   )r   ÚnextrA  rO   s    rA   Ú__next__z_CollectBatches.__next__M  s   € Ý•t˜DœKÑ(Ô(Ñ)Ô)Ð)rC   NÚrequested_schemaúobject | NoneÚobjectc                ó6   — | j                              |¦  «        S ra   )rA  Ú__arrow_c_stream__)rP   rG  s     rA   rK  z"_CollectBatches.__arrow_c_stream__P  s   € ØŒ{×-Ò-Ð.>Ñ?Ô?Ð?rC   )r?  r   r5   rÕ   )r5   r{   )r5   r*   ra   )rG  rH  r5   rI  )rW   rÌ   rÍ   rÎ   rÙ   rC  rF  rK  rN   rC   rA   r{   r{   D  sv   € € € € € ØIÐIðð ð ð ðð ð ð ð*ð *ð *ð *ð@ð @ð @ð @ð @ð @ð @rC   r{   c                  ó   — e Zd ZdZdS )Ú_AutoEngineÚautoN)rW   rÌ   rÍ   rÒ   rN   rC   rA   rM  rM  T  s   € € € € € Ø€E€E€ErC   rM  c                  ó   — e Zd ZdZdZdS )ÚInMemoryEngineaN  
    The in-memory engine.

    Parameters
    ----------
    monitoring : bool, default None
        Whether to monitor queries run by this engine. ``None`` uses the setting from
        :meth:`Config.enable_monitoring`; ``True`` or ``False`` overrides it. Setting
        this to ``True`` requires the ``polars-cloud`` package.
    z	in-memoryN©rW   rÌ   rÍ   rÎ   rÒ   rN   rC   rA   rP  rP  X  s   € € € € € ð	ð 	ð €E€E€ErC   rP  c                  ó   — e Zd ZdZdZdS )ÚStreamingEngineaý  
    The streaming engine.

    Parameters
    ----------
    monitoring : bool, default None
        Whether to monitor queries run by this engine. ``None`` uses the setting from
        :meth:`Config.enable_monitoring`; ``True`` or ``False`` overrides it. Setting
        this to ``True`` requires the ``polars-cloud`` package.

    Examples
    --------
    Monitor a single query, regardless of the configured default:

    >>> lf.collect(engine=pl.StreamingEngine(monitoring=True))  # doctest: +SKIP
    rÿ   NrQ  rN   rC   rA   rS  rS  g  s   € € € € € ðð ð" €E€E€ErC   rS  c                  ón   ‡ — e Zd ZU dZdZded<   	 ded<   	 ded<   	 d	ed
<   	 dddddœdˆ fd„Zdd„Zˆ xZS )Ú	GPUEngineaq  
    Configuration options for the GPU execution engine.

    Use this if you want control over details of the execution.

    Parameters
    ----------
    device : int, default None
        Select the GPU used to run the query. If not provided, the
        query uses the current CUDA device.
    memory_resource : rmm.mr.DeviceMemoryResource, default None
        Provide a memory resource for GPU memory allocations.

        .. warning::
           If passing a `memory_resource`, you must ensure that it is valid
           for the selected `device`. See the `RMM documentation
           <https://github.com/rapidsai/rmm?tab=readme-ov-file#multiple-devices>`_
           for more details.

    raise_on_fail : bool, default False
        If True, do not fall back to the Polars CPU engine if the GPU
        engine cannot execute the query, but instead raise an error.

    ÚgpurE   ÚdevicezDeviceMemoryResource | NoneÚmemory_resourceri   Úraise_on_failzMapping[str, Any]ÚconfigNF)rW  rX  rY  rÓ   ú
Any | NonerÓ   Úkwargsr
   r5   rÕ   c               ó¦   •— |rd}t          |¦  «        ‚t          ¦   «                              d¬¦  «         || _        || _        ||d<   || _        d S )Nz3query monitoring is not supported by the GPU engineFrÔ   rY  )ru   ÚsuperrÙ   rW  rX  rZ  )rP   rW  rX  rY  rÓ   r\  r@   Ú	__class__s          €rA   rÙ   zGPUEngine.__init__¤  s_   ø€ ð ð 	+ØGˆCÝ% cÑ*Ô*Ð*Ý‰Œ×Ò EÐÑ*Ô*Ð*àˆŒØ.ˆÔà"/ˆˆÑØˆŒˆˆrC   rZ   rò   ú(Callable[[Any, int | None], None] | Nonec               óŽ   — |rt          dt          ¬¦  «         d S |rd S t          ddd¬¦  «        }t          |j        | ¬¦  «        S )NzHGPU engine does not support background collection, disabling GPU engine.)ÚcategoryÚcudf_polarsz*GPU engine requested, but required packagezÐPlease install using the command `pip install cudf-polars-cu12` (CUDA 12 is required for RAPIDS cuDF v25.08 and later). If your system has a CUDA 11 driver, install with `pip install cudf-polars-cu11==25.06` )Ú
err_prefixÚinstall_message)rZ  )r   ÚUserWarningr   r   Úexecute_with_cudf)rP   rZ   rò   rc  s       rA   rô   zGPUEngine._post_opt_callbackº  st   € ð ð 	ÝØZÝ$ðñ ô ð ð �4Øð 	à�4å%ØØCð9ð	

ñ 

ô 

ˆõ �{Ô4¸TÐBÑBÔBÐBrC   )rW  rE   rX  r[  rY  ri   rÓ   ri   r\  r
   r5   rÕ   )rZ   ri   rò   ri   r5   r`  )	rW   rÌ   rÍ   rÎ   rÒ   r=  rÙ   rô   Ú__classcell__)r_  s   @rA   rU  rU  |  sÄ   ø€ € € € € € ðð ð2 €EàÐÐÑØ'Ø0Ð0Ð0Ñ0Ø8ØÐÐÑðð ÐÐÑØ:ð
 "Ø&*Ø#Ø ðð ð ð ð ð ð ð ð,Cð Cð Cð Cð Cð Cð Cð CrC   rU  )r3   r4   r5   r4   )rD   rE   rF   rG   r5   rG   )QrÎ   Ú
__future__r   r;   Úabcr   r   Ú	functoolsr   Úpathlibr   Útypingr   r	   r
   r   r   r   Úpolars._dependenciesr   Úpolars._utils.async_r   r   Úpolars._utils.deprecationr   Úpolars._utils.unstabler   Úpolars._utils.variousr   r   r<  r   r   Úpolars._warningsr   Úpolars.lazyframe.in_processr   Úpolars.lazyframe.query_resultr   Úcollections.abcr   r   r   Úrmm.mrr   ræ   r   r    Úpolars._typingr!   r"   r#   r$   r%   r&   r'   r(   r)   Úpolars.dataframer*   r/  r,   Úpolars.io.cloudr-   r8   r.   r/   Úpolars.lazyframe.framer0   Úpolars.lazyframe.opt_flagsr1   r2   rB   rJ   rL   rÑ   r{   rM  rP  rS  rU  rN   rC   rA   ú<module>r}     s  ðØ Ð à "Ð "Ð "Ð "Ð "Ð "à 	€	€	€	Ø #Ð #Ð #Ð #Ð #Ð #Ð #Ð #Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø FÐ FÐ FÐ FÐ FÐ FÐ FÐ FÐ FÐ FÐ FÐ FÐ FÐ FÐ FÐ Fà 0Ð 0Ð 0Ð 0Ð 0Ð 0Ø LÐ LÐ LÐ LÐ LÐ LÐ LÐ LØ ?Ð ?Ð ?Ð ?Ð ?Ð ?Ø 9Ð 9Ð 9Ð 9Ð 9Ð 9Ø IÐ IÐ IÐ IÐ IÐ IÐ IÐ IØ 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0Ø *Ð *Ð *Ð *Ð *Ð *Ø 6Ð 6Ð 6Ð 6Ð 6Ð 6Ø ?Ð ?Ð ?Ð ?Ð ?Ð ?àð :Ø;Ð;Ð;Ð;Ð;Ð;Ð;Ð;Ð;Ð;à+Ð+Ð+Ð+Ð+Ð+à9Ð9Ð9Ð9Ð9Ð9Ð9Ð9ð
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð +Ð*Ð*Ð*Ð*Ð*Ø7Ð7Ð7Ð7Ð7Ð7Ø:Ð:Ð:Ð:Ð:Ð:ØDÐDÐDÐDÐDÐDÐDÐDØ0Ð0Ð0Ð0Ð0Ð0Ø8Ð8Ð8Ð8Ð8Ð8Ø9Ð9Ð9Ð9Ð9Ð9ðð ð ð ð&ð ð ð ðz'ð z'ð z'ð z'ð z'ˆSñ z'ô z'ð z'ðzwQð wQð wQð wQð wQ�6ñ wQô wQð wQðt@ð @ð @ð @ð @ñ @ô @ð @ð ð ð ð ð �,ñ ô ð ðð ð ð ð �\ñ ô ð ðð ð ð ð �lñ ô ð ð*VCð VCð VCð VCð VC�ñ VCô VCð VCð VCð VCrC   