Cargo Features

[dependencies]
polars-python = { version = "0.53.0", default-features = false, features = ["allocator", "c_api", "avro", "async", "catalog", "parquet", "ipc", "ipc_streaming", "is_in", "json", "scan_lines", "trigonometry", "sign", "asof_join", "iejoin", "cross_join", "pct_change", "repeat_by", "meta", "index_of", "search_sorted", "decompress", "regex", "csv", "clipboard", "extract_jsonpath", "pivot", "top_k", "propagate_nans", "sql", "performant", "timezones", "cse", "merge_sorted", "list_filter", "list_gather", "list_count", "array_count", "binary_encoding", "list_sets", "list_any_all", "array_any_all", "list_drop_nulls", "list_sample", "cutqcut", "rle", "extract_groups", "ffi_plugin", "cloud", "peaks", "hist", "find_many", "new_streaming", "string_normalize", "dtype-u16", "dtype-array", "dtype-f16", "object", "dtypes", "operations", "io", "optimizations", "polars_cloud_client", "polars_cloud_server", "nightly", "full", "pymethods", "allow_unused", "rt32", "rtcompat", "default_alloc"] }
allocator

Affects c_api::allocator

c_api

Affects polars-python::c_api

avro io?

Features below are only there to enable building a slim binary during development.

Enables avro of polars

async full

Enables async of polars-io and polars-lazy

catalog

Enables catalog of polars-lazy

Affects polars-python::catalog

parquet io? = polars-parquet

Enables parquet of polars and polars-mem-engine

Affects io::read_parquet_metadata

ipc io?

Enables ipc of polars and polars-mem-engine

polars:

support for arrows ipc file parsing

Affects io::read_ipc_schema

ipc_streaming io?

Enables ipc_streaming of polars

polars:

support for arrows streaming ipc file parsing

is_in operations?

Enables is_in of polars

json io? = serde_json

Enables json and serde of polars, serde of polars-buffer, json of polars-mem-engine, serde of polars-utils

scan_lines io?

Enables scan_lines of polars and polars-mem-engine

trigonometry operations?

Enables trigonometry of polars

Affects lazy::arctan2

sign operations?

Enables sign of polars

asof_join operations?

Enables asof_join of polars

iejoin

Enables iejoin of polars

cross_join operations?

Enables cross_join of polars

pct_change operations?

Enables pct_change of polars

repeat_by operations?

Enables repeat_by of polars

meta full

Enables meta of polars

index_of operations?

Enables index_of of polars

search_sorted operations?

Enables search_sorted of polars

decompress full

Enables decompress of polars

regex full

Enables regex of polars

csv io?

Enables csv of polars and polars-mem-engine

polars:

support for arrows csv file parsing

clipboard io? = arboard

Affects io::read_clipboard_string, io::write_clipboard_string

extract_jsonpath operations?

Enables extract_jsonpath of polars

pivot operations?

Enables pivot of polars

top_k operations?

Enables top_k of polars

propagate_nans operations?

Enables propagate_nans of polars

sql full

Enables sql of polars

Affects lazy::sql_expr, polars-python::sql

performant operations?

Enables performant of polars

polars:

slower builds

timezones operations?

Enables timezones of polars

cse optimizations?

Enables cse of polars

merge_sorted operations?

Enables merge_sorted of polars

list_filter operations?

Enables list_filter of polars

list_gather operations?

Enables list_gather of polars

list_count operations?

Enables list_count of polars

array_count operations?

Enables array_count and dtype-array of polars

binary_encoding full

Enables binary_encoding of polars

list_sets operations?

Enables list_sets of polars-lazy

list_any_all operations?

Enables list_any_all of polars

array_any_all operations?

Enables dtype-array of polars

list_drop_nulls operations?

Enables list_drop_nulls of polars

list_sample operations?

Enables list_sample of polars

cutqcut operations?

Enables cutqcut of polars

rle operations?

Enables rle of polars

extract_groups operations?

Enables extract_groups of polars

ffi_plugin full

Enables ffi_plugin of polars-lazy

Affects misc::register_plugin_function

cloud io?

Enables aws, azure, cloud, gcp and http of polars

peaks operations?

Enables peaks of polars

hist operations?

Enables hist of polars

find_many operations?

Enables find_many of polars

new_streaming full

Enables new_streaming of polars-lazy

bitwise approx_unique string_normalize operations?

Enables polars

dtype-i8 dtype-i16 dtype-u8 dtype-u16 dtypes?
dtype-i128 dtype-u128 dtype-array dtypes?
dtype-f16 dtypes?
object dtypes?

Enables object of polars

polars:

support for ObjectChunked<T> (downcastable Series of any type)

Affects polars-python::object, polars-python::on_startup, construction::series_from_objects

dtypes full = dtype-array, dtype-f16, dtype-i128, dtype-i16, dtype-i8, dtype-u128, dtype-u16, dtype-u8, object
operations full = approx_unique, array_any_all, array_count, asof_join, bitwise, cross_join, cutqcut, extract_groups, extract_jsonpath, find_many, hist, index_of, is_in, list_any_all, list_count, list_drop_nulls, list_filter, list_gather, list_sample, list_sets, merge_sorted, pct_change, peaks, performant, pivot, propagate_nans, repeat_by, rle, search_sorted, sign, string_normalize, timezones, top_k, trigonometry
io full = avro, clipboard, cloud, csv, ipc, ipc_streaming, json, parquet, scan_lines
optimizations full = cse

Enables polars

polars_cloud_client full

Enables polars_cloud_client of polars

Affects polars-python::cloud_client

polars_cloud_server

Enables polars_cloud_server of polars

Affects polars-python::cloud_server

nightly

also includes simd

Enables nightly of polars

full default = async, binary_encoding, decompress, dtypes, ffi_plugin, io, meta, new_streaming, operations, optimizations, polars_cloud_client, pymethods, regex, sql
pymethods full

Affects polars-python::functions

allow_unused
rt32

Affects c_api::RUNTIME_REPR

rt64 rtcompat

Enables bigidx of polars

Affects c_api::RUNTIME_REPR

default = full

we cannot conditionally activate simd https://github.com/rust-lang/cargo/issues/1197 so we have an indirection and compile with --no-default-features --features=full for targets without simd

default_alloc

Features from optional dependencies

In crates that don't use the dep: syntax, optional dependencies automatically become Cargo features. These features may have been created by mistake, and this functionality may be removed in the future.

polars-parquet parquet?
arboard clipboard?
serde_json json?