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.57.0'
# Optional Arrow interchange:
pip install 'etlantic-polars[arrow]==0.57.0'
# pip install 'etlantic==0.57.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.57.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.57.0
File Size Uploaded
etlantic_polars-0.57.0.tar.gz 23.3 kB Details

Built distribution (wheel)

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

Total release size: 50.4 kB

Release files / etlantic_polars-0.57.0.tar.gz

Download URL etlantic_polars-0.57.0.tar.gz
Size 23.3 kB
Tags Source
SHA-256 checksum
How to use checksums
1a5f3d95762f213a63093fe7139da653d094d364420cdd5b799cb41c7632150c
BLAKE2b-256 checksum
How to use checksums
b5f9fba79d612151e0c04a5e343ed90fb8964908c8f0bbbe0420b8438e00a7af
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.57.0-py3-none-any.whl

Download URL etlantic_polars-0.57.0-py3-none-any.whl
Size 27.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
be3670872459c3195aa3c5d0b418f6ed9aa241337641fb0119ffc71d6422969c
BLAKE2b-256 checksum
How to use checksums
9b4b5108c24678a096f2f6e244e25ee52ca5fdf5de1ab4c7c1cfc196b8398269
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.57.0 This release

2 release files

0.55.0

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