Skip to main content

etlantic-polars

Polars dataframe plugin and Polars portable transform compiler for ETLantic 0.43. Install when you select Profile(dataframe_engine="polars") or need portable DTCS compilation on Polars. Keep the pin matched to core.

Note: This plugin and ETLantic core use Beta classifiers for documented single-tenant pilots. Classifiers are not an enterprise SLA.

Install

pip install 'etlantic-polars==0.55.0'
# Optional Arrow interchange:
pip install 'etlantic-polars[arrow]==0.55.0'
# pip install 'etlantic==0.55.0'

Dataframe plugin

Supports eager DataFrame execution and LazyFrame preservation until an explicit collection boundary declared in the PipelinePlan.

Entry point: etlantic.dataframe_plugins → etlantic_polars:create_plugin.

Portable transform compiler

Claims dtcs:profile/portable-relational-kernel/1 and dtcs:profile/portable-relational/1. Executes kernel actions plus join, union, aggregate, sort, distinct, deduplicate, and limit without a native @implementation("polars"). This is the recommended transformation path and remains eligible for adaptive execution; a native Polars body pins its step to Polars.

from etlantic import Profile
from etlantic_polars import create_transform_compiler

Profile(
    name="polars-portable",
    dataframe_engine="polars",
    portable_transform_policy="require",  # or prefer / native
)
compiler = create_transform_compiler()
print(compiler.info.name, sorted(compiler.info.capabilities.profiles))

Entry point: etlantic.transform_compilers → etlantic_polars:create_transform_compiler.

Runnable example: examples/portable_polars_kernel.py in the ETLantic repo.

Window V1, complex-type/value, and conversion profiles are available in the current compiler; explicit window frames and Window V2 remain capability-gated. See the compiler protocol and compatibility matrix.

Bounded Parquet snapshots

create_parquet_storage() reads a single policy-approved source through a verified handle into bounded immutable bytes. Native scans use those bytes, so replacing or renaming the source or its parent cannot replace the snapshot. No filesystem artifact or additional approved root is required. Keep scans inside open_scan() until all native work has drained; cancellation of an ordinary read waits for that work.

A bounded Compact-Thrift footer pass removes optional file key/value metadata, including ARROW:schema, before PyArrow or Polars constructs a reader. Custom Arrow extension semantics are discarded without invoking deserializers; every physical column must still pass the primitive int64/boolean gate. PyArrow 14 and later are supported without the newer arrow_extensions_enabled keyword. The snapshot uses memory proportional to the configured byte budget, including bounded copies during footer sanitization and native scan construction.

The cleanup inspection methods remain available for compatibility. Buffer snapshots create no disk cleanup obligations; unknown cleanup tokens reject.

Polars tutorial · Source · Issues

Metadata

Release files for etlantic-polars 0.55.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for etlantic-polars 0.55.0
File Size Uploaded
etlantic_polars-0.55.0.tar.gz 23.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for etlantic-polars 0.55.0
File Interpreter ABI Platform
etlantic_polars-0.55.0-py3-none-any.whl Python 3 none any Details

Total release size: 50.2 kB

Release files / etlantic_polars-0.55.0.tar.gz

Download URL etlantic_polars-0.55.0.tar.gz
Size 23.2 kB
Tags Source
SHA-256 checksum
How to use checksums
fee70dc9f7830263f0b165d23ef26a3f59599b6ffcefefeb11ef0d5086282d48
BLAKE2b-256 checksum
How to use checksums
003743fb19155733cafa159ea27f28cc6ca30ac7bd5dfd8dfe4f189cc6fea408
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / etlantic_polars-0.55.0-py3-none-any.whl

Download URL etlantic_polars-0.55.0-py3-none-any.whl
Size 27.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
93110bbdee9f2e6daaa8b26a44367b3da55fc8e862d50c21513c363a8ceb25a5
BLAKE2b-256 checksum
How to use checksums
fe250fee9d71ac8b92dcf2761ec20f5e0ba302c0da3671c2bd8af7b8041a80de
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

0.58.0

2 release files

0.57.2

2 release files

0.57.1

2 release files

This release

0.55.0 This release

2 release files

0.54.0

2 release files

0.53.0

2 release files

0.52.1

2 release files

0.52.0

2 release files

0.51.0

2 release files

0.50.1

2 release files

0.50.0

2 release files

0.48.0

2 release files

0.47.0

2 release files

0.46.0

2 release files

0.45.0

2 release files

0.40.0

2 release files

0.39.0

2 release files

0.38.0

2 release files

0.37.0

2 release files

0.36.0

2 release files

0.35.0

2 release files

0.34.0

2 release files

0.33.0

2 release files

0.32.0

2 release files

0.31.0

2 release files

0.30.0

2 release files

0.29.0

2 release files

0.27.0

2 release files

0.26.0

2 release files

0.25.0

2 release files

0.24.0

2 release files

0.23.0

2 release files

0.22.0

2 release files

0.21.0

2 release files

0.20.0

2 release files

0.19.0

2 release files

0.18.0

2 release files

0.17.0

2 release files

0.16.0

2 release files

0.14.0

2 release files

0.13.0

2 release files

0.12.0

2 release files

0.11.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page