biUddlmZddlmZmZddlmZer ddlmZddl m Z edZ de d<ed Z de d <d ad e d <GddZy )) annotations) TYPE_CHECKINGLiteral)issue_unstable_warning) Collection) TypeAlias)upcastdowncastrFloatCastOption)nanosecond-downcastconvert-timezoneDatetimeCastOptionNzScanCastOptions | None_DEFAULT_CAST_OPTIONS_ICEBERGcfeZdZdZddddddd d dZed dZed dZy ) ScanCastOptionszOptions for scanning files.forbidraiseF integer_cast float_cast datetime_castmissing_struct_fieldsextra_struct_fields_internal_callcd|s td||_||_||_||_||_y)a Common configuration for scanning files. .. warning:: This functionality is considered **unstable**. It may be changed at any point without it being considered a breaking change. Parameters ---------- integer_cast Configuration for casting from integer types: * `upcast`: Allow lossless casting to wider integer types. * `forbid`: Raises an error if dtypes do not match. float_cast Configuration for casting from float types: * `upcast`: Allow casting to higher precision float types. * `downcast`: Allow casting to lower precision float types. * `forbid`: Raises an error if dtypes do not match. datetime_cast Configuration for casting from datetime types: * `nanosecond-downcast`: Allow nanosecond precision datetime to be downcasted to any lower precision. This has a similar effect to PyArrow's `coerce_int96_timestamp_unit`. * `convert-timezone`: Allow casting to a different timezone. * `forbid`: Raises an error if dtypes do not match. missing_struct_fields Configuration for behavior when struct fields defined in the schema are missing from the data: * `insert`: Inserts the missing fields. * `raise`: Raises an error. extra_struct_fields Configuration for behavior when extra struct fields outside of the defined schema are encountered in the data: * `ignore`: Silently ignores. * `raise`: Raises an error. z'ScanCastOptions is considered unstable.N)rrrrrr)selfrrrrrrs ^/home/cdr/jupyterlab/.venv/lib/python3.12/site-packages/polars/io/scan_options/cast_options.py__init__zScanCastOptions.__init__s8x "#L M($*%:"#6 ctdS)NT)r)rrr_defaultzScanCastOptions._default\s d33rcDttdddgddgdddatS) z Default options suitable for Iceberg / Deltalake. This in general has all casting options enabled. Note: do not modify the returned config object, it is a cached global object. r r r r insertignoreTr)rr)clss r_default_icebergz ScanCastOptions._default_iceberg`s: ) 0,;%$j146HI&.$,# - )-,rN)rzLiteral['upcast', 'forbid']rzALiteral['forbid'] | FloatCastOption | Collection[FloatCastOption]rzGLiteral['forbid'] | DatetimeCastOption | Collection[DatetimeCastOption]rzLiteral['insert', 'raise']rzLiteral['ignore', 'raise']rboolreturnNone)r)r) __name__ __module__ __qualname____doc__r staticmethodr" classmethodr'r!rrrrs% 5=)1,4r7sR")9*+%%9:: '(Q RIR8<5<a-a-r