Repeated calls to deprecate_soft() and
deprecate_warn() are faster thanks to some internal
refactoring (#177).
Switch from expr_deparse() to
deparse(). This improves performance considerably and the
cost of making some unusual function calls mildly less appealing
(#167).
The with line is now an info bullet. The
details lines are info bullets by default, unless the
argument is named.
Indirect usages of deprecated features now mention the package that likely used the deprecated feature and recommends contacting the authors (#135).
Indirect usages of deprecate_warn() no longer warn
repeatedly, even if always = TRUE (#135).
In tests, deprecate_soft() will only warn if the
deprecated function is called directly from the package being tested,
not one of its dependencies. This ensures that you only see the warning
when it’s your responsibility to do something about it (#134).
Soft deprecations now only warn every 8 hours in non-package code (#134).
You can now generate arbitrary text in a deprecation message by
wrapping what or with in I()
(#120).
deprecate_warn() gains an always = TRUE
argument to force warnings to occur every time, not every 8 hours. This
adds an extra step in between deprecate_warn() and
deprecate_stop() (#124).
signal_stage() now supports with
(#116).
deprecate_soft() now follows the verbosity option
when called from the global environment (#113).
last_warnings() has been renamed to
last_lifecycle_warnings() and last_warning()
has been removed. This is for compatibility with the future
rlang::last_warnings() function to be released in the next
rlang version.
New vignettes:
vignette("stages") describes the lifecycle stagesvignette("manage") teaches you how to manage lifecycle
changes in functions you use.vignette("communicate") shows how to use lifecycle in
functions that you write.In deprecate_soft(), deprecate_warn(),
and deprecate_stop():
You can deprecate an argument with foo(arg) instead
of foo(arg =) (#78). This syntax is similar in spirit to
the formal arguments of function definitions.
You can deprecate R6 methods by using class$method()
(#54).
A character vector details is now converted into a
bulleted list (#55).
Messages for non-prefix functions (like “x<-()”
and “%>%()”) look a little nicer (#95).
Manually printed warnings now omit the advice footer (#68).
Experimental signal_stage() can be used to signal
that a function is experimental or superseded. These signals are not
currently hooked up to any behaviour, but we’ll add tools in a future
release (#44).
lifecycle_cnd_data() has been removed; as far as I
can tell it wasn’t used by anyone.
Lifecycle warnings are now displayed once every 8 hours.
Added experimental signal_experimental() and
signal_superseded() functions.
Added the “superseded” lifecycle stage to the documentation.
deprecate_stop() now mentions that function is
defunct (#28).
New expect_deprecated() and
expect_defunct() functions for testting lifecycle warnings
and errors. expect_deprecated() automatically sets the
lifecycle_verbosity option to "warning" to
enforce warnings at each invokation rather than once per
session.
New syntax "foo(arg = 'can\\'t be a baz')" to
describe that specific inputs for an argument are deprecated (#30, @krlmlr).
New is_present() function to test whether the caller
has supplied a deprecated() function.
Deprecated functions under the control of the developer now warn repeatedly in unit tests.
Deprecation warnings now record a backtrace. Call
lifecycle::last_lifecycle_warnings() and
lifecycle::last_warning() to print the warnings that
occurred during the last command, along with their backtraces.
The naming scheme of signaller functions has been simplified:
signal_soft_deprecated() is now
deprecate_soft().warn_deprecated() is now
deprecate_warn().stop_defunct() is now
deprecate_stop().The signaller functions now take a version and two descriptors
for the deprecated feature and its replacement (the latter is optional).
The deprecation message is built from these components. You can pass a
details argument to append additional information to the
generated deprecation message.
Helpers from rlang’s compat-lifecycle.R drop-in file
are now exported in this package.