R/deprecated.R

In krlmlr/tibble: Simple Data Frames

#' Deprecated functions
#'
#' @description
#' \lifecycle{deprecated}
#'
#' Use [tibble()] instead of `data_frame()`.
#'
#' @export
#' @keywords internal
#' @name deprecated
data_frame <- function(...) {
  signal_soft_deprecated("`data_frame()` is deprecated, use `tibble()`.")

  # Unquote-splice to avoid argument matching
  tibble(!!!quos(...))
}

#' @description
#' Use [quasiquotation] instead of `tibble_()`, `data_frame_()`, and `lst_()`.
#'
#' @export
#' @keywords internal
#' @rdname deprecated
tibble_ <- function(xs) {
  signal_soft_deprecated("`tibble_()` and `data_frame_()` are deprecated, use `tibble()` with quasiquotation.")

  xs <- compat_lazy_dots(xs, caller_env())
  tibble(!!!xs)
}

#' @export
#' @rdname deprecated
data_frame_ <- tibble_

#' @export
#' @rdname deprecated
lst_ <- function(xs) {
  signal_soft_deprecated("`lst_()` is deprecated, use `lst()` with quasiquotation.")

  xs <- compat_lazy_dots(xs, caller_env())
  lst(!!!xs)
}

#' @description
#' Use [as_tibble()] instead of `as_data_frame()` or `as.tibble()`, but mind the
#' new signature and semantics.
#'
#' @export
#' @rdname deprecated
as_data_frame <- function(x, ...) {
  signal_soft_deprecated("`as_data_frame()` is deprecated, use `as_tibble()` (but mind the new semantics).")

  as_tibble(x, ...)
}

#' @export
#' @rdname deprecated
as.tibble <- function(x, ...) {
  signal_soft_deprecated("`as.tibble()` is deprecated, use `as_tibble()` (but mind the new semantics).")

  as_tibble(x, ...)
}

#' @include tribble.R
#' @description
#' Use [tribble()] instead of `frame_data()`.
#' @export
#' @rdname deprecated
frame_data <- function(...) {
  signal_soft_deprecated("`frame_data()` is deprecated, use `tribble()`.")

  tribble(...)
}