feat: make $otherwise optional in when-then-otherwise expressions (#…

…836)

DESCRIPTION

@@ -119,5 +119,5 @@ Collate:
     'zzz.R'
 Config/rextendr/version: 0.3.1
 VignetteBuilder: knitr
-Config/polars/LibVersion: 0.37.1
+Config/polars/LibVersion: 0.37.2
 Config/polars/RustToolchainVersion: nightly-2024-02-03

NAMESPACE

@@ -1,9 +1,13 @@
 # Generated by roxygen2: do not edit by hand
 
+S3method("!",RPolarsChainedThen)
 S3method("!",RPolarsExpr)
+S3method("!",RPolarsThen)
+S3method("!=",RPolarsChainedThen)
 S3method("!=",RPolarsDataType)
 S3method("!=",RPolarsExpr)
 S3method("!=",RPolarsSeries)
+S3method("!=",RPolarsThen)
 S3method("$",RPolarsChainedThen)
 S3method("$",RPolarsChainedWhen)
 S3method("$",RPolarsDataFrame)
@@ -39,28 +43,52 @@ S3method("$",pl_polars_env)
 S3method("$",private_polars_env)
 S3method("$<-",RPolarsDataFrame)
 S3method("$<-",RPolarsRField)
+S3method("%%",RPolarsChainedThen)
 S3method("%%",RPolarsExpr)
+S3method("%%",RPolarsThen)
+S3method("%/%",RPolarsChainedThen)
 S3method("%/%",RPolarsExpr)
+S3method("%/%",RPolarsThen)
+S3method("&",RPolarsChainedThen)
 S3method("&",RPolarsExpr)
+S3method("&",RPolarsThen)
+S3method("*",RPolarsChainedThen)
 S3method("*",RPolarsExpr)
 S3method("*",RPolarsSeries)
+S3method("*",RPolarsThen)
+S3method("+",RPolarsChainedThen)
 S3method("+",RPolarsExpr)
 S3method("+",RPolarsSeries)
+S3method("+",RPolarsThen)
+S3method("-",RPolarsChainedThen)
 S3method("-",RPolarsExpr)
 S3method("-",RPolarsSeries)
+S3method("-",RPolarsThen)
+S3method("/",RPolarsChainedThen)
 S3method("/",RPolarsExpr)
 S3method("/",RPolarsSeries)
+S3method("/",RPolarsThen)
+S3method("<",RPolarsChainedThen)
 S3method("<",RPolarsExpr)
 S3method("<",RPolarsSeries)
+S3method("<",RPolarsThen)
+S3method("<=",RPolarsChainedThen)
 S3method("<=",RPolarsExpr)
 S3method("<=",RPolarsSeries)
+S3method("<=",RPolarsThen)
+S3method("==",RPolarsChainedThen)
 S3method("==",RPolarsDataType)
 S3method("==",RPolarsExpr)
 S3method("==",RPolarsSeries)
+S3method("==",RPolarsThen)
+S3method(">",RPolarsChainedThen)
 S3method(">",RPolarsExpr)
 S3method(">",RPolarsSeries)
+S3method(">",RPolarsThen)
+S3method(">=",RPolarsChainedThen)
 S3method(">=",RPolarsExpr)
 S3method(">=",RPolarsSeries)
+S3method(">=",RPolarsThen)
 S3method("[",RPolarsDataFrame)
 S3method("[",RPolarsLazyFrame)
 S3method("[",RPolarsSeries)
@@ -87,8 +115,12 @@ S3method("[[",RPolarsStringCacheHolder)
 S3method("[[",RPolarsThen)
 S3method("[[",RPolarsVecDataFrame)
 S3method("[[",RPolarsWhen)
+S3method("^",RPolarsChainedThen)
 S3method("^",RPolarsExpr)
+S3method("^",RPolarsThen)
+S3method("|",RPolarsChainedThen)
 S3method("|",RPolarsExpr)
+S3method("|",RPolarsThen)
 S3method(.DollarNames,RPolarsChainedThen)
 S3method(.DollarNames,RPolarsChainedWhen)
 S3method(.DollarNames,RPolarsDataFrame)
@@ -134,8 +166,10 @@ S3method(as_polars_lf,default)
 S3method(as_polars_series,Array)
 S3method(as_polars_series,ChunkedArray)
 S3method(as_polars_series,POSIXlt)
+S3method(as_polars_series,RPolarsChainedThen)
 S3method(as_polars_series,RPolarsExpr)
 S3method(as_polars_series,RPolarsSeries)
+S3method(as_polars_series,RPolarsThen)
 S3method(as_polars_series,data.frame)
 S3method(as_polars_series,default)
 S3method(as_polars_series,nanoarrow_array)

NEWS.md

@@ -2,6 +2,12 @@
 
 ## Polars R Package (development version)
 
+### New features
+
+-   In the when-then-otherwise expressions, the last `$otherwise()` is now optional,
+    as in Python Polars. If `$otherwise()` is not specified, rows that don't respect
+    the condition set in `$when()` will be filled with `null` (#836).
+
 ## Polars R Package 0.14.1
 
 ### Breaking changes

R/as_polars.R

@@ -344,6 +344,16 @@ as_polars_series.RPolarsExpr = function(x, name = NULL, ...) {
 }
 
 
+#' @rdname as_polars_series
+#' @export
+as_polars_series.RPolarsThen = as_polars_series.RPolarsExpr
+
+
+#' @rdname as_polars_series
+#' @export
+as_polars_series.RPolarsChainedThen = as_polars_series.RPolarsExpr
+
+
 #' @rdname as_polars_series
 #' @export
 as_polars_series.POSIXlt = function(x, name = NULL, ...) {