●Change8

Migrating to Polars py-1.27.0

Version py-1.27.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 4/9/2025

2
Breaking Changes
2
Migration Steps
31
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

histPartition APIExpr.diffpl.covpl.coalescepl.corrIRBuildercat.slicebackward_fillforward_fillimplodejoin_wherelist.set_*Expr.repeat_bystr.to_integerlist.gather_everypl.repeatbitwise_{count,leading,trailing}_{ones,zeros}pl.*_rangespl.arctan2pl.business_day_countstr.extract_groupsstr.pad_{start,end}str.to_decimalbin.encodebin.decodeblock(\_in\_place)\_ondt.offset_by()dt.round().str.concatcs.exclude()

Breaking Changes

●Issue #1

The bottom interval is now closed in `hist`.

●Issue #2

The Partition API arguments have changed from unspecified names to `base_path` and `file_path`.

Migration Steps

  1. 1
    If you were using the old Partition API, update calls to use `base_path` and `file_path` arguments.
  2. 2
    Review usage of `backward_fill` and `forward_fill` if you were relying on the deprecated interface.

Release Summary

This release introduces several performance improvements, new SQL functions, and enhances compatibility with Python I/O classes. It also contains several bug fixes, notably around streaming engine stability and type handling, alongside breaking changes to the `hist` function and Partition API.

Need More Details?

View the full release notes and all changes for Polars py-1.27.0.

View Full Changelog