docs: use lifecycle for deprecated functions

DESCRIPTION

@@ -23,6 +23,7 @@ Depends: R (>= 4.1.0)
 Imports: 
     dplyr,
     glue,
+    lifecycle,
     polars (>= 0.18.0),
     rlang,
     tidyr,

NAMESPACE

@@ -117,5 +117,6 @@ import(dplyr)
 import(polars)
 import(rlang)
 import(tidyr)
+importFrom(lifecycle,deprecated)
 importFrom(polars,as_polars_df)
 importFrom(polars,as_polars_lf)

R/describe.R

@@ -3,6 +3,8 @@
 #' @param .data A Polars DataFrame.
 #'
 #' @description
+#' `r lifecycle::badge("deprecated")`
+#'
 #' This function is deprecated as of tidypolars 0.10.0, it will be removed in
 #' a future update. Use `summary()` with the same arguments instead.
 #'
@@ -12,7 +14,11 @@ describe <- function(.data, percentiles = c(0.25, 0.75)) {
   if (!inherits(.data, "RPolarsDataFrame")) {
     rlang::abort("`describe()` can only be used on a DataFrame.")
   }
-  rlang::warn("`describe()` is deprecated as of tidypolars 0.10.0 and will be removed in a future update.\nUse `summary()` with the same arguments instead.")
+  lifecycle::deprecate_warn(
+    when = "0.10.0",
+    what = "describe()",
+    details = "Please use `summary()` with the same arguments instead."
+  )
   summary(object = .data, percentiles = percentiles)
 }
 

R/plan.R

@@ -1,6 +1,8 @@
 #' @inherit explain.RPolarsLazyFrame title
 #'
 #' @description
+#' `r lifecycle::badge("deprecated")`
+#'
 #' Those functions are deprecated as of tidypolars 0.10.0, they will be removed
 #' in a future update. Use `explain()` with `optimized = FALSE` to recover the
 #' output of `describe_plan()`, and with `optimized = TRUE` (the default) to
@@ -14,7 +16,11 @@ describe_plan <- function(.data) {
   if (!inherits(.data, "RPolarsLazyFrame")) {
     rlang::abort("`describe_plan()` only works on a LazyFrame.")
   }
-  rlang::warn("`describe_plan()` is deprecated as of tidypolars 0.10.0 and will be removed in a future update.\nUse `explain()` with `optimized = FALSE` instead.")
+  lifecycle::deprecate_warn(
+    when = "0.10.0",
+    what = "describe_plan()",
+    details = "Please use `explain(optimized = FALSE)` instead."
+  )
   .data$describe_plan()
 }
 
@@ -25,7 +31,11 @@ describe_optimized_plan <- function(.data) {
   if (!inherits(.data, "RPolarsLazyFrame")) {
     rlang::abort("`describe_optimized_plan()` only works on a LazyFrame.")
   }
-  rlang::warn("`describe_optimized_plan()` is deprecated as of tidypolars 0.10.0 and will be removed in a future update.\nUse `explain()` with `optimized = TRUE` instead.")
+  lifecycle::deprecate_warn(
+    when = "0.10.0",
+    what = "describe_optimized_plan()",
+    details = "Please use `explain()` instead."
+  )
   .data$describe_optimized_plan()
 }
 # nocov end

R/tidypolars-package.R

@@ -0,0 +1,7 @@
+#' @keywords internal
+"_PACKAGE"
+
+## usethis namespace: start
+#' @importFrom lifecycle deprecated
+## usethis namespace: end
+NULL