The reset argment of load_all() is no
longer supported because preserving the namespace requires unlocking its
environment, which is no longer possible in recent versions of R. It
should no longer be necessary as the performance issues caused by
resetting the namespace were resolved a while ago.
New experimental feature for generating a
compile_commands.json file after each
load_all(). This file is used by LSP servers such as clangd
to provide intellisense features in your native files. To enable it, add
this directive to your DESCRIPTION file:
Config/build/compilation-database: trueYou’ll also want to add compile_commands.json and
.cache to your gitignore and Rbuildignore files.
To accomplish all these steps, feel free to use the unexported
function pkgload:::use_compilation_db(). It will eventually
be exported from the usethis package.
load_all() now includes a link to the exact location
when loading failed (@olivroy, #282).
User onload hooks are now passed a library path.
Fixed an error when updating packages on load (@olivroy, #261).
Fixed a bug in shim_help() where a complex
package = argument evaluating to NULL would
cause an error (#266).
On load, pkgload now sets PKGLOAD_PARENT_TEMPDIR to
the temporary directory used in the current process. This provides a
convenient place to cache results for functions used in subprocesses
(e.g. devtools::test(),
devtools::document()).
Fixes for Debian packaging.
dev_topic_index() is now exported (#257).
Fix handling of active bindings inside a package during unloading (#255, @klmr).
The helpers argument of load_all now
defaults to the value provided for the export_all
arguments. This makes the behaviour safer by default (#244).
pkgload now depends unconditionally on pkgbuild (#249).
load_all() no longer standardises version number in
namespace metadata (#231).
New pkg_version_raw() to get raw package version as
a string.
dev_topic_find() is now exported (#215).
dev_help() will remind you to run
pkgload::load_all() if no in-development packages are found
(#221).
Shimmed ? now works even if you’ve renamed the
documentation topic (#220).
dev_help() now works with an RStudio daily to
deliver a rendered development documentation that includes working
images and links (#228).
load_all() now calls
rlang::check_installed() to prompt whether to install
missing packages.
Outdated and missing dependencies are installed using pak if
installed. If not, the remotes package is used if installed. Otherwise
install.packages() is used as a last resort but this method
does not support Remotes fields.
load_all() gains an attach argument set
to TRUE by default (#209). If set to FALSE,
load_all() creates a new namespace but doesn’t create a
package environment on the search path. In this case, it is more similar
to loadNamespace() than to library().
Improved the way help pages are displayed in RStudio. This makes the behaviour within and outside RStudio consistent and fixes issues with Rd macros (#120).
unregister() is now exported. This is a gentler
version of unload() which removes the package from the
search path, unregisters methods, and unregisters the namespace. However
it doesn’t try to unload the namespace or its DLL so that dangling
references keep working.
User onLoad hooks are now run after exports have
been populated. This allows the hook to use exported functions.
The loaded namespace is now locked just before user
onLoad hooks are run. This better reproduced the namespace
sealing behaviour of regular loading.
The package environment environment is now locked as well before both
the user and package onAttach hooks are run.
Added support for loading a .so or .dll file from the
inst folder via a new library.dynam() shim
(@ethanplunkett, #48).
The system.file() shim now fails if you supply a
path that starts with inst to better reproduce the
behaviour with installed packages (#104).
load_all() now imports its dependencies lazily to
avoid parallel installation issues (#89).
Unknown Rd macros no longer trigger a warning when building the package topic index (#119).
load_all(compile = TRUE) now forces a full
recompilation (#93).
The advice about running rm() to remove conflicts
with objects in the global environment is now clickable in RStudio
(#199).
New is_loading() predicate to detect whether
load_all() is currently running (#134).
.dynLibs() is no longer emptied when package with no
DLL is unloaded (#176).
The ? shim no longer interprets ?"/" as
a path (#198).
rstudioapi is no longer a hard dependency of pkgload (#187).
Errors thrown in user hooks are now demoted to a warning
condition. Previously they were demoted using try(), making
it harder to debug them.
load_all() correctly re-loads modified translations,
avoiding the usual gettext behaviour.
Lionel Henry is now the maintainer.
load_all() automatically registers package
translations, if found.
pkgload now forces all bindings on unload. This fixes errors and inconsistencies when dangling references force lazy bindings after unload or reload.
load_all() now restores S3 methods registered by
third party packages (#163).
load_dll() will now preserve the DLL name when
loading instead of always using the package name. This allows packages
to include DLL’s with different names (#162, @dfalbel).
unload() no longer unregisters methods for generics
of the package being unloaded. This way dangling references to generics
defined in the stale namespace still work as expected
(r-lib/vctrs#1341).
load_all() will now work for packages that have
testthat tests but do not have testthat installed (#151)
The pkgbuild dependency has been moved to
Suggests, as it is only needed for packages with compiled
code.
load_all() will now work for packages that have
testthat tests but do not have testthat installed (#151)
load_all(warn_conflicts = TRUE) becomes more narrow
and only warns when a function in the global environment masks
a function in the package, consistent with the docs (#125, #143
@jennybc).
load_all() no longer does a comprehensive check on
the DESCRIPTION file when loading, instead just checking
that it exists and starts with Package (#149, @malcolmbarrett)
unload() no longer warns when it can’t unload a
namespace.
Fix test failure in R 4.1 with regards to S4 method registration
load_all() now preserves existing namespaces in
working order. In particular, it doesn’t unload the package’s shared
library and keeps it loaded instead. When reloading, a copy of the SO
for the new namespace is loaded from a temporary location. These
temporary SOs are only unloaded on GC and deleted from their temporary
location via a weak reference attached to the namespace.
This mechanism ensures that lingering references to the namespace keep working as expected. Consequently the namespace propagation routine that was added to pkgload as a workaround has been removed.
Note that .Call() invocations that pass a string symbol
rather than a structured symbol may keep crashing, because R will look
into the most recently loaded SO of a given name. Since symbol
registration is now the norm, we don’t expect this to cause much
trouble.
load_all() no longer forces all bindings of a
namespace to avoid lazy-load errors. Instead, it removes exported S3
methods from the relevant tables.
This improves the loading behaviour with packages that define
objects in their namespaces lazily (e.g. with
delayedAssign()).
This also makes load_all() more predictable after a
method has been removed from the package. It is now actually removed
from the generic table. It would previously linger until R was
restarted.
If load_all() attaches testthat, it automatically
suppresses conflicts.
dev_example() now works after removing an
inconsistent call to load_all() (@riccardoporreca, #122).
load_all() now issues a warning if exported objects
conflict with objects defined in the global environment (#112)
run_example() arguments run and
test are deprecated in favor of the (hopefully) more clear
run_dontrun and run_donttest (#107).
Internal fixes for compatibility with the future 4.1.0 release.
shim_question() now works for topics from the R base
package that are passed with the double colon operator
(e.g. base::min) (@mdequeljoe, #99).
load_all() now allows using explicitly qualified,
exported names in test helpers (@klmr, #95).
load_all() gains a compile argument
which controls more finely whether to compile the code or not. The
recompile argument is now deprecated and will be removed in
a future version of pkgload.
unload() now only removes S4 classes which were
generated in the package being unloaded (#75)
help() will no longer error when trying to load
package level help (#67).
Trailing slashes now removed from all paths, which fixes issues on Windows (#73).
load_dll() now fixed in R-devel (#77).
The help shim’s now work for ::: inputs
(#72).
load_all() now updates imports of dependent packages
when a package is reloaded (#59).
load_all() now assigns
DESCRIPTION/Depends to .Depends object of
package environment. (@yiufung pkgload#61)
load_all() now attaches testthat if the
attach_testthat option is TRUE. This allows
load_all() to more closely mimic the testing environment.
(#56)
check_dep_version() and
check_suggested() are now exported.
check_dep_version() now emits a warning and returns
FALSE rather than aborting. (#47)
Package imports are now exported when using
load_all(). This behavior can be disabled by using
load_all(export_imports = FALSE).
The as.package() and is.package()
functions have been removed.
load_code(), load_data(),
load_dll(), load_all(),
parse_ns_file() all now take an explicit path rather than a
path or a package object.
imports_env(), ns_env(),
pkg_env() and unload() now take a package name
rather than a path or a package object.
run_example() now works on R 3.1.
unload() now unloads S4 classes for packages loaded
with library() as well as load_all()
(#46).
load_all() gains a helpers option to
specify whether or not to source testthat helpers. (@pitakakariki devtools
#1202)
load_all() now sources the testthat helpers in the
namespace environment rather than the package environment
(#40).
load_all() now sets the NOT_CRAN
environment variable when it sources testthat helpers. It also sets
DEVTOOLS_LOAD to “true” so that you can check whether they
are run during package loading.
dev_topic_path() now only returns the last path
found, fixing an error when a package has both a package function level
help with the same name. (#21)
New function is_dev_package() to determine if a
given package has been loaded by pkgload::load_all()
(#2).
load_all() no longer updates the collate directive.
Instead this functionality has been moved to
devtools::document().
dev_help() now optionally takes a character vector
of packages to search within. This replaces
find_topic().
dev_topic_index_reset() is now exported, and allows
you to reset the topic index associated with a given package.
Added a NEWS.md file to track changes to the
package.
Initial release from code spun off from devtools