h%SSKJr SSKJrJr SSKJr \(a SSKJr SSK J r \Sr S\ S'\S r S\ S 'S qS \ S '"SS5rg )) annotations) TYPE_CHECKINGLiteral)issue_unstable_warning) Collection) TypeAlias)upcastdowncastrFloatCastOption)nanosecond-downcastconvert-timezoneDatetimeCastOptionNzScanCastOptions | None_DEFAULT_CAST_OPTIONS_ICEBERGc|\rSrSrSrSSSSSSSS.S Sjjr\S Sj5r\S S j5r S r g )ScanCastOptionszOptions for scanning files.forbidraiseF integer_cast float_cast datetime_castmissing_struct_fieldsextra_struct_fieldscategorical_to_string_internal_callcpU(d [S5 XlX lX0lX@lXPlX`lg)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. categorical_to_string Configuration for behavior when reading in a column whose expected type is string, but type in the file is categorical. * `allow`: Categorical is casted to string. * `forbid`: Raises an error. z'ScanCastOptions is considered unstable.N)rrrrrrr)selfrrrrrrrs ]/home/james-whalen/.local/lib/python3.13/site-packages/polars/io/scan_options/cast_options.py__init__ScanCastOptions.__init__s4H "#L M($*%:"#6 %:"c[SS9$)NT)r)rr"r_defaultScanCastOptions._defaultes d33r"c B[c[SSS/SS/SSSSS 9q[$) 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 insertignoreallowTr)rr)clss r_default_iceberg ScanCastOptions._default_icebergis= ) 0,;%$j146HI&.$,&-#- )-,r")rrrrrrN)rzLiteral['upcast', 'forbid']rzALiteral['forbid'] | FloatCastOption | Collection[FloatCastOption]rzGLiteral['forbid'] | DatetimeCastOption | Collection[DatetimeCastOption]rzLiteral['insert', 'raise']rzLiteral['ignore', 'raise']rzLiteral['allow', 'forbid']rboolreturnNone)r/r) __name__ __module__ __qualname____firstlineno____doc__r staticmethodr% classmethodr,__static_attributes__r$r"rrrs% 5=)1,4r?sR")9*+%%9:: '(Q RIR8<5<k-k-r"