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.2'
# Optional Arrow interchange:
pip install 'etlantic-polars[arrow]==0.57.2'
# pip install 'etlantic==0.57.2'

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.2

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.2
File Size Uploaded
etlantic_polars-0.57.2.tar.gz 23.3 kB Details

Built distribution (wheel)

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

Total release size: 50.4 kB

Release files / etlantic_polars-0.57.2.tar.gz

Download URL etlantic_polars-0.57.2.tar.gz
Size 23.3 kB
Tags Source
SHA-256 checksum
How to use checksums
740d24e7674a03fdd661e3fec7b3c93a9a7907fd1b62fdba5cab605de3167f55
BLAKE2b-256 checksum
How to use checksums
f5d73b70cb2a3f1f48ccc111b1df283909de13dc125888fd7c2c75d0fa0c6f6d
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.2-py3-none-any.whl

Download URL etlantic_polars-0.57.2-py3-none-any.whl
Size 27.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
41323802f47a37c6a7249d218a76e5349509b4887cc572b8557ee14a487da8e4
BLAKE2b-256 checksum
How to use checksums
5e41d36f38f58ccebb6e5491f305f980bd3830896194302ee63709372ee21dd4
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

This release

0.57.2 This release

2 release files

0.57.1

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