depr(python): Deprecate LazyFrame.with_context in favor of horizontal concatenation

[stinodego]

Changes

• Deprecate LazyFrame.with_context. Users should use pl.concat(..., how="horizontal") instead.

Example

Before

>>> lf1 = pl.LazyFrame({"a": [1, 2, 3]})
>>> lf2 = pl.LazyFrame({"b": [4, 5, 6]})
>>> lf1.with_context(lf2).select(pl.col("a") + pl.col("b").first()).collect()
shape: (3, 1)
┌─────┐
│ a   │
│ --- │
│ i64 │
╞═════╡
│ 5   │
│ 6   │
│ 7   │
└─────┘

After

>>> pl.concat([lf1, lf2], how="horizontal").select(pl.col("a") + pl.col("b").first()).collect()
shape: (3, 1)
┌─────┐
│ a   │
│ --- │
│ i64 │
╞═════╡
│ 5   │
│ 6   │
│ 7   │
└─────┘

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 81.34%. Comparing base (3fe4cfe) to head (e921030).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #16860      +/-   ##
==========================================
- Coverage   81.37%   81.34%   -0.03%     
==========================================
  Files        1425     1425              
  Lines      187669   187868     +199     
  Branches     2702     2703       +1     
==========================================
+ Hits       152720   152829     +109     
- Misses      34453    34543      +90     
  Partials      496      496              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.