From b48d1703a24b15285ad0bd464bf848258aaecd5d Mon Sep 17 00:00:00 2001 From: krlmlr Date: Mon, 20 Jan 2025 11:40:48 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20r-lib/pk?= =?UTF-8?q?gload@9c9bb8baae6546f13e5068a420c5c847843b7e3e=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- dev/authors.html | 4 ++-- dev/pkgdown.yml | 2 +- dev/search.json | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/dev/authors.html b/dev/authors.html index 7cd3899..9a4b4a0 100644 --- a/dev/authors.html +++ b/dev/authors.html @@ -64,14 +64,14 @@

Authors

Citation

Source: DESCRIPTION

-

Wickham H, Chang W, Hester J, Henry L (2024). +

Wickham H, Chang W, Hester J, Henry L (2025). pkgload: Simulate Package Installation and Attach. R package version 1.4.0.9000, https://pkgload.r-lib.org, https://github.com/r-lib/pkgload. 

@Manual{,
   title = {pkgload: Simulate Package Installation and Attach},
   author = {Hadley Wickham and Winston Chang and Jim Hester and Lionel Henry},
-  year = {2024},
+  year = {2025},
   note = {R package version 1.4.0.9000, https://pkgload.r-lib.org},
   url = {https://github.com/r-lib/pkgload},
 }
diff --git a/dev/pkgdown.yml b/dev/pkgdown.yml index 8da6feb..49db64e 100644 --- a/dev/pkgdown.yml +++ b/dev/pkgdown.yml @@ -2,7 +2,7 @@ pandoc: 3.1.11 pkgdown: 2.1.1 pkgdown_sha: ~ articles: {} -last_built: 2024-11-20T10:46Z +last_built: 2025-01-20T11:40Z urls: reference: https://pkgload.r-lib.org/reference article: https://pkgload.r-lib.org/articles diff --git a/dev/search.json b/dev/search.json index 54a888c..6eb1bb4 100644 --- a/dev/search.json +++ b/dev/search.json @@ -1 +1 @@ -[{"path":[]},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"our-pledge","dir":"","previous_headings":"","what":"Our Pledge","title":"Contributor Covenant Code of Conduct","text":"members, contributors, leaders pledge make participation community harassment-free experience everyone, regardless age, body size, visible invisible disability, ethnicity, sex characteristics, gender identity expression, level experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, sexual identity orientation. pledge act interact ways contribute open, welcoming, diverse, inclusive, healthy community.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"our-standards","dir":"","previous_headings":"","what":"Our Standards","title":"Contributor Covenant Code of Conduct","text":"Examples behavior contributes positive environment community include: Demonstrating empathy kindness toward people respectful differing opinions, viewpoints, experiences Giving gracefully accepting constructive feedback Accepting responsibility apologizing affected mistakes, learning experience Focusing best just us individuals, overall community Examples unacceptable behavior include: use sexualized language imagery, sexual attention advances kind Trolling, insulting derogatory comments, personal political attacks Public private harassment Publishing others’ private information, physical email address, without explicit permission conduct reasonably considered inappropriate professional setting","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"enforcement-responsibilities","dir":"","previous_headings":"","what":"Enforcement Responsibilities","title":"Contributor Covenant Code of Conduct","text":"Community leaders responsible clarifying enforcing standards acceptable behavior take appropriate fair corrective action response behavior deem inappropriate, threatening, offensive, harmful. Community leaders right responsibility remove, edit, reject comments, commits, code, wiki edits, issues, contributions aligned Code Conduct, communicate reasons moderation decisions appropriate.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"scope","dir":"","previous_headings":"","what":"Scope","title":"Contributor Covenant Code of Conduct","text":"Code Conduct applies within community spaces, also applies individual officially representing community public spaces. Examples representing community include using official e-mail address, posting via official social media account, acting appointed representative online offline event.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"enforcement","dir":"","previous_headings":"","what":"Enforcement","title":"Contributor Covenant Code of Conduct","text":"Instances abusive, harassing, otherwise unacceptable behavior may reported community leaders responsible enforcement codeofconduct@posit.co. complaints reviewed investigated promptly fairly. community leaders obligated respect privacy security reporter incident.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"enforcement-guidelines","dir":"","previous_headings":"","what":"Enforcement Guidelines","title":"Contributor Covenant Code of Conduct","text":"Community leaders follow Community Impact Guidelines determining consequences action deem violation Code Conduct:","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"id_1-correction","dir":"","previous_headings":"Enforcement Guidelines","what":"1. Correction","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Use inappropriate language behavior deemed unprofessional unwelcome community. Consequence: private, written warning community leaders, providing clarity around nature violation explanation behavior inappropriate. public apology may requested.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"id_2-warning","dir":"","previous_headings":"Enforcement Guidelines","what":"2. Warning","title":"Contributor Covenant Code of Conduct","text":"Community Impact: violation single incident series actions. Consequence: warning consequences continued behavior. interaction people involved, including unsolicited interaction enforcing Code Conduct, specified period time. includes avoiding interactions community spaces well external channels like social media. Violating terms may lead temporary permanent ban.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"id_3-temporary-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"3. Temporary Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: serious violation community standards, including sustained inappropriate behavior. Consequence: temporary ban sort interaction public communication community specified period time. public private interaction people involved, including unsolicited interaction enforcing Code Conduct, allowed period. Violating terms may lead permanent ban.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"id_4-permanent-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"4. Permanent Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Demonstrating pattern violation community standards, including sustained inappropriate behavior, harassment individual, aggression toward disparagement classes individuals. Consequence: permanent ban sort public interaction within community.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"attribution","dir":"","previous_headings":"","what":"Attribution","title":"Contributor Covenant Code of Conduct","text":"Code Conduct adapted Contributor Covenant, version 2.1, available https://www.contributor-covenant.org/version/2/1/code_of_conduct.html. Community Impact Guidelines inspired [Mozilla’s code conduct enforcement ladder][https://github.com/mozilla/inclusion]. answers common questions code conduct, see FAQ https://www.contributor-covenant.org/faq. Translations available https://www.contributor-covenant.org/translations.","code":""},{"path":"https://pkgload.r-lib.org/dev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2024 pkgload authors Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":"https://pkgload.r-lib.org/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Hadley Wickham. Author. Winston Chang. Author. Jim Hester. Author. Lionel Henry. Author, maintainer. . Copyright holder, funder. R Core team. Contributor. namespace vignette code extracted base R","code":""},{"path":"https://pkgload.r-lib.org/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Wickham H, Chang W, Hester J, Henry L (2024). pkgload: Simulate Package Installation Attach. R package version 1.4.0.9000, https://pkgload.r-lib.org, https://github.com/r-lib/pkgload.","code":"@Manual{, title = {pkgload: Simulate Package Installation and Attach}, author = {Hadley Wickham and Winston Chang and Jim Hester and Lionel Henry}, year = {2024}, note = {R package version 1.4.0.9000, https://pkgload.r-lib.org}, url = {https://github.com/r-lib/pkgload}, }"},{"path":"https://pkgload.r-lib.org/dev/index.html","id":"pkgload","dir":"","previous_headings":"","what":"Simulate Package Installation and Attach","title":"Simulate Package Installation and Attach","text":"goal pkgload simulate process installing loading package, without actually complete process, hence making package iteration much faster. previously part devtools (fact original motivation) moved package part devtools conscious uncoupling.","code":""},{"path":"https://pkgload.r-lib.org/dev/index.html","id":"usage","dir":"","previous_headings":"","what":"Usage","title":"Simulate Package Installation and Attach","text":"cases use pkgload directly, instead ’ll call via devtools::load_all().","code":"devtools::load_all()"},{"path":"https://pkgload.r-lib.org/dev/index.html","id":"code-of-conduct","dir":"","previous_headings":"","what":"Code of Conduct","title":"Simulate Package Installation and Attach","text":"Please note pkgload project released Contributor Code Conduct. contributing project, agree abide terms.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/check_dep_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Check that the version of an imported package satisfies the requirements — check_dep_version","title":"Check that the version of an imported package satisfies the requirements — check_dep_version","text":"Check version imported package satisfies requirements","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/check_dep_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check that the version of an imported package satisfies the requirements — check_dep_version","text":"","code":"check_dep_version(dep_name, dep_ver = \"*\")"},{"path":"https://pkgload.r-lib.org/dev/reference/check_dep_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check that the version of an imported package satisfies the requirements — check_dep_version","text":"dep_name name package objects import dep_ver version package, includes specified comparison operator.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/check_suggested.html","id":null,"dir":"Reference","previous_headings":"","what":"Check that the version of an suggested package satisfies the requirements — check_suggested","title":"Check that the version of an suggested package satisfies the requirements — check_suggested","text":"Check version suggested package satisfies requirements","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/check_suggested.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check that the version of an suggested package satisfies the requirements — check_suggested","text":"","code":"check_suggested(package, version = NULL, compare = NA, path = inst(\"pkgload\"))"},{"path":"https://pkgload.r-lib.org/dev/reference/check_suggested.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check that the version of an suggested package satisfies the requirements — check_suggested","text":"package name suggested package version version package compare comparison operator used check version","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_example.html","id":null,"dir":"Reference","previous_headings":"","what":"Run a examples for an in-development function. — dev_example","title":"Run a examples for an in-development function. — dev_example","text":"dev_example replacement example. run_example low-level function takes path Rd file.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_example.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run a examples for an in-development function. — dev_example","text":"","code":"dev_example(topic, quiet = FALSE) run_example( path, run_donttest = FALSE, run_dontrun = FALSE, env = new.env(parent = globalenv()), quiet = FALSE, macros = NULL, run, test )"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_example.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run a examples for an in-development function. — dev_example","text":"topic Name topic (name Rd) file run examples quiet TRUE, echo code console. path Path .Rd file run_donttest TRUE, run \\donttest sections Rd files. run_dontrun TRUE, run \\dontrun sections Rd files. env Environment code run. macros Custom macros use parse .Rd file. See macros argument tools::parse_Rd(). NULL, tools::Rd2ex() (tools::parse_Rd()) default used. run, test Deprecated, see run_dontrun run_donttest .","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_example.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run a examples for an in-development function. — dev_example","text":"","code":"if (FALSE) { # \\dontrun{ # Runs installed example: library(\"ggplot2\") example(\"ggplot\") # Runs development example: dev_example(\"ggplot\") } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_help.html","id":null,"dir":"Reference","previous_headings":"","what":"In-development help for package loaded with devtools — dev_help","title":"In-development help for package loaded with devtools — dev_help","text":"dev_help() searches source documentation provided packages loaded devtools. improve performance, .Rd files parsed create index , cached. Use dev_topic_index_reset() clear index. can manually retrieve index local package dev_topic_index().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_help.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"In-development help for package loaded with devtools — dev_help","text":"","code":"dev_help( topic, dev_packages = NULL, stage = \"render\", type = getOption(\"help_type\") ) dev_topic_find(topic, dev_packages = NULL) dev_topic_index(path = \".\") dev_topic_index_reset(pkg_name)"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_help.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"In-development help for package loaded with devtools — dev_help","text":"topic name help search . dev_packages character vector package names search within. NULL, defaults packages loaded devtools. stage stage (\"build\", \"install\", \"render\") \\\\Sexpr macros executed? important using \\\\Sexpr macro's Rd files. type html produce: \"html\" \"text\". Defaults default documentation type. path Path package. pkg_name Name package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_help.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"In-development help for package loaded with devtools — dev_help","text":"","code":"if (FALSE) { # \\dontrun{ library(\"ggplot2\") help(\"ggplot\") # loads installed documentation for ggplot load_all(\"ggplot2\") dev_help(\"ggplot\") # loads development documentation for ggplot } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_meta.html","id":null,"dir":"Reference","previous_headings":"","what":"Return devtools metadata environment — dev_meta","title":"Return devtools metadata environment — dev_meta","text":"package loaded devtools, returns NULL.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_meta.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return devtools metadata environment — dev_meta","text":"","code":"dev_meta(name)"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_meta.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return devtools metadata environment — dev_meta","text":"name name loaded package","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_meta.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Return devtools metadata environment — dev_meta","text":"","code":"dev_meta(\"stats\") # NULL #> NULL if (has_tests()) { # Load the test package in directory \"testLoadHooks\" load_all(pkgtest(\"testLoadHooks\")) # Get metadata for the package x <- dev_meta(\"testLoadHooks\") as.list(x) # Clean up. unload(\"testLoadHooks\") }"},{"path":"https://pkgload.r-lib.org/dev/reference/has_tests.html","id":null,"dir":"Reference","previous_headings":"","what":"Was devtools installed with tests? — has_tests","title":"Was devtools installed with tests? — has_tests","text":"devtools installed tests?","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/has_tests.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Was devtools installed with tests? — has_tests","text":"","code":"has_tests()"},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":null,"dir":"Reference","previous_headings":"","what":"Drop-in replacements for help and ? functions — help","title":"Drop-in replacements for help and ? functions — help","text":"? help functions replacements functions name utils package. made available package loaded load_all().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Drop-in replacements for help and ? functions — help","text":"","code":"# help(topic, package = NULL, ...) # ?e2 # e1?e2"},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Drop-in replacements for help and ? functions — help","text":"topic name character string specifying help topic. package name character string specifying package search help topic. NULL, search packages. ... Additional arguments pass utils::help(). e1 First argument pass along utils::?“. e2 Second argument pass along utils::?“.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Drop-in replacements for help and ? functions — help","text":"? function replacement utils::?() utils package. search help devtools-loaded packages first, regular packages. help function replacement utils::help() utils package. package specified, search help devtools-loaded packages first, regular packages. package specified, search help devtools-loaded packages regular packages, appropriate.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Drop-in replacements for help and ? functions — help","text":"","code":"if (FALSE) { # \\dontrun{ # This would load devtools and look at the help for load_all, if currently # in the devtools source directory. load_all() ?load_all help(\"load_all\") } # } # To see the help pages for utils::help and utils::`?`: help(\"help\", \"utils\") help(\"?\", \"utils\") if (FALSE) { # \\dontrun{ # Examples demonstrating the multiple ways of supplying arguments # NB: you can't do pkg <- \"ggplot2\"; help(\"ggplot2\", pkg) help(lm) help(lm, stats) help(lm, 'stats') help('lm') help('lm', stats) help('lm', 'stats') help(package = stats) help(package = 'stats') topic <- \"lm\" help(topic) help(topic, stats) help(topic, 'stats') } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/imports_env.html","id":null,"dir":"Reference","previous_headings":"","what":"Return imports environment for a package — imports_env","title":"Return imports environment for a package — imports_env","text":"Contains objects imported packages. parent package namespace environment, child , child R_GlobalEnv.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/imports_env.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return imports environment for a package — imports_env","text":"","code":"imports_env(package)"},{"path":"https://pkgload.r-lib.org/dev/reference/imports_env.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return imports environment for a package — imports_env","text":"package package name string.","code":""},{"path":[]},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the installation path of a package — inst","title":"Get the installation path of a package — inst","text":"Given name package, returns path installed copy package, can passed devtools functions.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the installation path of a package — inst","text":"","code":"inst(name)"},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the installation path of a package — inst","text":"name name package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get the installation path of a package — inst","text":"searches package .libPaths(). multiple dirs found, return first one.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the installation path of a package — inst","text":"","code":"inst(\"pkgload\") #> [1] \"/home/runner/work/_temp/Library/pkgload\" inst(\"grid\") #> [1] \"/opt/R/4.4.2/lib/R/library/grid\""},{"path":"https://pkgload.r-lib.org/dev/reference/is_dev_package.html","id":null,"dir":"Reference","previous_headings":"","what":"Is the package currently under development? — is_dev_package","title":"Is the package currently under development? — is_dev_package","text":"Returns TRUE FALSE depending package loaded pkgload.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/is_dev_package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is the package currently under development? — is_dev_package","text":"","code":"is_dev_package(name)"},{"path":"https://pkgload.r-lib.org/dev/reference/is_dev_package.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is the package currently under development? — is_dev_package","text":"name name package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":null,"dir":"Reference","previous_headings":"","what":"Load complete package — load_all","title":"Load complete package — load_all","text":"load_all() loads package. roughly simulates happens package installed loaded library(), without first install package. : Loads data files data/. See load_data() details. Sources R files R directory, storing results environment behaves like regular package namespace. See load_code() details. Adds shim system.file() shim_system.file() imports environment package. ensures system.file() works development installed packages despite differing directory structures. Adds shims help() ? shim_help() shim_question() make easier preview development documentation. Compiles C, C++, Fortran code src/ directory connects generated DLL R. See pkgbuild::compile_dll() details. Loads compiled translations inst/po. Runs .onAttach(), .onLoad() .onUnload() functions correct times. use testthat, load test helpers can access interactively. devtools sets DEVTOOLS_LOAD environment variable package name let check whether helpers run package loading. is_loading() returns TRUE called load_all() running. may useful e.g. .onLoad hooks. package loaded load_all() can identified is_dev_package().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load complete package — load_all","text":"","code":"load_all( path = \".\", reset = TRUE, compile = NA, attach = TRUE, export_all = TRUE, export_imports = export_all, helpers = export_all, attach_testthat = uses_testthat(path), quiet = NULL, recompile = FALSE, warn_conflicts = TRUE ) is_loading(pkg = NULL)"},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load complete package — load_all","text":"path Path package, within package. reset longer supported preserving namespace requires unlocking environment, longer possible recent versions R. compile TRUE always recompiles package; NA recompiles needed (determined pkgbuild::needs_compile()); FALSE, never recompiles. attach Whether attach package environment search path. FALSE load_all() behaves like loadNamespace(). TRUE (default), behaves like library(). FALSE, export_all, export_imports, helpers arguments effect. export_all TRUE (default), export objects. FALSE, export objects listed exports NAMESPACE file. export_imports TRUE (default), export objects imported package. FALSE export objects defined package. helpers TRUE loads testthat test helpers. attach_testthat TRUE, attach testthat search path, closely mimics environment within test files. quiet TRUE suppresses output function. recompile DEPRECATED. force recompile DLL source code, present. equivalent running pkgbuild::clean_dll() load_all() warn_conflicts TRUE, issues warning function global environment masks function package. can happen accidentally source .R file, rather using load_all(), define function directly R console. frustrating debug, feels like changes make package source expected effect. pkg supplied, is_loading() returns TRUE package loaded pkg.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"differences-to-regular-loading","dir":"Reference","previous_headings":"","what":"Differences to regular loading","title":"Load complete package — load_all","text":"load_all() tries best reproduce behaviour loadNamespace() library(). However deviates normal package loading several ways. load_all() install package library, system.file() work. pkgload fixes package installing shim, shim_system.file(). However, shim visible third party packages, fail attempt find files within package. One potential workaround use fs::path_package() instead system.file(), since understands mechanisms devtools uses load packages. load_all() loads packages referenced Imports load time, loadNamespace() library() load package dependencies needed. load_all() copies objects (just ones listed exports) package environment. useful development makes internal objects easy access. export objects listed exports, use export_all = FALSE. closely simulates behavior loading installed package library(), can useful checking missing exports.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"controlling-the-debug-compiler-flags","dir":"Reference","previous_headings":"","what":"Controlling the debug compiler flags","title":"Load complete package — load_all","text":"load_all() delegates pkgbuild::compile_dll() perform actual compilation, default debug compiler flags appended. like produce optimized build instead, can opt setting pkg.build_extra_flags option PKG_BUILD_EXTRA_FLAGS environment variable FALSE. details see Details section pkgbuild::compile_dll().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Load complete package — load_all","text":"","code":"if (FALSE) { # \\dontrun{ # Load the package in the current directory load_all(\"./\") # Running again loads changed files load_all(\"./\") # With export_all=FALSE, only objects listed as exports in NAMESPACE # are exported load_all(\"./\", export_all = FALSE) } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/load_code.html","id":null,"dir":"Reference","previous_headings":"","what":"Load R code. — load_code","title":"Load R code. — load_code","text":"Sources .R/.r files R/ directory, storing results package namespace.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_code.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load R code. — load_code","text":"","code":"load_code(path = \".\", quiet = NULL)"},{"path":"https://pkgload.r-lib.org/dev/reference/load_code.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load R code. — load_code","text":"path Path package, within package. quiet TRUE suppresses output function.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_data.html","id":null,"dir":"Reference","previous_headings":"","what":"Load data. — load_data","title":"Load data. — load_data","text":"Loads .RData files data subdirectory.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load data. — load_data","text":"","code":"load_data(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/load_data.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load data. — load_data","text":"path Path package, within package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_dll.html","id":null,"dir":"Reference","previous_headings":"","what":"Load a compiled DLL — load_dll","title":"Load a compiled DLL — load_dll","text":"Load compiled DLL","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_dll.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load a compiled DLL — load_dll","text":"","code":"load_dll(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/load_dll.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load a compiled DLL — load_dll","text":"path Path package, within package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_imports.html","id":null,"dir":"Reference","previous_headings":"","what":"Load all of the imports for a package — load_imports","title":"Load all of the imports for a package — load_imports","text":"imported objects copied imports environment, visible R_GlobalEnv. automatically load (attach) dependency packages.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_imports.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load all of the imports for a package — load_imports","text":"","code":"load_imports(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/ns_env.html","id":null,"dir":"Reference","previous_headings":"","what":"Return the namespace environment for a package. — ns_env","title":"Return the namespace environment for a package. — ns_env","text":"Contains (exported non-exported) objects, descendant R_GlobalEnv. hierarchy , , , R_GlobalEnv.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/ns_env.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return the namespace environment for a package. — ns_env","text":"","code":"ns_env(package)"},{"path":"https://pkgload.r-lib.org/dev/reference/ns_env.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return the namespace environment for a package. — ns_env","text":"package package name.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/ns_env.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Return the namespace environment for a package. — ns_env","text":"package loaded, function returns NULL.","code":""},{"path":[]},{"path":"https://pkgload.r-lib.org/dev/reference/package_file.html","id":null,"dir":"Reference","previous_headings":"","what":"Find file in a package. — package_file","title":"Find file in a package. — package_file","text":"always starts finding walking path finds root directory, .e. directory containing DESCRIPTION. find root directory, find specified path, throw error.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/package_file.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find file in a package. — package_file","text":"","code":"package_file(..., path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/package_file.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find file in a package. — package_file","text":"... Components path. path Place start search package directory.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/package_file.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Find file in a package. — package_file","text":"","code":"if (FALSE) { # \\dontrun{ package_file(\"figures\", \"figure_1\") } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/packages.html","id":null,"dir":"Reference","previous_headings":"","what":"Helper functions for working with development packages. — packages","title":"Helper functions for working with development packages. — packages","text":"functions search recursively directory tree input path find DESCRIPTION file.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/packages.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Helper functions for working with development packages. — packages","text":"","code":"pkg_path(path = \".\") pkg_name(path = \".\") pkg_desc(path = \".\") pkg_version(path = \".\") pkg_version_raw(path = \".\") pkg_ns(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/packages.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Helper functions for working with development packages. — packages","text":"path Path package, within package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/packages.html","id":"functions","dir":"Reference","previous_headings":"","what":"Functions","title":"Helper functions for working with development packages. — packages","text":"pkg_path(): Return normalized package path. pkg_name(): Return package name. pkg_desc(): Return package DESCRIPTION desc::desc() object. pkg_version(): Return parsed package version. pkg_version_raw(): Return raw package version (string). pkg_ns(): Return package namespace.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":null,"dir":"Reference","previous_headings":"","what":"Parse package dependency strings. — parse_deps","title":"Parse package dependency strings. — parse_deps","text":"Parse package dependency strings.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Parse package dependency strings. — parse_deps","text":"","code":"parse_deps(string)"},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Parse package dependency strings. — parse_deps","text":"string parse. look like \"R (>= 3.0), ggplot2\" etc.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Parse package dependency strings. — parse_deps","text":"list two character vectors: name package names, version package versions. version specified, stored NA.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Parse package dependency strings. — parse_deps","text":"","code":"parse_deps(\"httr (< 2.1),\\nRCurl (>= 3)\") #> name compare version #> 1 httr < 2.1 #> 2 RCurl >= 3 # only package dependencies are returned parse_deps(\"utils (== 2.12.1),\\ntools,\\nR (>= 2.10),\\nmemoise\") #> name compare version #> 1 utils == 2.12.1 #> 2 tools #> 4 memoise "},{"path":"https://pkgload.r-lib.org/dev/reference/parse_ns_file.html","id":null,"dir":"Reference","previous_headings":"","what":"Parses the NAMESPACE file for a package — parse_ns_file","title":"Parses the NAMESPACE file for a package — parse_ns_file","text":"Parses NAMESPACE file package","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_ns_file.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Parses the NAMESPACE file for a package — parse_ns_file","text":"","code":"parse_ns_file(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/parse_ns_file.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Parses the NAMESPACE file for a package — parse_ns_file","text":"path Path package, within package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_ns_file.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Parses the NAMESPACE file for a package — parse_ns_file","text":"","code":"if (has_tests()) { parse_ns_file(pkgtest(\"testLoadHooks\")) }"},{"path":"https://pkgload.r-lib.org/dev/reference/pkg_env.html","id":null,"dir":"Reference","previous_headings":"","what":"Return package environment — pkg_env","title":"Return package environment — pkg_env","text":"environment like . package environment contains exported objects package. attached, ancestor R_GlobalEnv.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkg_env.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return package environment — pkg_env","text":"","code":"pkg_env(package)"},{"path":"https://pkgload.r-lib.org/dev/reference/pkg_env.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return package environment — pkg_env","text":"package package name.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkg_env.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Return package environment — pkg_env","text":"package loaded normal way, using library(), environment contains exported objects namespace. However, loaded load_all(), environment contain objects namespace, unless load_all used export_all=FALSE. package attached, function returns NULL.","code":""},{"path":[]},{"path":"https://pkgload.r-lib.org/dev/reference/pkgload-package.html","id":null,"dir":"Reference","previous_headings":"","what":"pkgload: Simulate Package Installation and Attach — pkgload-package","title":"pkgload: Simulate Package Installation and Attach — pkgload-package","text":"Simulates process installing package attaching . key part 'devtools' package allows rapidly iterate developing package.","code":""},{"path":[]},{"path":"https://pkgload.r-lib.org/dev/reference/pkgload-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"pkgload: Simulate Package Installation and Attach — pkgload-package","text":"Maintainer: Lionel Henry lionel@posit.co Authors: Hadley Wickham Winston Chang Jim Hester contributors: Posit Software, PBC [copyright holder, funder] R Core team (namespace vignette code extracted base R) [contributor]","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkgtest.html","id":null,"dir":"Reference","previous_headings":"","what":"Return the path to one of the packages in the devtools test dir — pkgtest","title":"Return the path to one of the packages in the devtools test dir — pkgtest","text":"devtools comes simple packages testing. function returns path .","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkgtest.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return the path to one of the packages in the devtools test dir — pkgtest","text":"","code":"pkgtest(package)"},{"path":"https://pkgload.r-lib.org/dev/reference/pkgtest.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return the path to one of the packages in the devtools test dir — pkgtest","text":"package Name test package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkgtest.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Return the path to one of the packages in the devtools test dir — pkgtest","text":"","code":"if (has_tests()) { pkgtest(\"testData\") }"},{"path":"https://pkgload.r-lib.org/dev/reference/run_pkg_hook.html","id":null,"dir":"Reference","previous_headings":"","what":"Run user and package hooks. — run_pkg_hook","title":"Run user and package hooks. — run_pkg_hook","text":"Run user package hooks.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/run_pkg_hook.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run user and package hooks. — run_pkg_hook","text":"","code":"run_pkg_hook(package, hook) run_user_hook(package, hook)"},{"path":"https://pkgload.r-lib.org/dev/reference/run_pkg_hook.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run user and package hooks. — run_pkg_hook","text":"package package name. hook hook name: one \"load\", \"unload\", \"attach\", \"detach\"","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/system.file.html","id":null,"dir":"Reference","previous_headings":"","what":"Replacement version of system.file — system.file","title":"Replacement version of system.file — system.file","text":"function meant intercept calls base::system.file(), behaves well packages loaded devtools. made available package loaded load_all().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/system.file.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replacement version of system.file — system.file","text":"","code":"shim_system.file(..., package = \"base\", lib.loc = NULL, mustWork = FALSE)"},{"path":"https://pkgload.r-lib.org/dev/reference/system.file.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replacement version of system.file — system.file","text":"... character vectors, specifying subdirectory file(s) within package. default, none, returns root package. Wildcards supported. package character string name single package. error occurs one package name given. lib.loc character vector path names R libraries. See ‘Details’ meaning default value NULL. mustWork logical. TRUE, error given matching files.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/system.file.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Replacement version of system.file — system.file","text":"system.file called R console (global environment), function detects target package loaded load_all(), , uses customized method searching file. necessary directory structure source package different directory structure installed package. package loaded load_all, function also inserted package's imports environment, calls system.file within package namespace use modified version. function inserted imports environment, package end calling base::system.file instead.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/unload.html","id":null,"dir":"Reference","previous_headings":"","what":"Unload a package — unload","title":"Unload a package — unload","text":"unload() attempts cleanly unload package, including unloading namespace, deleting S4 class definitions unloading loaded DLLs. Unfortunately S4 classes really designed cleanly unloaded, manually modify class dependency graph order work - works cases tested may others. Similarly, automated DLL unloading best tested simple scenarios (particularly useDynLib(pkgname) may fail cases. encounter failure, please file bug report https://github.com/r-lib/pkgload/issues. unregister() gentler version unload() removes package search path, unregisters methods, unregisters namespace. unload namespace DLL keep working order case dangling references.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/unload.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Unload a package — unload","text":"","code":"unload(package = pkg_name(), quiet = FALSE) unregister(package = pkg_name())"},{"path":"https://pkgload.r-lib.org/dev/reference/unload.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Unload a package — unload","text":"package package name. quiet TRUE suppresses output function.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/unload.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Unload a package — unload","text":"","code":"if (FALSE) { # \\dontrun{ # Unload package that is in current directory unload() # Unload package that is in ./ggplot2/ unload(pkg_name(\"ggplot2/\")) library(ggplot2) # unload the ggplot2 package directly by name unload(\"ggplot2\") } # }"},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-development-version","dir":"Changelog","previous_headings":"","what":"pkgload (development version)","title":"pkgload (development version)","text":"generator compile_commands.json now checks existing R_SHARE_DIR R_INCLUDE_DIR environment variables (#287, #296, @TimTaylor @shikokuchuo). generator compile_commands.json now reliable presence extra whitespace make’s output (#288, @TimTaylor). generator compile_commands.json now uses escaped double quotes LinkingTo packages ensure valid argument strings parsed Windows (#305, @tylermorganwall).","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-140","dir":"Changelog","previous_headings":"","what":"pkgload 1.4.0","title":"pkgload 1.4.0","text":"CRAN release: 2024-06-28 reset argment load_all() longer supported preserving namespace requires unlocking environment, longer possible recent versions R. longer necessary performance issues caused resetting namespace resolved ago. New experimental feature generating compile_commands.json file load_all(). file used LSP servers clangd provide intellisense features native files. enable , add directive DESCRIPTION file: ’ll also want add compile_commands.json .cache gitignore Rbuildignore files. accomplish steps, feel free use unexported function pkgload:::use_compilation_db(). eventually exported usethis package. load_all() now includes link exact location loading failed (@olivroy, #282). User onload hooks now passed library path. Fixed error updating packages load (@olivroy, #261). Fixed bug shim_help() complex package = argument evaluating NULL cause error (#266).","code":"Config/build/compilation-database: true"},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-134","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.4","title":"pkgload 1.3.4","text":"CRAN release: 2024-01-16 load, pkgload now sets PKGLOAD_PARENT_TEMPDIR temporary directory used current process. provides convenient place cache results functions used subprocesses (e.g. devtools::test(), devtools::document()). Fixes Debian packaging.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-133","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.3","title":"pkgload 1.3.3","text":"CRAN release: 2023-09-22 dev_topic_index() now exported (#257). Fix handling active bindings inside package unloading (#255, @klmr). helpers argument load_all now defaults value provided export_all arguments. makes behaviour safer default (#244). pkgload now depends unconditionally pkgbuild (#249). load_all() longer standardises version number namespace metadata (#231). New pkg_version_raw() get raw package version string.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-132","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.2","title":"pkgload 1.3.2","text":"CRAN release: 2022-11-16 Fixes CRAN checks.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-131","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.1","title":"pkgload 1.3.1","text":"CRAN release: 2022-10-28 dev_topic_find() now exported (#215). dev_help() remind run pkgload::load_all() -development packages found (#221). Shimmed ? now works even ’ve renamed documentation topic (#220). dev_help() now works RStudio daily deliver rendered development documentation includes working images links (#228).","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-130","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.0","title":"pkgload 1.3.0","text":"CRAN release: 2022-06-27 load_all() now calls rlang::check_installed() prompt whether install missing packages. Outdated missing dependencies installed using pak installed. , remotes package used installed. Otherwise install.packages() used last resort method support Remotes fields. load_all() gains attach argument set TRUE default (#209). set FALSE, load_all() creates new namespace doesn’t create package environment search path. case, similar loadNamespace() library(). Improved way help pages displayed RStudio. makes behaviour within outside RStudio consistent fixes issues Rd macros (#120). unregister() now exported. gentler version unload() removes package search path, unregisters methods, unregisters namespace. However doesn’t try unload namespace DLL dangling references keep working. User onLoad hooks now run exports populated. allows hook use exported functions. loaded namespace now locked just user onLoad hooks run. better reproduced namespace sealing behaviour regular loading. package environment environment now locked well user package onAttach hooks run. Added support loading ..dll file inst folder via new library.dynam() shim (@ethanplunkett, #48). system.file() shim now fails supply path starts inst better reproduce behaviour installed packages (#104). load_all() now imports dependencies lazily avoid parallel installation issues (#89). Unknown Rd macros longer trigger warning building package topic index (#119). load_all(compile = TRUE) now forces full recompilation (#93). advice running rm() remove conflicts objects global environment now clickable RStudio (#199). New is_loading() predicate detect whether load_all() currently running (#134). .dynLibs() longer emptied package DLL unloaded (#176). ? shim longer interprets ?\"/\" path (#198). rstudioapi longer hard dependency pkgload (#187). Errors thrown user hooks now demoted warning condition. Previously demoted using try(), making harder debug . load_all() correctly re-loads modified translations, avoiding usual gettext behaviour.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-124","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.4","title":"pkgload 1.2.4","text":"CRAN release: 2021-11-30 Lionel Henry now maintainer. load_all() automatically registers package translations, found.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-123","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.3","title":"pkgload 1.2.3","text":"CRAN release: 2021-10-13 pkgload now forces bindings unload. fixes errors inconsistencies dangling references force lazy bindings unload reload. load_all() now restores S3 methods registered third party packages (#163). load_dll() now preserve DLL name loading instead always using package name. allows packages include DLL’s different names (#162, @dfalbel).","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-122","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.2","title":"pkgload 1.2.2","text":"CRAN release: 2021-09-11","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-121","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.1","title":"pkgload 1.2.1","text":"CRAN release: 2021-04-06 unload() longer unregisters methods generics package unloaded. way dangling references generics defined stale namespace still work expected (r-lib/vctrs#1341). load_all() now work packages testthat tests testthat installed (#151) pkgbuild dependency moved Suggests, needed packages compiled code. load_all() now work packages testthat tests testthat installed (#151) load_all(warn_conflicts = TRUE) becomes narrow warns function global environment masks function package, consistent docs (#125, #143 @jennybc). load_all() longer comprehensive check DESCRIPTION file loading, instead just checking exists starts Package (#149, @malcolmbarrett) unload() longer warns can’t unload namespace.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-120","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.0","title":"pkgload 1.2.0","text":"CRAN release: 2021-02-23 Fix test failure R 4.1 regards S4 method registration load_all() now preserves existing namespaces working order. particular, doesn’t unload package’s shared library keeps loaded instead. reloading, copy new namespace loaded temporary location. temporary SOs unloaded GC deleted temporary location via weak reference attached namespace. mechanism ensures lingering references namespace keep working expected. Consequently namespace propagation routine added pkgload workaround removed. Note .Call() invocations pass string symbol rather structured symbol may keep crashing, R look recently loaded given name. Since symbol registration now norm, don’t expect cause much trouble. load_all() longer forces bindings namespace avoid lazy-load errors. Instead, removes exported S3 methods relevant tables. improves loading behaviour packages define objects namespaces lazily (e.g. delayedAssign()). also makes load_all() predictable method removed package. now actually removed generic table. previously linger R restarted. load_all() attaches testthat, automatically suppresses conflicts.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-110","dir":"Changelog","previous_headings":"","what":"pkgload 1.1.0","title":"pkgload 1.1.0","text":"CRAN release: 2020-05-29 dev_example() now works removing inconsistent call load_all() (@riccardoporreca, #122). load_all() now issues warning exported objects conflict objects defined global environment (#112) run_example() arguments run test deprecated favor (hopefully) clear run_dontrun run_donttest (#107). Internal fixes compatibility future 4.1.0 release.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-102","dir":"Changelog","previous_headings":"","what":"pkgload 1.0.2","title":"pkgload 1.0.2","text":"CRAN release: 2018-10-29 shim_question() now works topics R base package passed double colon operator (e.g. base::min) (@mdequeljoe, #99). load_all() now allows using explicitly qualified, exported names test helpers (@klmr, #95). load_all() gains compile argument controls finely whether compile code . recompile argument now deprecated removed future version pkgload.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-101","dir":"Changelog","previous_headings":"","what":"pkgload 1.0.1","title":"pkgload 1.0.1","text":"CRAN release: 2018-10-11 unload() now removes S4 classes generated package unloaded (#75) help() longer error trying load package level help (#67). Trailing slashes now removed paths, fixes issues Windows (#73). load_dll() now fixed R-devel (#77). help shim’s now work ::: inputs (#72).","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-100","dir":"Changelog","previous_headings":"","what":"pkgload 1.0.0","title":"pkgload 1.0.0","text":"CRAN release: 2018-07-07 load_all() now updates imports dependent packages package reloaded (#59). load_all() now assigns DESCRIPTION/Depends .Depends object package environment. (@yiufung pkgload#61) load_all() now attaches testthat attach_testthat option TRUE. allows load_all() closely mimic testing environment. (#56) check_dep_version() check_suggested() now exported. check_dep_version() now emits warning returns FALSE rather aborting. (#47) Package imports now exported using load_all(). behavior can disabled using load_all(export_imports = FALSE). .package() .package() functions removed. load_code(), load_data(), load_dll(), load_all(), parse_ns_file() now take explicit path rather path package object. imports_env(), ns_env(), pkg_env() unload() now take package name rather path package object. run_example() now works R 3.1. unload() now unloads S4 classes packages loaded library() well load_all() (#46). load_all() gains helpers option specify whether source testthat helpers. (@pitakakariki devtools #1202) load_all() now sources testthat helpers namespace environment rather package environment (#40). load_all() now sets NOT_CRAN environment variable sources testthat helpers. also sets DEVTOOLS_LOAD “true” can check whether run package loading. dev_topic_path() now returns last path found, fixing error package package function level help name. (#21) New function is_dev_package() determine given package loaded pkgload::load_all() (#2). load_all() longer updates collate directive. Instead functionality moved devtools::document(). dev_help() now optionally takes character vector packages search within. replaces find_topic(). dev_topic_index_reset() now exported, allows reset topic index associated given package. Added NEWS.md file track changes package. Initial release code spun devtools","code":""}] +[{"path":[]},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"our-pledge","dir":"","previous_headings":"","what":"Our Pledge","title":"Contributor Covenant Code of Conduct","text":"members, contributors, leaders pledge make participation community harassment-free experience everyone, regardless age, body size, visible invisible disability, ethnicity, sex characteristics, gender identity expression, level experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, sexual identity orientation. pledge act interact ways contribute open, welcoming, diverse, inclusive, healthy community.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"our-standards","dir":"","previous_headings":"","what":"Our Standards","title":"Contributor Covenant Code of Conduct","text":"Examples behavior contributes positive environment community include: Demonstrating empathy kindness toward people respectful differing opinions, viewpoints, experiences Giving gracefully accepting constructive feedback Accepting responsibility apologizing affected mistakes, learning experience Focusing best just us individuals, overall community Examples unacceptable behavior include: use sexualized language imagery, sexual attention advances kind Trolling, insulting derogatory comments, personal political attacks Public private harassment Publishing others’ private information, physical email address, without explicit permission conduct reasonably considered inappropriate professional setting","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"enforcement-responsibilities","dir":"","previous_headings":"","what":"Enforcement Responsibilities","title":"Contributor Covenant Code of Conduct","text":"Community leaders responsible clarifying enforcing standards acceptable behavior take appropriate fair corrective action response behavior deem inappropriate, threatening, offensive, harmful. Community leaders right responsibility remove, edit, reject comments, commits, code, wiki edits, issues, contributions aligned Code Conduct, communicate reasons moderation decisions appropriate.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"scope","dir":"","previous_headings":"","what":"Scope","title":"Contributor Covenant Code of Conduct","text":"Code Conduct applies within community spaces, also applies individual officially representing community public spaces. Examples representing community include using official e-mail address, posting via official social media account, acting appointed representative online offline event.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"enforcement","dir":"","previous_headings":"","what":"Enforcement","title":"Contributor Covenant Code of Conduct","text":"Instances abusive, harassing, otherwise unacceptable behavior may reported community leaders responsible enforcement codeofconduct@posit.co. complaints reviewed investigated promptly fairly. community leaders obligated respect privacy security reporter incident.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"enforcement-guidelines","dir":"","previous_headings":"","what":"Enforcement Guidelines","title":"Contributor Covenant Code of Conduct","text":"Community leaders follow Community Impact Guidelines determining consequences action deem violation Code Conduct:","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"id_1-correction","dir":"","previous_headings":"Enforcement Guidelines","what":"1. Correction","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Use inappropriate language behavior deemed unprofessional unwelcome community. Consequence: private, written warning community leaders, providing clarity around nature violation explanation behavior inappropriate. public apology may requested.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"id_2-warning","dir":"","previous_headings":"Enforcement Guidelines","what":"2. Warning","title":"Contributor Covenant Code of Conduct","text":"Community Impact: violation single incident series actions. Consequence: warning consequences continued behavior. interaction people involved, including unsolicited interaction enforcing Code Conduct, specified period time. includes avoiding interactions community spaces well external channels like social media. Violating terms may lead temporary permanent ban.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"id_3-temporary-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"3. Temporary Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: serious violation community standards, including sustained inappropriate behavior. Consequence: temporary ban sort interaction public communication community specified period time. public private interaction people involved, including unsolicited interaction enforcing Code Conduct, allowed period. Violating terms may lead permanent ban.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"id_4-permanent-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"4. Permanent Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Demonstrating pattern violation community standards, including sustained inappropriate behavior, harassment individual, aggression toward disparagement classes individuals. Consequence: permanent ban sort public interaction within community.","code":""},{"path":"https://pkgload.r-lib.org/dev/CODE_OF_CONDUCT.html","id":"attribution","dir":"","previous_headings":"","what":"Attribution","title":"Contributor Covenant Code of Conduct","text":"Code Conduct adapted Contributor Covenant, version 2.1, available https://www.contributor-covenant.org/version/2/1/code_of_conduct.html. Community Impact Guidelines inspired [Mozilla’s code conduct enforcement ladder][https://github.com/mozilla/inclusion]. answers common questions code conduct, see FAQ https://www.contributor-covenant.org/faq. Translations available https://www.contributor-covenant.org/translations.","code":""},{"path":"https://pkgload.r-lib.org/dev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2024 pkgload authors Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":"https://pkgload.r-lib.org/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Hadley Wickham. Author. Winston Chang. Author. Jim Hester. Author. Lionel Henry. Author, maintainer. . Copyright holder, funder. R Core team. Contributor. namespace vignette code extracted base R","code":""},{"path":"https://pkgload.r-lib.org/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Wickham H, Chang W, Hester J, Henry L (2025). pkgload: Simulate Package Installation Attach. R package version 1.4.0.9000, https://pkgload.r-lib.org, https://github.com/r-lib/pkgload.","code":"@Manual{, title = {pkgload: Simulate Package Installation and Attach}, author = {Hadley Wickham and Winston Chang and Jim Hester and Lionel Henry}, year = {2025}, note = {R package version 1.4.0.9000, https://pkgload.r-lib.org}, url = {https://github.com/r-lib/pkgload}, }"},{"path":"https://pkgload.r-lib.org/dev/index.html","id":"pkgload","dir":"","previous_headings":"","what":"Simulate Package Installation and Attach","title":"Simulate Package Installation and Attach","text":"goal pkgload simulate process installing loading package, without actually complete process, hence making package iteration much faster. previously part devtools (fact original motivation) moved package part devtools conscious uncoupling.","code":""},{"path":"https://pkgload.r-lib.org/dev/index.html","id":"usage","dir":"","previous_headings":"","what":"Usage","title":"Simulate Package Installation and Attach","text":"cases use pkgload directly, instead ’ll call via devtools::load_all().","code":"devtools::load_all()"},{"path":"https://pkgload.r-lib.org/dev/index.html","id":"code-of-conduct","dir":"","previous_headings":"","what":"Code of Conduct","title":"Simulate Package Installation and Attach","text":"Please note pkgload project released Contributor Code Conduct. contributing project, agree abide terms.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/check_dep_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Check that the version of an imported package satisfies the requirements — check_dep_version","title":"Check that the version of an imported package satisfies the requirements — check_dep_version","text":"Check version imported package satisfies requirements","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/check_dep_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check that the version of an imported package satisfies the requirements — check_dep_version","text":"","code":"check_dep_version(dep_name, dep_ver = \"*\")"},{"path":"https://pkgload.r-lib.org/dev/reference/check_dep_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check that the version of an imported package satisfies the requirements — check_dep_version","text":"dep_name name package objects import dep_ver version package, includes specified comparison operator.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/check_suggested.html","id":null,"dir":"Reference","previous_headings":"","what":"Check that the version of an suggested package satisfies the requirements — check_suggested","title":"Check that the version of an suggested package satisfies the requirements — check_suggested","text":"Check version suggested package satisfies requirements","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/check_suggested.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check that the version of an suggested package satisfies the requirements — check_suggested","text":"","code":"check_suggested(package, version = NULL, compare = NA, path = inst(\"pkgload\"))"},{"path":"https://pkgload.r-lib.org/dev/reference/check_suggested.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check that the version of an suggested package satisfies the requirements — check_suggested","text":"package name suggested package version version package compare comparison operator used check version","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_example.html","id":null,"dir":"Reference","previous_headings":"","what":"Run a examples for an in-development function. — dev_example","title":"Run a examples for an in-development function. — dev_example","text":"dev_example replacement example. run_example low-level function takes path Rd file.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_example.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run a examples for an in-development function. — dev_example","text":"","code":"dev_example(topic, quiet = FALSE) run_example( path, run_donttest = FALSE, run_dontrun = FALSE, env = new.env(parent = globalenv()), quiet = FALSE, macros = NULL, run, test )"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_example.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run a examples for an in-development function. — dev_example","text":"topic Name topic (name Rd) file run examples quiet TRUE, echo code console. path Path .Rd file run_donttest TRUE, run \\donttest sections Rd files. run_dontrun TRUE, run \\dontrun sections Rd files. env Environment code run. macros Custom macros use parse .Rd file. See macros argument tools::parse_Rd(). NULL, tools::Rd2ex() (tools::parse_Rd()) default used. run, test Deprecated, see run_dontrun run_donttest .","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_example.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run a examples for an in-development function. — dev_example","text":"","code":"if (FALSE) { # \\dontrun{ # Runs installed example: library(\"ggplot2\") example(\"ggplot\") # Runs development example: dev_example(\"ggplot\") } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_help.html","id":null,"dir":"Reference","previous_headings":"","what":"In-development help for package loaded with devtools — dev_help","title":"In-development help for package loaded with devtools — dev_help","text":"dev_help() searches source documentation provided packages loaded devtools. improve performance, .Rd files parsed create index , cached. Use dev_topic_index_reset() clear index. can manually retrieve index local package dev_topic_index().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_help.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"In-development help for package loaded with devtools — dev_help","text":"","code":"dev_help( topic, dev_packages = NULL, stage = \"render\", type = getOption(\"help_type\") ) dev_topic_find(topic, dev_packages = NULL) dev_topic_index(path = \".\") dev_topic_index_reset(pkg_name)"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_help.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"In-development help for package loaded with devtools — dev_help","text":"topic name help search . dev_packages character vector package names search within. NULL, defaults packages loaded devtools. stage stage (\"build\", \"install\", \"render\") \\\\Sexpr macros executed? important using \\\\Sexpr macro's Rd files. type html produce: \"html\" \"text\". Defaults default documentation type. path Path package. pkg_name Name package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_help.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"In-development help for package loaded with devtools — dev_help","text":"","code":"if (FALSE) { # \\dontrun{ library(\"ggplot2\") help(\"ggplot\") # loads installed documentation for ggplot load_all(\"ggplot2\") dev_help(\"ggplot\") # loads development documentation for ggplot } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_meta.html","id":null,"dir":"Reference","previous_headings":"","what":"Return devtools metadata environment — dev_meta","title":"Return devtools metadata environment — dev_meta","text":"package loaded devtools, returns NULL.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_meta.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return devtools metadata environment — dev_meta","text":"","code":"dev_meta(name)"},{"path":"https://pkgload.r-lib.org/dev/reference/dev_meta.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return devtools metadata environment — dev_meta","text":"name name loaded package","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/dev_meta.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Return devtools metadata environment — dev_meta","text":"","code":"dev_meta(\"stats\") # NULL #> NULL if (has_tests()) { # Load the test package in directory \"testLoadHooks\" load_all(pkgtest(\"testLoadHooks\")) # Get metadata for the package x <- dev_meta(\"testLoadHooks\") as.list(x) # Clean up. unload(\"testLoadHooks\") }"},{"path":"https://pkgload.r-lib.org/dev/reference/has_tests.html","id":null,"dir":"Reference","previous_headings":"","what":"Was devtools installed with tests? — has_tests","title":"Was devtools installed with tests? — has_tests","text":"devtools installed tests?","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/has_tests.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Was devtools installed with tests? — has_tests","text":"","code":"has_tests()"},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":null,"dir":"Reference","previous_headings":"","what":"Drop-in replacements for help and ? functions — help","title":"Drop-in replacements for help and ? functions — help","text":"? help functions replacements functions name utils package. made available package loaded load_all().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Drop-in replacements for help and ? functions — help","text":"","code":"# help(topic, package = NULL, ...) # ?e2 # e1?e2"},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Drop-in replacements for help and ? functions — help","text":"topic name character string specifying help topic. package name character string specifying package search help topic. NULL, search packages. ... Additional arguments pass utils::help(). e1 First argument pass along utils::?“. e2 Second argument pass along utils::?“.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Drop-in replacements for help and ? functions — help","text":"? function replacement utils::?() utils package. search help devtools-loaded packages first, regular packages. help function replacement utils::help() utils package. package specified, search help devtools-loaded packages first, regular packages. package specified, search help devtools-loaded packages regular packages, appropriate.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/help.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Drop-in replacements for help and ? functions — help","text":"","code":"if (FALSE) { # \\dontrun{ # This would load devtools and look at the help for load_all, if currently # in the devtools source directory. load_all() ?load_all help(\"load_all\") } # } # To see the help pages for utils::help and utils::`?`: help(\"help\", \"utils\") help(\"?\", \"utils\") if (FALSE) { # \\dontrun{ # Examples demonstrating the multiple ways of supplying arguments # NB: you can't do pkg <- \"ggplot2\"; help(\"ggplot2\", pkg) help(lm) help(lm, stats) help(lm, 'stats') help('lm') help('lm', stats) help('lm', 'stats') help(package = stats) help(package = 'stats') topic <- \"lm\" help(topic) help(topic, stats) help(topic, 'stats') } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/imports_env.html","id":null,"dir":"Reference","previous_headings":"","what":"Return imports environment for a package — imports_env","title":"Return imports environment for a package — imports_env","text":"Contains objects imported packages. parent package namespace environment, child , child R_GlobalEnv.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/imports_env.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return imports environment for a package — imports_env","text":"","code":"imports_env(package)"},{"path":"https://pkgload.r-lib.org/dev/reference/imports_env.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return imports environment for a package — imports_env","text":"package package name string.","code":""},{"path":[]},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the installation path of a package — inst","title":"Get the installation path of a package — inst","text":"Given name package, returns path installed copy package, can passed devtools functions.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the installation path of a package — inst","text":"","code":"inst(name)"},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the installation path of a package — inst","text":"name name package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get the installation path of a package — inst","text":"searches package .libPaths(). multiple dirs found, return first one.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/inst.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the installation path of a package — inst","text":"","code":"inst(\"pkgload\") #> [1] \"/home/runner/work/_temp/Library/pkgload\" inst(\"grid\") #> [1] \"/opt/R/4.4.2/lib/R/library/grid\""},{"path":"https://pkgload.r-lib.org/dev/reference/is_dev_package.html","id":null,"dir":"Reference","previous_headings":"","what":"Is the package currently under development? — is_dev_package","title":"Is the package currently under development? — is_dev_package","text":"Returns TRUE FALSE depending package loaded pkgload.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/is_dev_package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is the package currently under development? — is_dev_package","text":"","code":"is_dev_package(name)"},{"path":"https://pkgload.r-lib.org/dev/reference/is_dev_package.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is the package currently under development? — is_dev_package","text":"name name package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":null,"dir":"Reference","previous_headings":"","what":"Load complete package — load_all","title":"Load complete package — load_all","text":"load_all() loads package. roughly simulates happens package installed loaded library(), without first install package. : Loads data files data/. See load_data() details. Sources R files R directory, storing results environment behaves like regular package namespace. See load_code() details. Adds shim system.file() shim_system.file() imports environment package. ensures system.file() works development installed packages despite differing directory structures. Adds shims help() ? shim_help() shim_question() make easier preview development documentation. Compiles C, C++, Fortran code src/ directory connects generated DLL R. See pkgbuild::compile_dll() details. Loads compiled translations inst/po. Runs .onAttach(), .onLoad() .onUnload() functions correct times. use testthat, load test helpers can access interactively. devtools sets DEVTOOLS_LOAD environment variable package name let check whether helpers run package loading. is_loading() returns TRUE called load_all() running. may useful e.g. .onLoad hooks. package loaded load_all() can identified is_dev_package().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load complete package — load_all","text":"","code":"load_all( path = \".\", reset = TRUE, compile = NA, attach = TRUE, export_all = TRUE, export_imports = export_all, helpers = export_all, attach_testthat = uses_testthat(path), quiet = NULL, recompile = FALSE, warn_conflicts = TRUE ) is_loading(pkg = NULL)"},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load complete package — load_all","text":"path Path package, within package. reset longer supported preserving namespace requires unlocking environment, longer possible recent versions R. compile TRUE always recompiles package; NA recompiles needed (determined pkgbuild::needs_compile()); FALSE, never recompiles. attach Whether attach package environment search path. FALSE load_all() behaves like loadNamespace(). TRUE (default), behaves like library(). FALSE, export_all, export_imports, helpers arguments effect. export_all TRUE (default), export objects. FALSE, export objects listed exports NAMESPACE file. export_imports TRUE (default), export objects imported package. FALSE export objects defined package. helpers TRUE loads testthat test helpers. attach_testthat TRUE, attach testthat search path, closely mimics environment within test files. quiet TRUE suppresses output function. recompile DEPRECATED. force recompile DLL source code, present. equivalent running pkgbuild::clean_dll() load_all() warn_conflicts TRUE, issues warning function global environment masks function package. can happen accidentally source .R file, rather using load_all(), define function directly R console. frustrating debug, feels like changes make package source expected effect. pkg supplied, is_loading() returns TRUE package loaded pkg.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"differences-to-regular-loading","dir":"Reference","previous_headings":"","what":"Differences to regular loading","title":"Load complete package — load_all","text":"load_all() tries best reproduce behaviour loadNamespace() library(). However deviates normal package loading several ways. load_all() install package library, system.file() work. pkgload fixes package installing shim, shim_system.file(). However, shim visible third party packages, fail attempt find files within package. One potential workaround use fs::path_package() instead system.file(), since understands mechanisms devtools uses load packages. load_all() loads packages referenced Imports load time, loadNamespace() library() load package dependencies needed. load_all() copies objects (just ones listed exports) package environment. useful development makes internal objects easy access. export objects listed exports, use export_all = FALSE. closely simulates behavior loading installed package library(), can useful checking missing exports.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"controlling-the-debug-compiler-flags","dir":"Reference","previous_headings":"","what":"Controlling the debug compiler flags","title":"Load complete package — load_all","text":"load_all() delegates pkgbuild::compile_dll() perform actual compilation, default debug compiler flags appended. like produce optimized build instead, can opt setting pkg.build_extra_flags option PKG_BUILD_EXTRA_FLAGS environment variable FALSE. details see Details section pkgbuild::compile_dll().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_all.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Load complete package — load_all","text":"","code":"if (FALSE) { # \\dontrun{ # Load the package in the current directory load_all(\"./\") # Running again loads changed files load_all(\"./\") # With export_all=FALSE, only objects listed as exports in NAMESPACE # are exported load_all(\"./\", export_all = FALSE) } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/load_code.html","id":null,"dir":"Reference","previous_headings":"","what":"Load R code. — load_code","title":"Load R code. — load_code","text":"Sources .R/.r files R/ directory, storing results package namespace.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_code.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load R code. — load_code","text":"","code":"load_code(path = \".\", quiet = NULL)"},{"path":"https://pkgload.r-lib.org/dev/reference/load_code.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load R code. — load_code","text":"path Path package, within package. quiet TRUE suppresses output function.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_data.html","id":null,"dir":"Reference","previous_headings":"","what":"Load data. — load_data","title":"Load data. — load_data","text":"Loads .RData files data subdirectory.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load data. — load_data","text":"","code":"load_data(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/load_data.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load data. — load_data","text":"path Path package, within package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_dll.html","id":null,"dir":"Reference","previous_headings":"","what":"Load a compiled DLL — load_dll","title":"Load a compiled DLL — load_dll","text":"Load compiled DLL","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_dll.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load a compiled DLL — load_dll","text":"","code":"load_dll(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/load_dll.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load a compiled DLL — load_dll","text":"path Path package, within package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_imports.html","id":null,"dir":"Reference","previous_headings":"","what":"Load all of the imports for a package — load_imports","title":"Load all of the imports for a package — load_imports","text":"imported objects copied imports environment, visible R_GlobalEnv. automatically load (attach) dependency packages.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/load_imports.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load all of the imports for a package — load_imports","text":"","code":"load_imports(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/ns_env.html","id":null,"dir":"Reference","previous_headings":"","what":"Return the namespace environment for a package. — ns_env","title":"Return the namespace environment for a package. — ns_env","text":"Contains (exported non-exported) objects, descendant R_GlobalEnv. hierarchy , , , R_GlobalEnv.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/ns_env.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return the namespace environment for a package. — ns_env","text":"","code":"ns_env(package)"},{"path":"https://pkgload.r-lib.org/dev/reference/ns_env.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return the namespace environment for a package. — ns_env","text":"package package name.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/ns_env.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Return the namespace environment for a package. — ns_env","text":"package loaded, function returns NULL.","code":""},{"path":[]},{"path":"https://pkgload.r-lib.org/dev/reference/package_file.html","id":null,"dir":"Reference","previous_headings":"","what":"Find file in a package. — package_file","title":"Find file in a package. — package_file","text":"always starts finding walking path finds root directory, .e. directory containing DESCRIPTION. find root directory, find specified path, throw error.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/package_file.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find file in a package. — package_file","text":"","code":"package_file(..., path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/package_file.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find file in a package. — package_file","text":"... Components path. path Place start search package directory.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/package_file.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Find file in a package. — package_file","text":"","code":"if (FALSE) { # \\dontrun{ package_file(\"figures\", \"figure_1\") } # }"},{"path":"https://pkgload.r-lib.org/dev/reference/packages.html","id":null,"dir":"Reference","previous_headings":"","what":"Helper functions for working with development packages. — packages","title":"Helper functions for working with development packages. — packages","text":"functions search recursively directory tree input path find DESCRIPTION file.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/packages.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Helper functions for working with development packages. — packages","text":"","code":"pkg_path(path = \".\") pkg_name(path = \".\") pkg_desc(path = \".\") pkg_version(path = \".\") pkg_version_raw(path = \".\") pkg_ns(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/packages.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Helper functions for working with development packages. — packages","text":"path Path package, within package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/packages.html","id":"functions","dir":"Reference","previous_headings":"","what":"Functions","title":"Helper functions for working with development packages. — packages","text":"pkg_path(): Return normalized package path. pkg_name(): Return package name. pkg_desc(): Return package DESCRIPTION desc::desc() object. pkg_version(): Return parsed package version. pkg_version_raw(): Return raw package version (string). pkg_ns(): Return package namespace.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":null,"dir":"Reference","previous_headings":"","what":"Parse package dependency strings. — parse_deps","title":"Parse package dependency strings. — parse_deps","text":"Parse package dependency strings.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Parse package dependency strings. — parse_deps","text":"","code":"parse_deps(string)"},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Parse package dependency strings. — parse_deps","text":"string parse. look like \"R (>= 3.0), ggplot2\" etc.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Parse package dependency strings. — parse_deps","text":"list two character vectors: name package names, version package versions. version specified, stored NA.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_deps.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Parse package dependency strings. — parse_deps","text":"","code":"parse_deps(\"httr (< 2.1),\\nRCurl (>= 3)\") #> name compare version #> 1 httr < 2.1 #> 2 RCurl >= 3 # only package dependencies are returned parse_deps(\"utils (== 2.12.1),\\ntools,\\nR (>= 2.10),\\nmemoise\") #> name compare version #> 1 utils == 2.12.1 #> 2 tools #> 4 memoise "},{"path":"https://pkgload.r-lib.org/dev/reference/parse_ns_file.html","id":null,"dir":"Reference","previous_headings":"","what":"Parses the NAMESPACE file for a package — parse_ns_file","title":"Parses the NAMESPACE file for a package — parse_ns_file","text":"Parses NAMESPACE file package","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_ns_file.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Parses the NAMESPACE file for a package — parse_ns_file","text":"","code":"parse_ns_file(path = \".\")"},{"path":"https://pkgload.r-lib.org/dev/reference/parse_ns_file.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Parses the NAMESPACE file for a package — parse_ns_file","text":"path Path package, within package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/parse_ns_file.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Parses the NAMESPACE file for a package — parse_ns_file","text":"","code":"if (has_tests()) { parse_ns_file(pkgtest(\"testLoadHooks\")) }"},{"path":"https://pkgload.r-lib.org/dev/reference/pkg_env.html","id":null,"dir":"Reference","previous_headings":"","what":"Return package environment — pkg_env","title":"Return package environment — pkg_env","text":"environment like . package environment contains exported objects package. attached, ancestor R_GlobalEnv.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkg_env.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return package environment — pkg_env","text":"","code":"pkg_env(package)"},{"path":"https://pkgload.r-lib.org/dev/reference/pkg_env.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return package environment — pkg_env","text":"package package name.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkg_env.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Return package environment — pkg_env","text":"package loaded normal way, using library(), environment contains exported objects namespace. However, loaded load_all(), environment contain objects namespace, unless load_all used export_all=FALSE. package attached, function returns NULL.","code":""},{"path":[]},{"path":"https://pkgload.r-lib.org/dev/reference/pkgload-package.html","id":null,"dir":"Reference","previous_headings":"","what":"pkgload: Simulate Package Installation and Attach — pkgload-package","title":"pkgload: Simulate Package Installation and Attach — pkgload-package","text":"Simulates process installing package attaching . key part 'devtools' package allows rapidly iterate developing package.","code":""},{"path":[]},{"path":"https://pkgload.r-lib.org/dev/reference/pkgload-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"pkgload: Simulate Package Installation and Attach — pkgload-package","text":"Maintainer: Lionel Henry lionel@posit.co Authors: Hadley Wickham Winston Chang Jim Hester contributors: Posit Software, PBC [copyright holder, funder] R Core team (namespace vignette code extracted base R) [contributor]","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkgtest.html","id":null,"dir":"Reference","previous_headings":"","what":"Return the path to one of the packages in the devtools test dir — pkgtest","title":"Return the path to one of the packages in the devtools test dir — pkgtest","text":"devtools comes simple packages testing. function returns path .","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkgtest.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return the path to one of the packages in the devtools test dir — pkgtest","text":"","code":"pkgtest(package)"},{"path":"https://pkgload.r-lib.org/dev/reference/pkgtest.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return the path to one of the packages in the devtools test dir — pkgtest","text":"package Name test package.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/pkgtest.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Return the path to one of the packages in the devtools test dir — pkgtest","text":"","code":"if (has_tests()) { pkgtest(\"testData\") }"},{"path":"https://pkgload.r-lib.org/dev/reference/run_pkg_hook.html","id":null,"dir":"Reference","previous_headings":"","what":"Run user and package hooks. — run_pkg_hook","title":"Run user and package hooks. — run_pkg_hook","text":"Run user package hooks.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/run_pkg_hook.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run user and package hooks. — run_pkg_hook","text":"","code":"run_pkg_hook(package, hook) run_user_hook(package, hook)"},{"path":"https://pkgload.r-lib.org/dev/reference/run_pkg_hook.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run user and package hooks. — run_pkg_hook","text":"package package name. hook hook name: one \"load\", \"unload\", \"attach\", \"detach\"","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/system.file.html","id":null,"dir":"Reference","previous_headings":"","what":"Replacement version of system.file — system.file","title":"Replacement version of system.file — system.file","text":"function meant intercept calls base::system.file(), behaves well packages loaded devtools. made available package loaded load_all().","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/system.file.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replacement version of system.file — system.file","text":"","code":"shim_system.file(..., package = \"base\", lib.loc = NULL, mustWork = FALSE)"},{"path":"https://pkgload.r-lib.org/dev/reference/system.file.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replacement version of system.file — system.file","text":"... character vectors, specifying subdirectory file(s) within package. default, none, returns root package. Wildcards supported. package character string name single package. error occurs one package name given. lib.loc character vector path names R libraries. See ‘Details’ meaning default value NULL. mustWork logical. TRUE, error given matching files.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/system.file.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Replacement version of system.file — system.file","text":"system.file called R console (global environment), function detects target package loaded load_all(), , uses customized method searching file. necessary directory structure source package different directory structure installed package. package loaded load_all, function also inserted package's imports environment, calls system.file within package namespace use modified version. function inserted imports environment, package end calling base::system.file instead.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/unload.html","id":null,"dir":"Reference","previous_headings":"","what":"Unload a package — unload","title":"Unload a package — unload","text":"unload() attempts cleanly unload package, including unloading namespace, deleting S4 class definitions unloading loaded DLLs. Unfortunately S4 classes really designed cleanly unloaded, manually modify class dependency graph order work - works cases tested may others. Similarly, automated DLL unloading best tested simple scenarios (particularly useDynLib(pkgname) may fail cases. encounter failure, please file bug report https://github.com/r-lib/pkgload/issues. unregister() gentler version unload() removes package search path, unregisters methods, unregisters namespace. unload namespace DLL keep working order case dangling references.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/unload.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Unload a package — unload","text":"","code":"unload(package = pkg_name(), quiet = FALSE) unregister(package = pkg_name())"},{"path":"https://pkgload.r-lib.org/dev/reference/unload.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Unload a package — unload","text":"package package name. quiet TRUE suppresses output function.","code":""},{"path":"https://pkgload.r-lib.org/dev/reference/unload.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Unload a package — unload","text":"","code":"if (FALSE) { # \\dontrun{ # Unload package that is in current directory unload() # Unload package that is in ./ggplot2/ unload(pkg_name(\"ggplot2/\")) library(ggplot2) # unload the ggplot2 package directly by name unload(\"ggplot2\") } # }"},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-development-version","dir":"Changelog","previous_headings":"","what":"pkgload (development version)","title":"pkgload (development version)","text":"generator compile_commands.json now checks existing R_SHARE_DIR R_INCLUDE_DIR environment variables (#287, #296, @TimTaylor @shikokuchuo). generator compile_commands.json now reliable presence extra whitespace make’s output (#288, @TimTaylor). generator compile_commands.json now uses escaped double quotes LinkingTo packages ensure valid argument strings parsed Windows (#305, @tylermorganwall).","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-140","dir":"Changelog","previous_headings":"","what":"pkgload 1.4.0","title":"pkgload 1.4.0","text":"CRAN release: 2024-06-28 reset argment load_all() longer supported preserving namespace requires unlocking environment, longer possible recent versions R. longer necessary performance issues caused resetting namespace resolved ago. New experimental feature generating compile_commands.json file load_all(). file used LSP servers clangd provide intellisense features native files. enable , add directive DESCRIPTION file: ’ll also want add compile_commands.json .cache gitignore Rbuildignore files. accomplish steps, feel free use unexported function pkgload:::use_compilation_db(). eventually exported usethis package. load_all() now includes link exact location loading failed (@olivroy, #282). User onload hooks now passed library path. Fixed error updating packages load (@olivroy, #261). Fixed bug shim_help() complex package = argument evaluating NULL cause error (#266).","code":"Config/build/compilation-database: true"},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-134","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.4","title":"pkgload 1.3.4","text":"CRAN release: 2024-01-16 load, pkgload now sets PKGLOAD_PARENT_TEMPDIR temporary directory used current process. provides convenient place cache results functions used subprocesses (e.g. devtools::test(), devtools::document()). Fixes Debian packaging.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-133","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.3","title":"pkgload 1.3.3","text":"CRAN release: 2023-09-22 dev_topic_index() now exported (#257). Fix handling active bindings inside package unloading (#255, @klmr). helpers argument load_all now defaults value provided export_all arguments. makes behaviour safer default (#244). pkgload now depends unconditionally pkgbuild (#249). load_all() longer standardises version number namespace metadata (#231). New pkg_version_raw() get raw package version string.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-132","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.2","title":"pkgload 1.3.2","text":"CRAN release: 2022-11-16 Fixes CRAN checks.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-131","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.1","title":"pkgload 1.3.1","text":"CRAN release: 2022-10-28 dev_topic_find() now exported (#215). dev_help() remind run pkgload::load_all() -development packages found (#221). Shimmed ? now works even ’ve renamed documentation topic (#220). dev_help() now works RStudio daily deliver rendered development documentation includes working images links (#228).","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-130","dir":"Changelog","previous_headings":"","what":"pkgload 1.3.0","title":"pkgload 1.3.0","text":"CRAN release: 2022-06-27 load_all() now calls rlang::check_installed() prompt whether install missing packages. Outdated missing dependencies installed using pak installed. , remotes package used installed. Otherwise install.packages() used last resort method support Remotes fields. load_all() gains attach argument set TRUE default (#209). set FALSE, load_all() creates new namespace doesn’t create package environment search path. case, similar loadNamespace() library(). Improved way help pages displayed RStudio. makes behaviour within outside RStudio consistent fixes issues Rd macros (#120). unregister() now exported. gentler version unload() removes package search path, unregisters methods, unregisters namespace. However doesn’t try unload namespace DLL dangling references keep working. User onLoad hooks now run exports populated. allows hook use exported functions. loaded namespace now locked just user onLoad hooks run. better reproduced namespace sealing behaviour regular loading. package environment environment now locked well user package onAttach hooks run. Added support loading ..dll file inst folder via new library.dynam() shim (@ethanplunkett, #48). system.file() shim now fails supply path starts inst better reproduce behaviour installed packages (#104). load_all() now imports dependencies lazily avoid parallel installation issues (#89). Unknown Rd macros longer trigger warning building package topic index (#119). load_all(compile = TRUE) now forces full recompilation (#93). advice running rm() remove conflicts objects global environment now clickable RStudio (#199). New is_loading() predicate detect whether load_all() currently running (#134). .dynLibs() longer emptied package DLL unloaded (#176). ? shim longer interprets ?\"/\" path (#198). rstudioapi longer hard dependency pkgload (#187). Errors thrown user hooks now demoted warning condition. Previously demoted using try(), making harder debug . load_all() correctly re-loads modified translations, avoiding usual gettext behaviour.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-124","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.4","title":"pkgload 1.2.4","text":"CRAN release: 2021-11-30 Lionel Henry now maintainer. load_all() automatically registers package translations, found.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-123","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.3","title":"pkgload 1.2.3","text":"CRAN release: 2021-10-13 pkgload now forces bindings unload. fixes errors inconsistencies dangling references force lazy bindings unload reload. load_all() now restores S3 methods registered third party packages (#163). load_dll() now preserve DLL name loading instead always using package name. allows packages include DLL’s different names (#162, @dfalbel).","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-122","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.2","title":"pkgload 1.2.2","text":"CRAN release: 2021-09-11","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-121","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.1","title":"pkgload 1.2.1","text":"CRAN release: 2021-04-06 unload() longer unregisters methods generics package unloaded. way dangling references generics defined stale namespace still work expected (r-lib/vctrs#1341). load_all() now work packages testthat tests testthat installed (#151) pkgbuild dependency moved Suggests, needed packages compiled code. load_all() now work packages testthat tests testthat installed (#151) load_all(warn_conflicts = TRUE) becomes narrow warns function global environment masks function package, consistent docs (#125, #143 @jennybc). load_all() longer comprehensive check DESCRIPTION file loading, instead just checking exists starts Package (#149, @malcolmbarrett) unload() longer warns can’t unload namespace.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-120","dir":"Changelog","previous_headings":"","what":"pkgload 1.2.0","title":"pkgload 1.2.0","text":"CRAN release: 2021-02-23 Fix test failure R 4.1 regards S4 method registration load_all() now preserves existing namespaces working order. particular, doesn’t unload package’s shared library keeps loaded instead. reloading, copy new namespace loaded temporary location. temporary SOs unloaded GC deleted temporary location via weak reference attached namespace. mechanism ensures lingering references namespace keep working expected. Consequently namespace propagation routine added pkgload workaround removed. Note .Call() invocations pass string symbol rather structured symbol may keep crashing, R look recently loaded given name. Since symbol registration now norm, don’t expect cause much trouble. load_all() longer forces bindings namespace avoid lazy-load errors. Instead, removes exported S3 methods relevant tables. improves loading behaviour packages define objects namespaces lazily (e.g. delayedAssign()). also makes load_all() predictable method removed package. now actually removed generic table. previously linger R restarted. load_all() attaches testthat, automatically suppresses conflicts.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-110","dir":"Changelog","previous_headings":"","what":"pkgload 1.1.0","title":"pkgload 1.1.0","text":"CRAN release: 2020-05-29 dev_example() now works removing inconsistent call load_all() (@riccardoporreca, #122). load_all() now issues warning exported objects conflict objects defined global environment (#112) run_example() arguments run test deprecated favor (hopefully) clear run_dontrun run_donttest (#107). Internal fixes compatibility future 4.1.0 release.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-102","dir":"Changelog","previous_headings":"","what":"pkgload 1.0.2","title":"pkgload 1.0.2","text":"CRAN release: 2018-10-29 shim_question() now works topics R base package passed double colon operator (e.g. base::min) (@mdequeljoe, #99). load_all() now allows using explicitly qualified, exported names test helpers (@klmr, #95). load_all() gains compile argument controls finely whether compile code . recompile argument now deprecated removed future version pkgload.","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-101","dir":"Changelog","previous_headings":"","what":"pkgload 1.0.1","title":"pkgload 1.0.1","text":"CRAN release: 2018-10-11 unload() now removes S4 classes generated package unloaded (#75) help() longer error trying load package level help (#67). Trailing slashes now removed paths, fixes issues Windows (#73). load_dll() now fixed R-devel (#77). help shim’s now work ::: inputs (#72).","code":""},{"path":"https://pkgload.r-lib.org/dev/news/index.html","id":"pkgload-100","dir":"Changelog","previous_headings":"","what":"pkgload 1.0.0","title":"pkgload 1.0.0","text":"CRAN release: 2018-07-07 load_all() now updates imports dependent packages package reloaded (#59). load_all() now assigns DESCRIPTION/Depends .Depends object package environment. (@yiufung pkgload#61) load_all() now attaches testthat attach_testthat option TRUE. allows load_all() closely mimic testing environment. (#56) check_dep_version() check_suggested() now exported. check_dep_version() now emits warning returns FALSE rather aborting. (#47) Package imports now exported using load_all(). behavior can disabled using load_all(export_imports = FALSE). .package() .package() functions removed. load_code(), load_data(), load_dll(), load_all(), parse_ns_file() now take explicit path rather path package object. imports_env(), ns_env(), pkg_env() unload() now take package name rather path package object. run_example() now works R 3.1. unload() now unloads S4 classes packages loaded library() well load_all() (#46). load_all() gains helpers option specify whether source testthat helpers. (@pitakakariki devtools #1202) load_all() now sources testthat helpers namespace environment rather package environment (#40). load_all() now sets NOT_CRAN environment variable sources testthat helpers. also sets DEVTOOLS_LOAD “true” can check whether run package loading. dev_topic_path() now returns last path found, fixing error package package function level help name. (#21) New function is_dev_package() determine given package loaded pkgload::load_all() (#2). load_all() longer updates collate directive. Instead functionality moved devtools::document(). dev_help() now optionally takes character vector packages search within. replaces find_topic(). dev_topic_index_reset() now exported, allows reset topic index associated given package. Added NEWS.md file track changes package. Initial release code spun devtools","code":""}]