diff --git a/dev/articles/dependencies.html b/dev/articles/dependencies.html
index 8d4ed3eb9..7c9630e3f 100644
--- a/dev/articles/dependencies.html
+++ b/dev/articles/dependencies.html
@@ -84,7 +84,7 @@
                         <h4 data-toc-skip class="author">Jim Hester,
 Hadley Wickham</h4>
             
-            <h4 data-toc-skip class="date">2024-07-16</h4>
+            <h4 data-toc-skip class="date">2024-07-29</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/r-lib/devtools/blob/main/vignettes/dependencies.Rmd" class="external-link"><code>vignettes/dependencies.Rmd</code></a></small>
       <div class="d-none name"><code>dependencies.Rmd</code></div>
diff --git a/dev/news/index.html b/dev/news/index.html
index 19a713e46..0e2e3cb5b 100644
--- a/dev/news/index.html
+++ b/dev/news/index.html
@@ -50,7 +50,8 @@
 
     <div class="section level2">
 <h2 class="pkg-version" data-toc-text="development version" id="devtools-development-version">devtools (development version)<a class="anchor" aria-label="anchor" href="#devtools-development-version"></a></h2>
-<ul><li><p><code><a href="../reference/test.html">test_coverage()</a></code> now works if the package has not been installed.</p></li>
+<ul><li><p>Functions that use httr now explicitly check that it is installed (<a href="https://github.com/catalamarti" class="external-link">@catalamarti</a>, <a href="https://github.com/r-lib/devtools/issues/2573" class="external-link">#2573</a>).</p></li>
+<li><p><code><a href="../reference/test.html">test_coverage()</a></code> now works if the package has not been installed.</p></li>
 <li><p><code><a href="../reference/test.html">test_coverage_active_file()</a></code> now reports if any tests failed and does a better job of executing snapshot comparisons.</p></li>
 </ul></div>
     <div class="section level2">
diff --git a/dev/pkgdown.yml b/dev/pkgdown.yml
index 1318306e8..5c37375d6 100644
--- a/dev/pkgdown.yml
+++ b/dev/pkgdown.yml
@@ -3,7 +3,7 @@ pkgdown: 2.1.0
 pkgdown_sha: ~
 articles:
   dependencies: dependencies.html
-last_built: 2024-07-16T15:05Z
+last_built: 2024-07-29T14:35Z
 urls:
   reference: https://devtools.r-lib.org/reference
   article: https://devtools.r-lib.org/articles
diff --git a/dev/search.json b/dev/search.json
index 1f438f24b..c2e2795fd 100644
--- a/dev/search.json
+++ b/dev/search.json
@@ -1 +1 @@
-[{"path":[]},{"path":"https://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.r-lib.org/dev/CONTRIBUTING.html","id":"contributing-to-devtools","dir":"","previous_headings":"","what":"Contributing to devtools","title":"NA","text":"goal guide help contribute devtools quickly easily possible. guide divided two main pieces: Filing bug report feature request issue. Suggesting change via pull request.","code":""},{"path":"https://devtools.r-lib.org/dev/CONTRIBUTING.html","id":"issues","dir":"","previous_headings":"","what":"Issues","title":"NA","text":"file issue: Check ’re using latest version devtools. ’s quite possible problem ’re experiencing already fixed. Check issue belongs devtools. Much functionality now lives separate packages. Please read list check submitting issue another repo: Building binary packages anything related finding R tools: pkgbuild: Anything related operation load_all(): pkgload. Running R CMD check one package: rcmdcheck. Running R CMD check reverse dependencies: revdepcheck Installing packages: remotes Session info: sessioninfo function starts use_: usethis Spend minutes looking existing issues. ’s possible issue already filed. ’s almost always better open new issue instead commenting existing issue. exception confident issue identical existing problem, contribution help us better understand general case. ’s generally bad idea comment closed issue commit. comments don’t show issue tracker easily misplaced. filing issue, important thing include minimal reproducible example can quickly verify problem, figure fix . three things need include make example reproducible: required packages, data, code. Packages loaded top script, ’s easy see ones example needs. Unless ’ve specifically asked , please don’t include output sessionInfo() devtools::session_info(). easiest way include data use dput() generate R code recreate . example, recreate mtcars dataset R, ’d perform following steps: Run dput(mtcars) R Copy output reproducible script, type mtcars <- paste. even better can create data.frame() just handful rows columns still illustrates problem. Spend little bit time ensuring code easy others read: make sure ’ve used spaces variable names concise, informative use comments indicate problem lies best remove everything related problem. shorter code , easier understand. Learn little markdown can correctly format issue. important thing surround code ``` R ``` ’s syntax highlighted (makes easier read). Check ’ve actually made reproducible example using reprex package.","code":""},{"path":"https://devtools.r-lib.org/dev/CONTRIBUTING.html","id":"pull-requests","dir":"","previous_headings":"","what":"Pull requests","title":"NA","text":"pull request easiest us read use common style: http://r-pkgs..co.nz/r.html#style. Please pay particular attention whitespace. always add bullet point NEWS.md motivating change. look like “changed (@yourusername, #issuenumber)”. Please don’t add headings like “bug fix” “new features” - added release process. can, also write test. Testing devtools particularly difficult devtools functions called side-effects, best can. ’re adding new parameters new function, ’ll also need document roxygen2. Make sure re-run devtools::document() code submitting. pull request process, unless ’re practiced contributor ’s unlikely pull request accepted . Typically process looks like : submit pull request. review high-level determine something want include package. , ’ll close pull request suggest alternative home code. ’ll take closer look code give feedback. respond feedback, update pull request add comment like “PTAL” (please take look). Adding comment important, otherwise don’t get notification pull request ready review. Don’t worry pull request isn’t perfect. ’s learning process ’ll happy help . can frustrating PR ignored months, request whole bunch changes within short time period. Don’t worry - PR doesn’t make release, next one.","code":""},{"path":"https://devtools.r-lib.org/dev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2023 devtools 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://devtools.r-lib.org/dev/MAINTENANCE.html","id":"current-state","dir":"","previous_headings":"","what":"Current state","title":"NA","text":"Devtools generally stable, active development moved sub-packages like remotes usethis, relatively little code lives devtools .","code":""},{"path":"https://devtools.r-lib.org/dev/MAINTENANCE.html","id":"known-outstanding-issues","dir":"","previous_headings":"","what":"Known outstanding issues","title":"NA","text":"don’t know major outstanding issues devtools .","code":""},{"path":"https://devtools.r-lib.org/dev/MAINTENANCE.html","id":"future-directions","dir":"","previous_headings":"","what":"Future directions","title":"NA","text":"package development cheatsheet likely needs major overhaul account much functionality usethis current state devtools. https://github.com/r-lib/devtools/issues/2107 devtools converted use pak installation, installation commands deprecated devtools users suggested use pak directly?","code":""},{"path":"https://devtools.r-lib.org/dev/MAINTENANCE.html","id":"r-cmd-check-notes","dir":"","previous_headings":"","what":"R CMD check notes","title":"NA","text":"devtools vintage tests around .Rnw vignettes. ’s clear makes sense keep , (jennybc) rushing remove tests. Since inherited maintainership devtools, pursued 2 tests fail locally (skipped GHA). However, today, sort want record . case comes future, caused necessary LaTeX package installed:","code":"tinytex::parse_install(   text = \"! LaTeX Error: File `grfext.sty' not found.\" )"},{"path":"https://devtools.r-lib.org/dev/articles/dependencies.html","id":"package-remotes","dir":"Articles","previous_headings":"","what":"Package remotes","title":"Devtools dependencies","text":"Devtools version 1.9 supports package dependency installation packages yet standard package repository CRAN Bioconductor. can mark regular dependency defined Depends, Imports, Suggests Enhances fields installed remote location adding remote location Remotes DESCRIPTION file. cause devtools download install prior installing package (won’t installed CRAN). remote dependencies specified Remotes described following form. type optional parameter. type missing default install GitHub. Additional remote dependencies separated commas, just like normal dependencies elsewhere DESCRIPTION file. important remember must always declare dependency usual way, .e. include Depends, Imports, Suggests Enhances. Remotes field provides instructions install dependency . example DESCRIPTION file, note rlang appears Imports Remotes:","code":"Remotes: [type::]<Repository>, [type2::]<Repository2> Package: xyz Title: What the Package Does (One Line, Title Case) Version: 0.0.0.9000 Authors@R:      person(given = \"First\",            family = \"Last\",            role = c(\"aut\", \"cre\"),            email = \"first.last@example.com\") Description: What the package does (one paragraph). License: MIT + file LICENSE Imports:      rlang Remotes:       r-lib/rlang"},{"path":"https://devtools.r-lib.org/dev/articles/dependencies.html","id":"github","dir":"Articles","previous_headings":"Package remotes","what":"GitHub","title":"Devtools dependencies","text":"GitHub commonly used unofficial package distribution R, ’s default: can also specify specific hash, tag, pull request (using syntax install_github() want particular commit. Otherwise latest commit HEAD branch used. type github can specified, required","code":"Remotes: hadley/testthat Remotes: hadley/httr@v0.4,   klutometis/roxygen#142,   hadley/testthat@c67018fa4970 Remotes: github::hadley/ggplot2"},{"path":"https://devtools.r-lib.org/dev/articles/dependencies.html","id":"other-sources","dir":"Articles","previous_headings":"Package remotes","what":"Other sources","title":"Devtools dependencies","text":"currently supported install sources available, see ‘See Also’ section ?install complete list.","code":"# GitLab Remotes: gitlab::jimhester/covr  # Git Remotes: git::git@bitbucket.org:djnavarro/lsr.git  # Bitbucket Remotes: bitbucket::sulab/mygene.r@default, djnavarro/lsr  # Bioconductor Remotes: bioc::3.3/SummarizedExperiment#117513, bioc::release/Biobase  # SVN Remotes: svn::https://github.com/tidyverse/stringr  # URL Remotes: url::https://github.com/tidyverse/stringr/archive/main.zip  # Local Remotes: local::/pkgs/testthat  # Gitorious Remotes: gitorious::r-mpc-package/r-mpc-package"},{"path":"https://devtools.r-lib.org/dev/articles/dependencies.html","id":"cran-submission","dir":"Articles","previous_headings":"Package remotes","what":"CRAN submission","title":"Devtools dependencies","text":"submit package CRAN, dependencies must also available CRAN. reason, release() warn try release package Remotes field.","code":""},{"path":"https://devtools.r-lib.org/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Hadley Wickham. Author. Jim Hester. Author. Winston Chang. Author. Jennifer Bryan. Author, maintainer. . Copyright holder, funder.","code":""},{"path":"https://devtools.r-lib.org/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Wickham H, Hester J, Chang W, Bryan J (2024). devtools: Tools Make Developing R Packages Easier. R package version 2.4.5.9000, https://github.com/r-lib/devtools, https://devtools.r-lib.org/.","code":"@Manual{,   title = {devtools: Tools to Make Developing R Packages Easier},   author = {Hadley Wickham and Jim Hester and Winston Chang and Jennifer Bryan},   year = {2024},   note = {R package version 2.4.5.9000, https://github.com/r-lib/devtools},   url = {https://devtools.r-lib.org/}, }"},{"path":"https://devtools.r-lib.org/dev/index.html","id":"devtools-","dir":"","previous_headings":"","what":"Tools to Make Developing R Packages Easier","title":"Tools to Make Developing R Packages Easier","text":"aim devtools make package development easier providing R functions simplify expedite common tasks. R Packages book based around workflow.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Tools to Make Developing R Packages Easier","text":"","code":"# Install devtools from CRAN install.packages(\"devtools\")  # Or the development version from GitHub: # install.packages(\"pak\") pak::pak(\"r-lib/devtools\")"},{"path":[]},{"path":"https://devtools.r-lib.org/dev/index.html","id":"usage","dir":"","previous_headings":"","what":"Usage","title":"Tools to Make Developing R Packages Easier","text":"devtools functions accept path argument, e.g. load_all(\"path//mypkg\"). don’t specify path, devtools look current working directory - recommended practice.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"frequent-development-tasks","dir":"","previous_headings":"Usage","what":"Frequent development tasks:","title":"Tools to Make Developing R Packages Easier","text":"load_all() simulates installing reloading package, loading R code R/, compiled shared objects src/ data files data/. development usually want access functions (even un-exported internal ones) load_all() works functions exported package NAMESPACE. document() updates generated documentation man/, file collation NAMESPACE. test() reloads code load_all(), runs testthat tests. test_coverage() runs test coverage package covr. makes easy see parts package use tests!","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"building-and-installing","dir":"","previous_headings":"Usage","what":"Building and installing:","title":"Tools to Make Developing R Packages Easier","text":"install() reinstalls package, detaches currently loaded version reloads new version library(). Reloading package guaranteed work: see documentation unload() caveats. build() builds package file package sources. can use build binary version package. install_* functions install R package: install_github() GitHub install_gitlab() GitLab install_bitbucket() Bitbucket install_url() arbitrary url install_git() install_svn() arbitrary git SVN repository install_local() local file disk install_version() specific version CRAN update_packages() updates package latest version. works packages installed CRAN well installed install_* functions.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"check-and-release","dir":"","previous_headings":"Usage","what":"Check and release:","title":"Tools to Make Developing R Packages Easier","text":"check() updates documentation, builds checks package locally. check_win() checks package using win-builder, check_rhub() checks package using r-hub. allows easily check package systems CRAN uses submission. release() makes sure everything ok package (including asking number questions), builds uploads CRAN.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"learning-more","dir":"","previous_headings":"","what":"Learning more","title":"Tools to Make Developing R Packages Easier","text":"R package development can intimidating, however now number valuable resources help!  R Packages book gives comprehensive treatment common parts package development uses devtools throughout. first edition available https://r-pkgs.org/, note grown somewhat sync current version devtools. second edition development evolving reflect current state devtools. available https://r-pkgs.org. Whole Game Package structure chapters make great places start. RStudio community - package development great place ask specific questions related package development. rOpenSci packages extensive documentation best practices R packages looking contributed rOpenSci, also useful general recommendations package authors. number fantastic blog posts writing first package, including Writing R package scratch - Hilary Parker develop good R packages - Maëlle Salmon Making first R package - Fong Chun Chan Writing R package scratch - Tomas Westlake Writing R Extensions exhaustive, canonical reference writing R packages, maintained R core developers.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"conscious-uncoupling","dir":"","previous_headings":"","what":"Conscious uncoupling","title":"Tools to Make Developing R Packages Easier","text":"devtools started lean--mean package facilitate local package development, years accumulated functionality. devtools undergone conscious uncoupling split functionality smaller, tightly focussed packages. includes: testthat: Writing running tests (.e. test()). roxygen2: Function package documentation (.e. document()). remotes: Installing packages (.e. install_github()). pkgbuild: Building binary packages (including checking build tools available) (.e. build()). pkgload: Simulating package loading (.e. load_all()). rcmdcheck: Running R CMD check reporting results (.e. check()). revdepcheck: Running R CMD check reverse dependencies, figuring ’s changed since last CRAN release (.e. revdep_check()). sessioninfo: R session info (.e. session_info()). usethis: Automating package setup (.e. use_test()). Generally, need worry different packages, devtools installs automatically. need care, however, ’re filing bug reporting correct place lead speedier resolution. may also need care trying use devtools functionality package deployed application. Generally cases better depend particular package directly rather depend devtools, e.g. use sessioninfo::session_info() rather devtools::session_info(), remotes::install_github() vs devtools::install_github(). However day day development recommend continue use library(devtools) quickly load needed development tools, just like library(tidyverse) quickly loads tools necessary data exploration visualization.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"code-of-conduct","dir":"","previous_headings":"","what":"Code of conduct","title":"Tools to Make Developing R Packages Easier","text":"Please note devtools project released Contributor Code Conduct. contributing project, agree abide terms.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/as.package.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerce input to a package. — as.package","title":"Coerce input to a package. — as.package","text":"Possible specifications package: path package object","code":""},{"path":"https://devtools.r-lib.org/dev/reference/as.package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerce input to a package. — as.package","text":"","code":"as.package(x = NULL, create = deprecated())"},{"path":"https://devtools.r-lib.org/dev/reference/as.package.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerce input to a package. — as.package","text":"x object coerce package create worked time.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/bash.html","id":null,"dir":"Reference","previous_headings":"","what":"Open bash shell in package directory. — bash","title":"Open bash shell in package directory. — bash","text":"Open bash shell package directory.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/bash.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Open bash shell in package directory. — bash","text":"","code":"bash(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/bash.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Open bash shell in package directory. — bash","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":null,"dir":"Reference","previous_headings":"","what":"Build package — build","title":"Build package — build","text":"Building converts package source directory single bundled file. binary = FALSE creates tar.gz package can installed platform, provided full development environment (although packages without source code can typically installed box). binary = TRUE, package platform specific extension (e.g. .zip windows), installable current platform, development environment needed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build package — build","text":"","code":"build(   pkg = \".\",   path = NULL,   binary = FALSE,   vignettes = TRUE,   manual = FALSE,   args = NULL,   quiet = FALSE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build package — build","text":"pkg package use, can file path package package object.  See .package() information. path Path produce package.  NULL, defaults parent directory package. binary Produce binary (--binary) source ( ---manual ---resave-data) version package. vignettes, manual source packages: FALSE, build PDF vignettes (---build-vignettes) manual (---manual). args optional character vector additional command line arguments passed R CMD build binary = FALSE, R CMD install binary = TRUE. quiet TRUE suppresses output function. ... Additional arguments passed pkgbuild::build.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Build package — build","text":"string giving location (including file name) built package","code":""},{"path":[]},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"description-entries","dir":"Reference","previous_headings":"","what":"DESCRIPTION entries","title":"Build package — build","text":"Config/build/clean-inst-doc can set FALSE avoid cleaning inst/doc building source package. Set TRUE force cleanup. See clean_doc argument. Config/build/copy-method can used avoid copying large directories R CMD build. works copying (linking) files package temporary directory, leaving (possibly large) files part package. Possible values: none: pkgbuild copy package tree. default. copy: package files copied temporary directory  R CMD build. link: package files symbolic linked temporary directory R CMD build. Windows symbolic links, Windows equivalent copy. can also use pkg.build_copy_method option PKG_BUILD_COPY_METHOD environment variable set copy method. option consulted first, DESCRIPTION entry, environment variable. Config/build/extra-sources can used define extra source files pkgbuild decide whether package DLL needs recompiled needs_compile(). syntax comma separated list file names, globs. (See utils::glob2rx().) E.g. src/rust/src/*.rs configure*. Config/build/bootstrap can set TRUE run Rscript bootstrap.R source directory prior running subsequent build steps.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"options","dir":"Reference","previous_headings":"","what":"Options","title":"Build package — build","text":"pkg.build_copy_method: use option avoid copying large directories building package. See possible values , Config/build/copy-method DESCRIPTION entry. pkg.build_stop_for_warnings: set TRUE, pkgbuild stop R CMD build errors. takes precedence PKG_BUILD_STOP_FOR_WARNINGS environment variable.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"environment-variables","dir":"Reference","previous_headings":"","what":"Environment variables","title":"Build package — build","text":"PKG_BUILD_COLOR_DIAGNOSTICS: set false opt colored compiler diagnostics. Set true force colored compiler diagnostics. PKG_BUILD_COPY_METHOD: use environment variable avoid copying large directories building package. See possible values , Config/build/copy-method DESCRIPTION entry. stop R CMD build errors. pkg.build_stop_for_warnings option takes precedence environment variable.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Build package — build","text":"default manual = FALSE suitable CRAN submission, may require manual = TRUE.  Even better, use submit_cran() release().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_manual.html","id":null,"dir":"Reference","previous_headings":"","what":"Create package pdf manual — build_manual","title":"Create package pdf manual — build_manual","text":"Create package pdf manual","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_manual.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create package pdf manual — build_manual","text":"","code":"build_manual(pkg = \".\", path = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/build_manual.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create package pdf manual — build_manual","text":"pkg package use, can file path package package object.  See .package() information. path path produce package manual. NULL, defaults parent directory package.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/build_rmd.html","id":null,"dir":"Reference","previous_headings":"","what":"Build a Rmarkdown files package — build_rmd","title":"Build a Rmarkdown files package — build_rmd","text":"build_rmd() wrapper around rmarkdown::render() first installs temporary copy package, renders .Rmd clean R session. build_readme() locates README.Rmd builds README.md","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_rmd.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build a Rmarkdown files package — build_rmd","text":"","code":"build_rmd(files, path = \".\", output_options = list(), ..., quiet = TRUE)  build_readme(path = \".\", quiet = TRUE, ...)"},{"path":"https://devtools.r-lib.org/dev/reference/build_rmd.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build a Rmarkdown files package — build_rmd","text":"files Rmarkdown files rendered. path path package build readme. output_options List output options can override options specified metadata (e.g. used force self_contained mathjax = \"local\"). Note valid output format read metadata (.e. custom format object passed output_format). ... additional arguments passed rmarkdown::render() quiet TRUE, suppress output.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_site.html","id":null,"dir":"Reference","previous_headings":"","what":"Execute pkgdown build_site in a package — build_site","title":"Execute pkgdown build_site in a package — build_site","text":"build_site() shortcut pkgdown::build_site(), generates static HTML documentation.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_site.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Execute pkgdown build_site in a package — build_site","text":"","code":"build_site(path = \".\", quiet = TRUE, ...)"},{"path":"https://devtools.r-lib.org/dev/reference/build_site.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Execute pkgdown build_site in a package — build_site","text":"path path package build static HTML. quiet TRUE, suppress output. ... additional arguments passed pkgdown::build_site()","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_vignettes.html","id":null,"dir":"Reference","previous_headings":"","what":"Build package vignettes. — build_vignettes","title":"Build package vignettes. — build_vignettes","text":"Builds package vignettes using algorithm R CMD build . means including non-Sweave vignettes, using makefiles (present), copying extra files. files copied 'doc' directory vignette index created 'Meta/vignette.rds', built package. 'doc' 'Meta' added .Rbuildignore, included built package. files can checked version control, can viewed browseVignettes() vignette() package loaded load_all() without needing re-build locally.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_vignettes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build package vignettes. — build_vignettes","text":"","code":"build_vignettes(   pkg = \".\",   dependencies = \"VignetteBuilder\",   clean = TRUE,   upgrade = \"never\",   quiet = FALSE,   install = TRUE,   keep_md = TRUE )"},{"path":"https://devtools.r-lib.org/dev/reference/build_vignettes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build package vignettes. — build_vignettes","text":"pkg package use, can file path package package object.  See .package() information. dependencies dependencies want check? Can character vector (selecting \"Depends\", \"Imports\", \"LinkingTo\", \"Suggests\", \"Enhances\"), logical vector. TRUE shorthand \"Depends\", \"Imports\", \"LinkingTo\" \"Suggests\". NA shorthand \"Depends\", \"Imports\" \"LinkingTo\" default. FALSE shorthand dependencies (.e. just check package, dependencies). value \"soft\" means TRUE, \"hard\" means NA. can also specify dependencies one additional fields, common ones include: Config/Needs/website - dependencies used building pkgdown site. Config/Needs/coverage dependencies used calculating test coverage. clean Remove files generated build, even     copies . upgrade package dependencies upgraded? One \"default\", \"ask\", \"always\", \"never\". \"default\" respects value R_REMOTES_UPGRADE environment variable set, falls back \"ask\" unset. \"ask\" prompts user date packages upgrade. non-interactive sessions \"ask\" equivalent \"always\". TRUE FALSE also accepted correspond \"always\" \"never\" respectively. quiet TRUE, suppresses output. Set FALSE need debug. install TRUE, install package building vignettes. keep_md TRUE, move md intermediates well rendered outputs. useful using keep_md YAML option Rmarkdown outputs. See https://bookdown.org/yihui/rmarkdown/html-document.html#keeping-markdown.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":null,"dir":"Reference","previous_headings":"","what":"Build and check a package — check","title":"Build and check a package — check","text":"check() automatically builds checks source package, using known best practices. check_built() checks already-built package. Passing R CMD check essential want submit package CRAN: must ERRORs WARNINGs, want ensure NOTEs possible.  submitting CRAN, least ensure ERRORs WARNINGs: typically represent serious problems. check() automatically builds package calling check_built(), recommended way check packages.  Note process runs independent R session, nothing current workspace affect process. --hood, check() check_built() rely pkgbuild::build() rcmdcheck::rcmdcheck().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build and check a package — check","text":"","code":"check(   pkg = \".\",   document = NULL,   build_args = NULL,   ...,   manual = FALSE,   cran = TRUE,   remote = FALSE,   incoming = remote,   force_suggests = FALSE,   run_dont_test = FALSE,   args = \"--timings\",   env_vars = c(NOT_CRAN = \"true\"),   quiet = FALSE,   check_dir = NULL,   cleanup = deprecated(),   vignettes = TRUE,   error_on = c(\"never\", \"error\", \"warning\", \"note\") )  check_built(   path = NULL,   cran = TRUE,   remote = FALSE,   incoming = remote,   force_suggests = FALSE,   run_dont_test = FALSE,   manual = FALSE,   args = \"--timings\",   env_vars = NULL,   check_dir = tempdir(),   quiet = FALSE,   error_on = c(\"never\", \"error\", \"warning\", \"note\") )"},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build and check a package — check","text":"pkg package use, can file path package package object.  See .package() information. document default (NULL) document installed roxygen2 version matches version declared DESCRIPTION file. Use TRUE FALSE override default. build_args Additional arguments passed R CMD build ... Additional arguments passed pkgbuild::build(). manual FALSE, build check manual (---manual). cran TRUE (default), check using settings CRAN uses. moving target uniform across CRAN's machine, \"best effort\" basis. complicated simply setting ---cran. remote Sets _R_CHECK_CRAN_INCOMING_REMOTE_ env var. TRUE, performs number CRAN incoming checks require remote access. incoming Sets _R_CHECK_CRAN_INCOMING_ env var. TRUE, performs number CRAN incoming checks. force_suggests Sets _R_CHECK_FORCE_SUGGESTS_. FALSE (default), check proceed even suggested packages found. run_dont_test Sets --run-donttest examples surrounded \\donttest{} also run. cran = TRUE, affects R 3.6 earlier; R 4.0, code \\donttest{} always run part CRAN submission. args Character vector arguments pass R CMD check. Pass argument single element character vector (use spaces delimit arguments like shell). example, skip running examples tests, use args = c(\"---examples\", \"---tests\") args = \"---examples ---tests\". (Note instead --output option use check_dir argument,  --output deal spaces special characters Windows.) env_vars Environment variables set R CMD check quiet TRUE suppresses output function. check_dir Path directory check performed. NULL, temporary directory used, cleaned returned object garbage collected. cleanup See check_dir details. vignettes FALSE, build check vignettes, equivalent using args = '--ignore-vignettes' build_args = '–-build-vignettes'. error_on Whether throw error R CMD check failures. Note check always completed (unless timeout happens), error thrown completion. error_on passed rcmdcheck::rcmdcheck(), definitive source different values mean. specified user, check() check_built() default error_on = \"never\" interactive use \"warning\" non-interactive setting. path Path built package.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Build and check a package — check","text":"object containing errors, warnings, notes, .","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":"environment-variables","dir":"Reference","previous_headings":"","what":"Environment variables","title":"Build and check a package — check","text":"Devtools best set environment combines best practices check works CRAN. includes: standard environment variables set devtools: r_env_vars(). particular note package tests NOT_CRAN env var, lets know tests running somewhere CRAN, hence can take reasonable amount time. Debugging flags compiler, set compiler_flags(FALSE). aspell found, _R_CHECK_CRAN_INCOMING_USE_ASPELL_ set TRUE. spell checker installed, warning issued. Environment variables, controlled arguments incoming, remote force_suggests.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/check_mac_release.html","id":null,"dir":"Reference","previous_headings":"","what":"Check a package on macOS — check_mac_release","title":"Check a package on macOS — check_mac_release","text":"function first bundles source package, uploads https://mac.r-project.org/macbuilder/submit.html. function returns link page check results appear.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_mac_release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check a package on macOS — check_mac_release","text":"","code":"check_mac_release(   pkg = \".\",   dep_pkgs = character(),   args = NULL,   manual = TRUE,   quiet = FALSE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/check_mac_release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check a package on macOS — check_mac_release","text":"pkg package use, can file path package package object.  See .package() information. dep_pkgs Additional custom dependencies install prior checking package. args optional character vector additional command line arguments passed R CMD build binary = FALSE, R CMD install binary = TRUE. manual manual built? quiet TRUE, suppresses output. ... Additional arguments passed pkgbuild::build().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_mac_release.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check a package on macOS — check_mac_release","text":"url check results (invisibly)","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":null,"dir":"Reference","previous_headings":"","what":"Check documentation, as R CMD check does. — check_man","title":"Check documentation, as R CMD check does. — check_man","text":"function attempts run documentation related checks way R CMD check . Unfortunately run tests require package loaded, way attempt load code conflicts devtools .","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check documentation, as R CMD check does. — check_man","text":"","code":"check_man(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check documentation, as R CMD check does. — check_man","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check documentation, as R CMD check does. — check_man","text":"Nothing. function called purely side effects: errors output.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check documentation, as R CMD check does. — check_man","text":"","code":"if (FALSE) { # \\dontrun{ check_man(\"mypkg\") } # }"},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":null,"dir":"Reference","previous_headings":"","what":"Run CRAN checks for package on R-hub — check_rhub","title":"Run CRAN checks for package on R-hub — check_rhub","text":"runs build() package, arguments specified args, submits R-hub builder https://builder.r-hub.io. interactive option controls whether function waits check output. Regardless, check complete, R-hub sends email results package maintainer.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run CRAN checks for package on R-hub — check_rhub","text":"","code":"check_rhub(   pkg = \".\",   platforms = NULL,   email = NULL,   interactive = TRUE,   build_args = NULL,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run CRAN checks for package on R-hub — check_rhub","text":"pkg package use, can file path package package object.  See .package() information. platforms R-hub platforms run check . NULL uses default list CRAN checkers (one major platform, one extra checks compiled code). can also specify , see rhub::platforms() complete list. email email address notify, defaults maintainer address package. interactive whether show status build interactively. R-hub send email package maintainer's email address, regardless whether check interactive . build_args Arguments passed R CMD build ... extra arguments, passed rhub::check_for_cran().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Run CRAN checks for package on R-hub — check_rhub","text":"rhub_check object.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":"about-email-validation-on-r-hub","dir":"Reference","previous_headings":"","what":"About email validation on r-hub","title":"Run CRAN checks for package on R-hub — check_rhub","text":"build check R packages R-hub, need validate email address. R-hub sends emails build results. See rhub::validate_email().","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/check_win.html","id":null,"dir":"Reference","previous_headings":"","what":"Check a package on Windows — check_win","title":"Check a package on Windows — check_win","text":"function first bundles source package, uploads https://win-builder.r-project.org/. service built checked package, email sent address maintainer listed DESCRIPTION. usually takes around 30 minutes. email contains link directory package binary check logs, deleted couple days.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_win.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check a package on Windows — check_win","text":"","code":"check_win_devel(   pkg = \".\",   args = NULL,   manual = TRUE,   email = NULL,   quiet = FALSE,   ... )  check_win_release(   pkg = \".\",   args = NULL,   manual = TRUE,   email = NULL,   quiet = FALSE,   ... )  check_win_oldrelease(   pkg = \".\",   args = NULL,   manual = TRUE,   email = NULL,   quiet = FALSE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/check_win.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check a package on Windows — check_win","text":"pkg package use, can file path package package object.  See .package() information. args optional character vector additional command line arguments passed R CMD build binary = FALSE, R CMD install binary = TRUE. manual manual built? email alternative email address use. NULL, default use package maintainer's email. quiet TRUE, suppresses output. ... Additional arguments passed pkgbuild::build().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_win.html","id":"functions","dir":"Reference","previous_headings":"","what":"Functions","title":"Check a package on Windows — check_win","text":"check_win_devel(): Check package development version R. check_win_release(): Check package released version R. check_win_oldrelease(): Check package previous major release version R.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/clean_vignettes.html","id":null,"dir":"Reference","previous_headings":"","what":"Clean built vignettes. — clean_vignettes","title":"Clean built vignettes. — clean_vignettes","text":"uses fairly rudimentary algorithm files doc name exists vignettes removed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/clean_vignettes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Clean built vignettes. — clean_vignettes","text":"","code":"clean_vignettes(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/clean_vignettes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Clean built vignettes. — clean_vignettes","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/create.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a package — create","title":"Create a package — create","text":"Create package","code":""},{"path":"https://devtools.r-lib.org/dev/reference/create.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a package — create","text":"","code":"create(path, ..., open = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/create.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a package — create","text":"path path. exists, used. exist, created, provided parent path exists. ... Additional arguments passed usethis::create_package() open TRUE, activates new project: using RStudio desktop, package opened new session. RStudio server, current RStudio project activated. Otherwise, working directory active project changed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/create.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a package — create","text":"path created package, invisibly.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_mode.html","id":null,"dir":"Reference","previous_headings":"","what":"Activate and deactivate development mode — dev_mode","title":"Activate and deactivate development mode — dev_mode","text":"longer recommend dev_mode() removed future release devtools. Instead, now rely load_all() test drive -development package. really like idea corralling experimental packages special library, might enjoy withr::local_libpaths(). concerned different projects interfering use shared library, consider using renv package. Original description: activated, dev_mode creates new library storing installed packages. new library automatically created dev_mode activated already exist. allows test development packages sandbox, without interfering packages installed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_mode.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Activate and deactivate development mode — dev_mode","text":"","code":"dev_mode(on = NULL, path = getOption(\"devtools.path\"))"},{"path":"https://devtools.r-lib.org/dev/reference/dev_mode.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Activate and deactivate development mode — dev_mode","text":"turn dev mode (TRUE) (FALSE).  omitted guess based whether path .libPaths() path directory library.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_mode.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Activate and deactivate development mode — dev_mode","text":"","code":"if (FALSE) { # \\dontrun{ dev_mode() dev_mode() } # }"},{"path":"https://devtools.r-lib.org/dev/reference/dev_packages.html","id":null,"dir":"Reference","previous_headings":"","what":"Return a vector of names of packages loaded by devtools — dev_packages","title":"Return a vector of names of packages loaded by devtools — dev_packages","text":"Return vector names packages loaded devtools","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_packages.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return a vector of names of packages loaded by devtools — dev_packages","text":"","code":"dev_packages()"},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":null,"dir":"Reference","previous_headings":"","what":"Report package development situation — dev_sitrep","title":"Report package development situation — dev_sitrep","text":"dev_sitrep() reports R date RStudio date compiler build tools installed available use devtools dependencies date package's dependencies date Call function things seem weird sure wrong fix . function returns output everything ready package development.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Report package development situation — dev_sitrep","text":"","code":"dev_sitrep(pkg = \".\", debug = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Report package development situation — dev_sitrep","text":"pkg package use, can file path package package object.  See .package() information. debug TRUE, print extra information useful debugging. FALSE, use result cached previous run.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Report package development situation — dev_sitrep","text":"named list, S3 class dev_sitrep (printing purposes).","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Report package development situation — dev_sitrep","text":"","code":"if (FALSE) { # \\dontrun{ dev_sitrep() } # }"},{"path":"https://devtools.r-lib.org/dev/reference/devtools-deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"Deprecated Functions — test_file","title":"Deprecated Functions — test_file","text":"functions Deprecated release devtools, marked Defunct removed future version.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/devtools-deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deprecated Functions — test_file","text":"","code":"test_file(file = find_active_file(), ...)  test_coverage_file(file = find_active_file(), ...)"},{"path":"https://devtools.r-lib.org/dev/reference/devtools-package.html","id":null,"dir":"Reference","previous_headings":"","what":"devtools: Tools to Make Developing R Packages Easier — devtools-package","title":"devtools: Tools to Make Developing R Packages Easier — devtools-package","text":"Collection package development tools.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/devtools-package.html","id":"package-options","dir":"Reference","previous_headings":"","what":"Package options","title":"devtools: Tools to Make Developing R Packages Easier — devtools-package","text":"Devtools uses following options() configure behaviour: devtools.install.args: string giving extra arguments passed R CMD install install(). devtools.path: Deprecated. Path used now-deprecated dev_mode() function.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/devtools-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"devtools: Tools to Make Developing R Packages Easier — devtools-package","text":"Maintainer: Jennifer Bryan jenny@posit.co (ORCID) Authors: Hadley Wickham Jim Hester Winston Chang contributors: Posit Software, PBC [copyright holder, funder]","code":""},{"path":"https://devtools.r-lib.org/dev/reference/document.html","id":null,"dir":"Reference","previous_headings":"","what":"Use roxygen to document a package. — document","title":"Use roxygen to document a package. — document","text":"function wrapper roxygen2::roxygenize() function roxygen2 package. See documentation vignettes package learn use roxygen.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/document.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use roxygen to document a package. — document","text":"","code":"document(pkg = \".\", roclets = NULL, quiet = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/document.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use roxygen to document a package. — document","text":"pkg package use, can file path package package object.  See .package() information. roclets Character vector roclet names use package. default, NULL, uses roxygen roclets option, defaults c(\"collate\", \"namespace\", \"rd\"). quiet TRUE suppresses output function.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/git_checks.html","id":null,"dir":"Reference","previous_headings":"","what":"Git checks. — git_checks","title":"Git checks. — git_checks","text":"function performs Git checks checks prior release. called automatically release().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/git_checks.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Git checks. — git_checks","text":"","code":"git_checks(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/git_checks.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Git checks. — git_checks","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.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://devtools.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://devtools.r-lib.org/dev/reference/install.html","id":null,"dir":"Reference","previous_headings":"","what":"Install a local development package. — install","title":"Install a local development package. — install","text":"Uses R CMD INSTALL install package. also try install dependencies package CRAN, already installed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/install.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Install a local development package. — install","text":"","code":"install(   pkg = \".\",   reload = TRUE,   quick = FALSE,   build = !quick,   args = getOption(\"devtools.install.args\"),   quiet = FALSE,   dependencies = NA,   upgrade = \"default\",   build_vignettes = FALSE,   keep_source = getOption(\"keep.source.pkgs\"),   force = FALSE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/install.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Install a local development package. — install","text":"pkg package use, can file path package package object.  See .package() information. reload TRUE (default), automatically reload package installing. quick TRUE skips docs, multiple-architectures, demos, vignettes, make installation fast possible. build TRUE pkgbuild::build()s package first: ensures installation completely clean, prevents binary artefacts (like .o, .) appearing local package directory, considerably slower, every compile start scratch. args optional character vector additional command line arguments passed R CMD INSTALL. defaults value option \"devtools.install.args\". quiet TRUE, suppress output. dependencies dependencies want check? Can character vector (selecting \"Depends\", \"Imports\", \"LinkingTo\", \"Suggests\", \"Enhances\"), logical vector. TRUE shorthand \"Depends\", \"Imports\", \"LinkingTo\" \"Suggests\". NA shorthand \"Depends\", \"Imports\" \"LinkingTo\" default. FALSE shorthand dependencies (.e. just check package, dependencies). value \"soft\" means TRUE, \"hard\" means NA. can also specify dependencies one additional fields, common ones include: Config/Needs/website - dependencies used building pkgdown site. Config/Needs/coverage dependencies used calculating test coverage. upgrade package dependencies upgraded? One \"default\", \"ask\", \"always\", \"never\". \"default\" respects value R_REMOTES_UPGRADE environment variable set, falls back \"ask\" unset. \"ask\" prompts user date packages upgrade. non-interactive sessions \"ask\" equivalent \"always\". TRUE FALSE also accepted correspond \"always\" \"never\" respectively. build_vignettes TRUE, build vignettes. Normally build responsible creating vignettes; argument makes sure vignettes built even build never happens (.e. build = FALSE). keep_source TRUE keep srcrefs installed package. useful debugging (especially inside RStudio). defaults option \"keep.source.pkgs\". force Force installation, even remote state changed since previous install. ... additional arguments passed remotes::install_deps() installing dependencies.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/install.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Install a local development package. — install","text":"quick = TRUE, installation takes place using current package directory. compiled code, means artefacts compilation created src/ directory. want avoid , can use build = TRUE first build package bundle install temporary directory. slower, keeps source directory pristine. package loaded, reloaded installation. always completely possible, see reload() caveats. install package non-default library, use withr::with_libpaths().","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/install_deps.html","id":null,"dir":"Reference","previous_headings":"","what":"Install package dependencies if needed. — install_deps","title":"Install package dependencies if needed. — install_deps","text":"install_deps() install user dependencies needed run package, install_dev_deps() also install development dependencies needed test build package.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/install_deps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Install package dependencies if needed. — install_deps","text":"","code":"install_deps(   pkg = \".\",   dependencies = NA,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \" --no-build-vignettes\"),   ... )  install_dev_deps(   pkg = \".\",   dependencies = TRUE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \" --no-build-vignettes\"),   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/install_deps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Install package dependencies if needed. — install_deps","text":"pkg package use, can file path package package object.  See .package() information. dependencies dependencies want check? Can character vector (selecting \"Depends\", \"Imports\", \"LinkingTo\", \"Suggests\", \"Enhances\"), logical vector. TRUE shorthand \"Depends\", \"Imports\", \"LinkingTo\" \"Suggests\". NA shorthand \"Depends\", \"Imports\" \"LinkingTo\" default. FALSE shorthand dependencies (.e. just check package, dependencies). value \"soft\" means TRUE, \"hard\" means NA. can also specify dependencies one additional fields, common ones include: Config/Needs/website - dependencies used building pkgdown site. Config/Needs/coverage dependencies used calculating test coverage. repos character vector giving repositories use. type Type package update. upgrade package dependencies upgraded? One \"default\", \"ask\", \"always\", \"never\". \"default\" respects value R_REMOTES_UPGRADE environment variable set, falls back \"ask\" unset. \"ask\" prompts user date packages upgrade. non-interactive sessions \"ask\" equivalent \"always\". TRUE FALSE also accepted correspond \"always\" \"never\" respectively. quiet TRUE, suppress output. build TRUE pkgbuild::build()s package first: ensures installation completely clean, prevents binary artefacts (like .o, .) appearing local package directory, considerably slower, every compile start scratch. build_opts Options pass R CMD build, used build TRUE. ... additional arguments passed remotes::install_deps() installing dependencies.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/install_deps.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Install package dependencies if needed. — install_deps","text":"","code":"if (FALSE) install_deps(\".\") # \\dontrun{}"},{"path":"https://devtools.r-lib.org/dev/reference/is.package.html","id":null,"dir":"Reference","previous_headings":"","what":"Is the object a package? — is.package","title":"Is the object a package? — is.package","text":"object package?","code":""},{"path":"https://devtools.r-lib.org/dev/reference/is.package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is the object a package? — is.package","text":"","code":"is.package(x)"},{"path":"https://devtools.r-lib.org/dev/reference/lint.html","id":null,"dir":"Reference","previous_headings":"","what":"Lint all source files in a package — lint","title":"Lint all source files in a package — lint","text":"default linters correspond style guide https://style.tidyverse.org/, however possible override using linters parameter.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/lint.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Lint all source files in a package — lint","text":"","code":"lint(pkg = \".\", cache = TRUE, ...)"},{"path":"https://devtools.r-lib.org/dev/reference/lint.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Lint all source files in a package — lint","text":"pkg package use, can file path package package object.  See .package() information. cache Store lint results repeated lints content use previous results. Consult lintr package learn caching behaviour. ... Additional arguments passed lintr::lint_package().","code":""},{"path":[]},{"path":"https://devtools.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.","code":""},{"path":"https://devtools.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,   recompile = FALSE,   export_all = TRUE,   helpers = TRUE,   quiet = FALSE,   ... )"},{"path":"https://devtools.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 clear package environment reset file cache loading pieces package. largely equivalent running unload(), however old namespaces completely removed .onUnload() hooks called. Use reset = FALSE may faster large code bases, significantly less accurate approximation. recompile DEPRECATED. force recompile DLL source code, present. equivalent running pkgbuild::clean_dll() load_all() export_all TRUE (default), export objects. FALSE, export objects listed exports NAMESPACE file. helpers TRUE loads testthat test helpers. quiet TRUE suppresses output function. ... Additional arguments passed pkgload::load_all().","code":""},{"path":"https://devtools.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://devtools.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 reset=TRUE, unload and reload the package for a clean start load_all(\"./\", TRUE)  # With export_all=FALSE, only objects listed as exports in NAMESPACE # are exported load_all(\"./\", export_all = FALSE) } # }"},{"path":"https://devtools.r-lib.org/dev/reference/loaded_packages.html","id":null,"dir":"Reference","previous_headings":"","what":"Return a vector of names of attached packages — loaded_packages","title":"Return a vector of names of attached packages — loaded_packages","text":"Return vector names attached packages","code":""},{"path":"https://devtools.r-lib.org/dev/reference/loaded_packages.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return a vector of names of attached packages — loaded_packages","text":"","code":"loaded_packages()"},{"path":"https://devtools.r-lib.org/dev/reference/loaded_packages.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Return a vector of names of attached packages — loaded_packages","text":"data frame columns package path, giving name package path loaded .","code":""},{"path":"https://devtools.r-lib.org/dev/reference/missing_s3.html","id":null,"dir":"Reference","previous_headings":"","what":"Find missing s3 exports. — missing_s3","title":"Find missing s3 exports. — missing_s3","text":"method heuristic - looking objs period name.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/missing_s3.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find missing s3 exports. — missing_s3","text":"","code":"missing_s3(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/missing_s3.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find missing s3 exports. — missing_s3","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.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 walking path finds root directory, .e. directory containing DESCRIPTION. find root directory, find specified path, throw error.","code":""},{"path":"https://devtools.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://devtools.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://devtools.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://devtools.r-lib.org/dev/reference/r_env_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Environment variables to set when calling R — r_env_vars","title":"Environment variables to set when calling R — r_env_vars","text":"Devtools sets number environmental variables ensure consistent current R session new session, ensure everything behaves across systems. also suppresses common warning windows, sets NOT_CRAN can tell code running CRAN. NOT_CRAN set externally, overwritten.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/r_env_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Environment variables to set when calling R — r_env_vars","text":"","code":"r_env_vars()"},{"path":"https://devtools.r-lib.org/dev/reference/r_env_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Environment variables to set when calling R — r_env_vars","text":"named character vector","code":""},{"path":"https://devtools.r-lib.org/dev/reference/reexports.html","id":null,"dir":"Reference","previous_headings":"","what":"Objects exported from other packages — reexports","title":"Objects exported from other packages — reexports","text":"objects imported packages. Follow links see documentation. pkgbuild clean_dll, find_rtools, has_devel, with_debug pkgload check_dep_version, parse_deps, unload remotes github_pull, github_release sessioninfo package_info, session_info","code":""},{"path":"https://devtools.r-lib.org/dev/reference/release.html","id":null,"dir":"Reference","previous_headings":"","what":"Release package to CRAN. — release","title":"Release package to CRAN. — release","text":"Run automated manual tests, post package CRAN.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Release package to CRAN. — release","text":"","code":"release(pkg = \".\", check = FALSE, args = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Release package to CRAN. — release","text":"pkg package use, can file path package package object.  See .package() information. check TRUE, run checking, otherwise omit .  useful just checked package ready release . args optional character vector additional command line arguments passed R CMD build.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Release package to CRAN. — release","text":"package release process : Confirm package passes R CMD check relevant platforms Confirm important files --date Build package Submit package CRAN, using comments \"cran-comments.md\" can add arbitrary extra questions defining (un-exported) function called release_questions() returns character vector additional questions ask. also need read CRAN repository policy 'https://cran.r-project.org/web/packages/policies.html' make sure line policies. release tries automate many polices possible, impossible completely comprehensive, change releases devtools.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/release_checks.html","id":null,"dir":"Reference","previous_headings":"","what":"Custom devtools release checks. — release_checks","title":"Custom devtools release checks. — release_checks","text":"function performs additional checks prior release. called automatically release().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/release_checks.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Custom devtools release checks. — release_checks","text":"","code":"release_checks(pkg = \".\", built_path = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/release_checks.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Custom devtools release checks. — release_checks","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/reload.html","id":null,"dir":"Reference","previous_headings":"","what":"Unload and reload package. — reload","title":"Unload and reload package. — reload","text":"attempts unload reload installed package. package loaded already, nothing. always possible cleanly unload package: see caveats unload() potential failure points. doubt, restart R reload package library().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/reload.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Unload and reload package. — reload","text":"","code":"reload(pkg = \".\", quiet = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/reload.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Unload and reload package. — reload","text":"pkg package use, can file path package package object.  See .package() information. quiet TRUE suppresses output function.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/reload.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Unload and reload package. — reload","text":"","code":"if (FALSE) { # \\dontrun{ # Reload package that is in current directory reload(\".\")  # Reload package that is in ./ggplot2/ reload(\"ggplot2/\")  # Can use inst() to find the package path # This will reload the installed ggplot2 package reload(pkgload::inst(\"ggplot2\")) } # }"},{"path":"https://devtools.r-lib.org/dev/reference/remote-reexports.html","id":null,"dir":"Reference","previous_headings":"","what":"Functions re-exported from the remotes package — remote-reexports","title":"Functions re-exported from the remotes package — remote-reexports","text":"functions re-exported remotes package. differ ones devtools use ellipsis package ensure dotted arguments used.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/remote-reexports.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Functions re-exported from the remotes package — remote-reexports","text":"","code":"install_bioc(   repo,   mirror = getOption(\"BioC_git\", download_url(\"git.bioconductor.org/packages\")),   git = c(\"auto\", \"git2r\", \"external\"),   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_bitbucket(   repo,   ref = \"HEAD\",   subdir = NULL,   auth_user = bitbucket_user(),   password = bitbucket_password(),   host = \"api.bitbucket.org/2.0\",   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_cran(   pkgs,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   ... )  install_dev(package, cran_url = getOption(\"repos\")[[\"CRAN\"]], ...)  install_git(   url,   subdir = NULL,   ref = NULL,   branch = NULL,   credentials = git_credentials(),   git = c(\"auto\", \"git2r\", \"external\"),   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_github(   repo,   ref = \"HEAD\",   subdir = NULL,   auth_token = github_pat(quiet),   host = \"api.github.com\",   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_gitlab(   repo,   subdir = NULL,   auth_token = gitlab_pat(quiet),   host = \"gitlab.com\",   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_local(   path = \".\",   subdir = NULL,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = !is_binary_pkg(path),   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_svn(   url,   subdir = NULL,   args = character(0),   revision = NULL,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_url(   url,   subdir = NULL,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_version(   package,   version = NULL,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = FALSE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = \"source\",   ... )  update_packages(   packages = TRUE,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  dev_package_deps(   pkgdir = \".\",   dependencies = NA,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\") )"},{"path":"https://devtools.r-lib.org/dev/reference/remote-reexports.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Functions re-exported from the remotes package — remote-reexports","text":"Follow links see documentation. remotes::install_bioc(), remotes::install_bitbucket(), remotes::install_cran(), remotes::install_dev(), remotes::install_git(), remotes::install_github(), remotes::install_gitlab(), remotes::install_local(), remotes::install_svn(), remotes::install_url(), remotes::install_version(), remotes::update_packages(), remotes::dev_package_deps().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":null,"dir":"Reference","previous_headings":"","what":"Reverse dependency tools. — revdep","title":"Reverse dependency tools. — revdep","text":"Tools check notify maintainers CRAN Bioconductor packages depend specified package.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Reverse dependency tools. — revdep","text":"","code":"revdep(   pkg,   dependencies = c(\"Depends\", \"Imports\", \"Suggests\", \"LinkingTo\"),   recursive = FALSE,   ignore = NULL,   bioconductor = FALSE )  revdep_maintainers(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Reverse dependency tools. — revdep","text":"pkg Package name. unlike devtools packages take path might want determine dependencies package installed. omitted, defaults name current package. dependencies character vector listing types dependencies follow. recursive TRUE look full set recursive dependencies. ignore character vector package names ignore. packages appear returned vector. bioconductor TRUE also look dependencies amongst Bioconductor packages.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Reverse dependency tools. — revdep","text":"first run session time-consuming must download package metadata CRAN Bioconductor. Subsequent runs faster.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Reverse dependency tools. — revdep","text":"","code":"if (FALSE) { # \\dontrun{ revdep(\"ggplot2\")  revdep(\"ggplot2\", ignore = c(\"xkcd\", \"zoo\")) } # }"},{"path":"https://devtools.r-lib.org/dev/reference/run_examples.html","id":null,"dir":"Reference","previous_headings":"","what":"Run all examples in a package. — run_examples","title":"Run all examples in a package. — run_examples","text":"One frustrating parts R CMD check getting examples pass - whenever one fails need fix problem restart whole process.  function makes little easier making possible run examples R function.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/run_examples.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run all examples in a package. — run_examples","text":"","code":"run_examples(   pkg = \".\",   start = NULL,   show = deprecated(),   run_donttest = FALSE,   run_dontrun = FALSE,   fresh = FALSE,   document = TRUE,   run = deprecated(),   test = deprecated() )"},{"path":"https://devtools.r-lib.org/dev/reference/run_examples.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run all examples in a package. — run_examples","text":"pkg package use, can file path package package object.  See .package() information. start start running examples: can either name Rd file start (without extensions), topic name. omitted, start (lexicographically) first file. useful lot examples want rerun every time fix problem. show DEPRECATED. run_donttest TRUE, run \\donttest sections Rd files. run_dontrun TRUE, run \\dontrun sections Rd files. fresh TRUE, run fresh R session. advantage way examples can depend anything current session, interactive code (like browser()) work. document TRUE, document() run ensure examples updated running . run, test Deprecated, see run_dontrun run_donttest .","code":""},{"path":"https://devtools.r-lib.org/dev/reference/save_all.html","id":null,"dir":"Reference","previous_headings":"","what":"Save all documents in an active IDE session. — save_all","title":"Save all documents in an active IDE session. — save_all","text":"Helper function wrapping IDE-specific calls save documents active session. form, callers save_all() need execute IDE-specific code. function can extended include IDE implementations equivalent rstudioapi::documentSaveAll() methods.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/save_all.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Save all documents in an active IDE session. — save_all","text":"","code":"save_all()"},{"path":"https://devtools.r-lib.org/dev/reference/show_news.html","id":null,"dir":"Reference","previous_headings":"","what":"Show package news — show_news","title":"Show package news — show_news","text":"Show package news","code":""},{"path":"https://devtools.r-lib.org/dev/reference/show_news.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Show package news — show_news","text":"","code":"show_news(pkg = \".\", latest = TRUE, ...)"},{"path":"https://devtools.r-lib.org/dev/reference/show_news.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Show package news — show_news","text":"pkg package use, can file path package package object.  See .package() information. latest TRUE, show news recent version. ... arguments passed news","code":""},{"path":"https://devtools.r-lib.org/dev/reference/source_gist.html","id":null,"dir":"Reference","previous_headings":"","what":"Run a script on gist — source_gist","title":"Run a script on gist — source_gist","text":"“Gist simple way share snippets pastes others. gists git repositories, automatically versioned, forkable usable git repository.” https://gist.github.com/","code":""},{"path":"https://devtools.r-lib.org/dev/reference/source_gist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run a script on gist — source_gist","text":"","code":"source_gist(id, ..., filename = NULL, sha1 = NULL, quiet = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/source_gist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run a script on gist — source_gist","text":"id either full url (character), gist ID (numeric character numeric). ... options passed source() filename one R file gist, one source (filename ending '.R')? Default NULL source first file. sha1 SHA-1 hash file remote URL. highly recommend prevents accidentally running code expect. See source_url() information using SHA-1 hash. quiet FALSE, default, prints informative messages.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/source_gist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run a script on gist — source_gist","text":"","code":"if (FALSE) { # \\dontrun{ # You can run gists given their id source_gist(6872663) source_gist(\"6872663\")  # Or their html url source_gist(\"https://gist.github.com/hadley/6872663\") source_gist(\"gist.github.com/hadley/6872663\")  # It's highly recommend that you run source_gist with the optional # sha1 argument - this will throw an error if the file has changed since # you first ran it source_gist(6872663, sha1 = \"54f1db27e60\") # Wrong hash will result in error source_gist(6872663, sha1 = \"54f1db27e61\")  #' # You can speficy a particular R file in the gist source_gist(6872663, filename = \"hi.r\") source_gist(6872663, filename = \"hi.r\", sha1 = \"54f1db27e60\") } # }"},{"path":"https://devtools.r-lib.org/dev/reference/source_url.html","id":null,"dir":"Reference","previous_headings":"","what":"Run a script through some protocols such as http, https, ftp, etc. — source_url","title":"Run a script through some protocols such as http, https, ftp, etc. — source_url","text":"SHA-1 hash specified sha1 argument, function check SHA-1 hash downloaded file make sure matches expected value, throw error match. SHA-1 hash specified, print message displaying hash downloaded file. purpose improve security running remotely-hosted code; hash file, can sure changed. convenience, possible use truncated SHA1 hash, 6 characters, keep mind truncated hash secure full hash.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/source_url.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run a script through some protocols such as http, https, ftp, etc. — source_url","text":"","code":"source_url(url, ..., sha1 = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/source_url.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run a script through some protocols such as http, https, ftp, etc. — source_url","text":"url url ... options passed source() sha1 (prefix ) SHA-1 hash file remote URL.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/source_url.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run a script through some protocols such as http, https, ftp, etc. — source_url","text":"","code":"if (FALSE) { # \\dontrun{  source_url(\"https://gist.github.com/hadley/6872663/raw/hi.r\")  # With a hash, to make sure the remote file hasn't changed source_url(\"https://gist.github.com/hadley/6872663/raw/hi.r\",   sha1 = \"54f1db27e60bb7e0486d785604909b49e8fef9f9\")  # With a truncated hash source_url(\"https://gist.github.com/hadley/6872663/raw/hi.r\",   sha1 = \"54f1db27e60\") } # }"},{"path":"https://devtools.r-lib.org/dev/reference/spell_check.html","id":null,"dir":"Reference","previous_headings":"","what":"Spell checking — spell_check","title":"Spell checking — spell_check","text":"Runs spell check text fields package description file, manual pages, optionally vignettes. Wraps spelling package.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/spell_check.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spell checking — spell_check","text":"","code":"spell_check(pkg = \".\", vignettes = TRUE, use_wordlist = TRUE)"},{"path":"https://devtools.r-lib.org/dev/reference/spell_check.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spell checking — spell_check","text":"pkg package use, can file path package package object.  See .package() information. vignettes also check rmd rnw files pkg vignettes folder use_wordlist ignore words package WORDLIST file","code":""},{"path":"https://devtools.r-lib.org/dev/reference/submit_cran.html","id":null,"dir":"Reference","previous_headings":"","what":"Submit a package to CRAN — submit_cran","title":"Submit a package to CRAN — submit_cran","text":"submits package CRAN using web-form submission process. submission, receive email asking confirm submission used check package submitted maintainer. may prefer use submit_cran() indirectly, calling release() instead. release() performs many checks verifying package indeed ready CRAN, eventually asking confirmation like submit CRAN (calling submit_cran()). Whether use release() submit_cran() depends rest development process. want super cautious, use release(), even though may redundant checks performed. hand, many checks place (automated checks via GitHub Actions task list generated usethis::use_release_issue()), makes sense use submit_cran() directly.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/submit_cran.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Submit a package to CRAN — submit_cran","text":"","code":"submit_cran(pkg = \".\", args = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/submit_cran.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Submit a package to CRAN — submit_cran","text":"pkg package use, can file path package package object.  See .package() information. args optional character vector additional command line arguments passed R CMD build.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/test.html","id":null,"dir":"Reference","previous_headings":"","what":"Execute testthat tests in a package — test","title":"Execute testthat tests in a package — test","text":"test() runs tests package. shortcut testthat::test_dir() test_active_file() runs test() active file. test_coverage() computes test coverage package. shortcut covr::package_coverage() plus covr::report(). test_coverage_active_file() computes test coverage active file. shortcut covr::file_coverage() plus covr::report().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/test.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Execute testthat tests in a package — test","text":"","code":"test(pkg = \".\", filter = NULL, stop_on_failure = FALSE, export_all = TRUE, ...)  test_active_file(file = find_active_file(), ...)  test_coverage(pkg = \".\", show_report = interactive(), ...)  test_coverage_active_file(   file = find_active_file(),   filter = TRUE,   show_report = interactive(),   export_all = TRUE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/test.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Execute testthat tests in a package — test","text":"pkg package use, can file path package package object.  See .package() information. filter NULL, tests file names matching regular expression executed. Matching performed file name stripped \"test-\" \".R\". stop_on_failure TRUE, throw error tests fail. export_all TRUE (default), export objects. FALSE, export objects listed exports NAMESPACE file. ... additional arguments passed wrapped functions. file One source test files. source file corresponding test file run. default use active file RStudio (available). show_report Show test coverage report.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/uninstall.html","id":null,"dir":"Reference","previous_headings":"","what":"Uninstall a local development package — uninstall","title":"Uninstall a local development package — uninstall","text":"Uses remove.packages() uninstall package. uninstall package non-default library, use combination withr::with_libpaths().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/uninstall.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Uninstall a local development package — uninstall","text":"","code":"uninstall(pkg = \".\", unload = TRUE, quiet = FALSE, lib = .libPaths()[[1]])"},{"path":"https://devtools.r-lib.org/dev/reference/uninstall.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Uninstall a local development package — uninstall","text":"pkg package use, can file path package package object.  See .package() information. unload TRUE (default), ensures package unloaded, prior uninstalling. quiet TRUE, suppress output. lib character vector giving library directories remove     packages .  missing, defaults first element     .libPaths().","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/uses_testthat.html","id":null,"dir":"Reference","previous_headings":"","what":"Does a package use testthat? — uses_testthat","title":"Does a package use testthat? — uses_testthat","text":"package use testthat?","code":""},{"path":"https://devtools.r-lib.org/dev/reference/uses_testthat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Does a package use testthat? — uses_testthat","text":"","code":"uses_testthat(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/wd.html","id":null,"dir":"Reference","previous_headings":"","what":"Set working directory. — wd","title":"Set working directory. — wd","text":"Set working directory.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/wd.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set working directory. — wd","text":"","code":"wd(pkg = \".\", path = \"\")"},{"path":"https://devtools.r-lib.org/dev/reference/wd.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set working directory. — wd","text":"pkg package use, can file path package package object.  See .package() information. path path within package. Leave empty change working directory package directory.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-development-version","dir":"Changelog","previous_headings":"","what":"devtools (development version)","title":"devtools (development version)","text":"test_coverage() now works package installed. test_coverage_active_file() now reports tests failed better job executing snapshot comparisons.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-245","dir":"Changelog","previous_headings":"","what":"devtools 2.4.5","title":"devtools 2.4.5","text":"CRAN release: 2022-10-11 check(cleanup =) deprecated devtools v1.11.0 (2016-04-12) made defunct v2.4.4 (2022-07-20). documentation clear now recommended alternatives. check(check_dir = NULL) new default, align default behaviour underlying rcmdcheck::rcmdcheck(). check(cran = TRUE) sets env var _R_CHECK_PACKAGES_USED_IGNORE_UNUSED_IMPORTS_ FALSE, order surface \"Namespace Imports field imported \" NOTE. applies R >= 4.2, due favorable changes behaviour R CMD check ---cran (#2459). test_active_file() passes package onto testthat can correctly set TESTTHAT_PKG envvar (#2470). test() test_active_file() work testthat . dev_mode() deprecated (@billdenney, #2467).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-244","dir":"Changelog","previous_headings":"","what":"devtools 2.4.4","title":"devtools 2.4.4","text":"CRAN release: 2022-07-20 install(reload = TRUE) now calls pkgload::unregister() instead pkload::unload() (#2349). allows package keep functioning still use R session (e.g. event handlers). test() longer calls load_all() twice. test_active_file() now calls load_all() via testthat. aspell_env_var() better job matching R CMD check behaviour, use aspell, hunspell ispell (#2376). Installing devtools now installs pkgdown, profvis, bench, miniUI, urlchecker, ensuring everything needed package development (#2388). dev_sitrep() updated calendar-based version number scheme adopted RStudio IDE September 2021 (#2397, #2410).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-243","dir":"Changelog","previous_headings":"","what":"devtools 2.4.3","title":"devtools 2.4.3","text":"CRAN release: 2021-11-30 New check_mac_release() function check package using macOS builder https://mac.r-project.org/macbuilder/submit.html (#2375) Jenny Bryan now official maintainer. release() submit_cran() now record submission details using Debian Control File format, better machine-readability. file new name, CRAN-SUBMISSION (instead CRAN-RELEASE) now includes package version, addition full SHA timestamp.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-242","dir":"Changelog","previous_headings":"","what":"devtools 2.4.2","title":"devtools 2.4.2","text":"CRAN release: 2021-06-07 check_man() now works R versions 4.1+ (#2354) test_active_file() now works windows projects stored user’s home directory (~) (#2355) document(quiet = TRUE) now works without failure windows (#2351) Minor test failure R 4.2 fixed. New Rstudio addin run_examples() (#2358)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-241","dir":"Changelog","previous_headings":"","what":"devtools 2.4.1","title":"devtools 2.4.1","text":"CRAN release: 2021-05-05 build_readme() now uses path argument, designed (#2344) create() longer opens projects default avoid duplicate projects opened RStudio IDE project template (#2347, @malcolmbarrett) RStudio addins now use test_active_file() test_coverage_active_file() instead deprecated test_file() test_coverage_file() (#2339) RStudio addins now run interactive mode, rather background mode (@jennybc, #2350) install(upgrade) now defaults ‘default’ rather ‘ask’. allows control default asking behavior R_REMOTES_UPGRADE environment variable (#2345)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-240","dir":"Changelog","previous_headings":"","what":"devtools 2.4.0","title":"devtools 2.4.0","text":"CRAN release: 2021-04-07","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"breaking-changes-and-deprecated-functions-2-4-0","dir":"Changelog","previous_headings":"","what":"Breaking changes and deprecated functions","title":"devtools 2.4.0","text":"check_results() function removed. used CRAN package, much better alternatives available rcmdcheck package. pkgload::inst() longer re-exported (#2218). test_file() renamed test_active_file() test_coverage_file() renamed test_coverage_active_file() avoid name collision testthat::test_file(). previous names soft deprecated release, hard deprecated next release eventually removed. (#2125)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"re-licensing-2-4-0","dir":"Changelog","previous_headings":"","what":"Re-licensing","title":"devtools 2.4.0","text":"devtools now released MIT license (#2326)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-fixes-2-4-0","dir":"Changelog","previous_headings":"","what":"Minor improvements and fixes","title":"devtools 2.4.0","text":"build_readme() now supports readme files located inst/README.Rmd, intended (#2333) build_vignettes() now creates specific .gitignore entries (@klmr, #2317) check() now re-documents matching version roxygen2 (#2263). change_maintainer_email() now check assess whether email actually changed. email changed, code now stops email accidentally sent wrong recipient. (@emilsjoerup, #2073) run_examples(fresh = TRUE) works without error (#2264) covr DT packages moved Imports Suggests. needed running test_coverage() test_coverage_active_file() now ’ll prompted install needed. Switched fs file system functions (#2331, @malcolmbarrett) Now uses testthat 3.0.0 power test(), test_active_file(), test_coverage(), test_coverage_active_file(). major difference test_active_file() now generates compact summary takes less space console.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-232","dir":"Changelog","previous_headings":"","what":"devtools 2.3.2","title":"devtools 2.3.2","text":"CRAN release: 2020-09-18 Fix compatibility withr 2.3.0","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-231","dir":"Changelog","previous_headings":"","what":"devtools 2.3.1","title":"devtools 2.3.1","text":"CRAN release: 2020-07-21 check_win_*() function now resets email original email execution, bug fixed crept back (@muschellij2, #2152). run_examples() arguments run test deprecated favor (hopefully) clear run_dontrun run_donttest (pkgload/#107). Previously deprecated functions dr_devtools() dr_github() removed. Documentation synced remotes 2.2.0","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-230","dir":"Changelog","previous_headings":"","what":"devtools 2.3.0","title":"devtools 2.3.0","text":"CRAN release: 2020-04-10 build() now errors informative error message passed invalid pkg. (#2177) New build_rmd() can build .Rmd file clean session. dev_sitrep() now works correctly R date (#2204)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-222","dir":"Changelog","previous_headings":"","what":"devtools 2.2.2","title":"devtools 2.2.2","text":"CRAN release: 2020-02-17 install_dev_deps() now passes formal args onto remotes::install_deps() (@t-gibson, #2166) spell_check() now checks spelling installed prompts users install (@mikemahoney218, #2172) submit_cran() now returns informative error CRAN submission portal (#1958) check() gains vignettes argument, easily disable checks vignettes (#2165). check_win_*() function now resets email original email execution (@muschellij2, #2152). check() now sets NOT_CRAN=true default, originally intended (#2135). install_deps() now supports options(\"devtools.ellipsis_action\") well (#2169) test() now takes stop_on_failure formal argument (FALSE default) instead .... value still passed testthat::test_dir (@infotroph, #2129). test() test_coverage_file() gain export_all argument, controls functions package automatically exported (#1201). dev_sitrep() now works run outside package directory (#2127). release() now works package root working directory.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-221","dir":"Changelog","previous_headings":"","what":"devtools 2.2.1","title":"devtools 2.2.1","text":"CRAN release: 2019-09-24 test() now sets collation order C running, matches behavior tests run R CMD check (#2121) New options(\"devtools.ellipsis_action\") option added control action ellipsis devtools. one rlang::abort - emit error arguments unused rlang::warn - emit warning arguments unused rlang::inform - emit message arguments unused rlang::signal - emit message arguments unused Using rlang::signal produce output unless custom condition caught, best way retain backwards compatibility devtools behavior prior 2.2.0. default behavior also changed issue warning rather error arguments unused, cases devtools need install package, unused arguments false positives (#2109). install() now throws error fails, intended (#2120) install() now reloads re-attaches packages previously loaded (#2111). release() longer calls deprecated dr_devtools() (#2105) test() now explicitly passes stop_on_failure = FALSE testthat::test_dir() (@jameslamb, #2099)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-220","dir":"Changelog","previous_headings":"","what":"devtools 2.2.0","title":"devtools 2.2.0","text":"CRAN release: 2019-09-07","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-2-2-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"devtools 2.2.0","text":"create() added back, RStudio IDE uses create() create packages dialog, removing version 2.1.0 broke old versions IDE. New dev_sitrep() function return information development environment diagnose common problems. former functions dr_devtools() dr_github() deprecated. (#1970) functions taking ... now use ellipsis package. catches errors arguments misspelled incorrectly specified (#2016)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-fixes-2-2-0","dir":"Changelog","previous_headings":"","what":"Minor improvements and fixes","title":"devtools 2.2.0","text":"build_vignettes() now correctly installs vignette builder already installed (#2089). dev_sitrep() now uses endpoint detect current RStudio version IDE (#2050). document() gains quiet parameter, silence output check() now passes quiet argument (#1986). Add DT package dependency, test_coverage() test_coverage_file() work without install additional packages (#2085). check_man() now succeeds tools::undoc() returns empty results (#1944). check_win_*() functions gain email argument, temporarily change email check results sent (#1723). install() now explicitly unloads packages trying install new version (#2094). install_*() functions now attach build tools PATH, makes work Windows RTools default PATH (#2093). test_coverage_file() now works 1 1 correspondence test source files (#2011). release() now works pkg current working directory (#1974). release() now works without error options(\"repos\") unnamed (#1956). create() added, RStudio IDE uses create(), removing version 2.1.0 broke old versions IDE. several places http: URLs used instead https:, critical cran_mirror, cran_pacakges, cran_submission_url values enabled discrete activity disclosure person---middle attacks (.e. changing contents uploading/downloading). http: URLS changed https: URLs. (@hrbrmstr, #2091)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-210","dir":"Changelog","previous_headings":"","what":"devtools 2.1.0","title":"devtools 2.1.0","text":"CRAN release: 2019-07-06","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-2-1-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"devtools 2.1.0","text":"testthat roxygen2 now added Imports rather Suggests, automatically installed install devtools.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"deprecated-functions-now-removed-2-1-0","dir":"Changelog","previous_headings":"","what":"Deprecated functions now removed","title":"devtools 2.1.0","text":"create(), create_description(), setup() use_appveyor(), use_build_ignore(), use_code_of_conduct(), use_coverage(), use_cran_badge(), use_cran_comments(), use_data(), use_data_raw(), use_dev_version(), use_git(), use_git_hook(), use_github(), use_github_links(), use_gpl3_license(), use_mit_license(), use_news_md(), use_package(), use_package_doc(), use_rcpp(), use_readme_md(), use_readme_rmd(), use_revdep(), use_rstudio(), use_test(), use_testthat(), use_travis(), use_vignette(), removed deprecated previous releases. Use versions usethis package directly. check_cran(), revdep_check(), revdep_check_print_problems(), revdep_check_reset(), revdep_check_resume(), revdep_check_save_summary(), revdep_email() removed deprecated previous releases. recommended use revdepcheck package instead. system_check(), system_output() removed deprecated previous releases. recommend use processx package instead. build_win() removed, deprecated previous releases. yesno() used release() now clearer synonyms “yes” (@mattmalin, #1993)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-fixes-2-1-0","dir":"Changelog","previous_headings":"","what":"Minor improvements and fixes","title":"devtools 2.1.0","text":"check_rhub gains new argument build_args arguments passed R CMD build. ... now passed rhub::check_for_cran() (@gaborcsardi, @maelle, #2041) build_manual() now fails manual fails build. (#2056) test_file() test_coverage_file() now work C C++ files src/ directory well.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-202","dir":"Changelog","previous_headings":"","what":"devtools 2.0.2","title":"devtools 2.0.2","text":"CRAN release: 2019-04-08 Two tests now skipped run CRAN, fail due outdated pandoc restrictions writing package library respectively. load_all() now accepts ‘package’ objects, regaining previous behavior devtools prior 2.0.0 (#1923) test(), test_coverage() test_coverage_file() now set TESTTHAT_PKG environment variable, consistent running tests R CMD check (testthat#787). check() now replaces existing environment variables rather appending (#1914).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-201","dir":"Changelog","previous_headings":"","what":"devtools 2.0.1","title":"devtools 2.0.1","text":"CRAN release: 2018-10-26 minor release mainly fixing bugs snuck devtools 2.0.0 release. install() now correctly passes upgrade parameter remotes::install_deps() (@Paxanator, #1898). install_deps() now works directory within package (#1905) Add RStudio addin test_coverage(). tests use remote resources now skipped CRAN, avoid spurious failures","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-200","dir":"Changelog","previous_headings":"","what":"devtools 2.0.0","title":"devtools 2.0.0","text":"CRAN release: 2018-10-19 Devtools 2.0.0 major release contains work past year half, since major devtools release (1.13.0). release splits functionality devtools number smaller packages simpler develop also easier packages depend . particular following packages spun calling ‘conscious uncoupling’ devtools. remotes: Installing packages (.e. install_github()). pkgbuild: Building binary packages (including checking build tools available) (.e. build()). pkgload: Simulating package loading (.e. load_all()). rcmdcheck: Running R CMD check reporting results (.e. check()). revdepcheck: Running R CMD check reverse dependencies, figuring ’s changed since last CRAN release (.e. revdep_check()). sessioninfo: R session info (.e. session_info()). usethis: Automating package setup (.e. use_test()). devtools remain main package developers interact writing R packages; just rely packages internally functionality.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"breaking-changes-2-0-0","dir":"Changelog","previous_headings":"","what":"Breaking changes","title":"devtools 2.0.0","text":"number breaking changes release, cause short term pain users result easier understand API future, feel tradeoff worthwhile. devtools::install() arguments changed follows. local -> build force_deps -> force upgrade_dependencies -> upgrade threads -> Removed, can use Ncpus, passed ... install.packages() metadata -> Removed out_dir -> Removed skip_if_log_exists -> Removed check() argument check_version renamed remote better describe tests disabled (#1811) get_path(), set_path(), add_path() on_path() removed, functionality available withr::with_path() (#1796). lang argument spell_check() removed, compatibility spelling v1.1. (#1715) previously deprecated with_ functions now removed. functionality moved withr package. RCMD(), clean_source(), eval_clean() evalq_clean() removed. functions never worked terribly well, replaced much better functions callr. build_win() renamed check_win_release(), check_win_devel(), check_win_oldrelease() (#1598).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"deprecated-functions-2-0-0","dir":"Changelog","previous_headings":"","what":"Deprecated functions","title":"devtools 2.0.0","text":"Infrastructure functions (use_*) now use implementations usethis versions devtools deprecated. use package switch package depend usethis directly instead. revdep_check_* functions deprecated favor revdepcheck package. system_check() system_output() deprecated factor processx package.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"major-changes-2-0-0","dir":"Changelog","previous_headings":"","what":"Major changes","title":"devtools 2.0.0","text":"install_*() functions now re-exported remotes rather defined devtools devtools now depends roxygen2 6.1.0: considerably simplifies devtools::document() makes consistent roxygen2::roxygenise(). test_file() function added test one files package (#1755). test_coverage() function added provide helper compute test coverage using covr (#1628). test_file() test_coverage_file() now RStudio addins (#1650) test_file_coverage() function added show test coverage one files package. (#1755). session_info() now uses implementation sessioninfo package. Packages using devtools::session_info() encouraged switch using sessioninfo::session_info() instead. package_info() function now re-exported sessioninfo package. check() now uses rcmdcheck run parse R CMD check output (#1153). Code related simulating package loading pulled separate package, pkgload. following functions moved pkgload without shim: clean_dll(), compile_dll(), dev_example(), dev_help(), dev_meta(), find_topic(), imports_env(), inst(), load_code(), load_dll(), ns_env(), parse_ns_file(), pkg_env(). functions primarily internal use. load_all() unload() moved pkgload, devtools provides shims since commonly used. find_rtools(), setup_rtools(), has_devel(), compiler_flags(), build() with_debug() moved new pkgbuild package. build() with_debug() re-exported devtools spell_check() code moved new spelling package thereby gained support vignettes package wordlists. devtools function now wraps spelling::spell_check_package().","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-fixes-2-0-0","dir":"Changelog","previous_headings":"","what":"Minor improvements and fixes","title":"devtools 2.0.0","text":"check_win_*() now build package manual = TRUE default (#1890). check() output now works nicely recent changes rcmdcheck (#1874). reload() now reloads loaded attached packages well attached ones. Executed styler::style_pkg() update code style (#1851, @amundsenjunior). save_all() helper function wraps rstudioapi::documentSaveAll() calls (#1850, @amundsenjunior). check() now allows users run without --timings (#1655) update_packages() better documented advertise can used update packages installed install_* functions. check() gains incoming option toggle CRAN incoming checks. build_vignette() gains keep_md option allow keeping intermediate markdown output (#1726) remote_sha.github() now correctly looks SHA private repositories (#1827, @renozao). devtools use_*() functions now temporarily set active usethis project given pkg argument current directory. provides backwards compatibility previous behavior (#1823). Vignettes now built separate process, package installed building vignettes (#1822) build_readme() added build README.md README.Rmd (#1762) build_vignettes() now clean upgrade arguments, control cleaning intermediate files upgrading vignette dependencies respectively. (#1770). release() gains additional question ensuring updated codemeta.json one exists (#1774, #1754) test() now sets useFancyQuotes = FALSE better mimic environment tests run R CMD check (#1735). test() longer passes encoding argument testthat::test_dir() (#1776) install_url() can now install package binaries windows (#1765) Fix skipping installing full SHA (#1624) add pkgdown::build_site() wrapper (@kiwiroy, #1777) add pkgdown site (https://devtools.r-lib.org) (#1779, @jayhesselberth) install_version() can now install current version CRAN package Windows macOS (@jdblischak, #1730) CRAN-RELEASE file now added .Rbuildignore (#1711) check() check_built() now error_on argument specify throw error check failures. run non-interactively set “warnings” unless specified. check() now sets _R_CHECK_CRAN_INCOMING_REMOTE_ instead _R_CHECK_CRAN_INCOMING_on R versions support former option (#1271, #1276, #1702). Now use cli package draw rules - aesthetically pleasing correct width RStudio build pane (#1627). release() tweaked reflect modern submission workflow ask questions rather running code (#1632). document(), load_all(), check(), build() test() now automatically save open files run inside RStudio IDE. (#1576) New check_rhub() function check packages using https://builder.r-hub.io/. run_examples mistakenly passing show pkgload::run_example, causing fail (@amcdavid, #1449) New build_manual() function produces pdf manual package (@twolodzko, #1238). use git release() now generates file called CRAN-RELEASE reminds tag commit submitted CRAN (#1198). release() looks additional release questions correct environment (#1434). submit_cran() now checks ’re ready submit, since potentially expensive operation (#1228) check() defaults running document() used roxygen previously (#1437). Signal error commas missing remote entries (#1511, @ianmcook). build_vignettes() gains quiet argument (#1543). source_gist() works single file gist (#1266). order run test helpers document(), helpers argument  load_all() set FALSE (@nbenn, #1669) my_unzip() function now able use utils::unzip fallback R compiled source unzip package present (@theGreatWhiteShark, #1678) foghorn package installed, release() displays results CRAN checks (#1672, @fmichonneau).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1135","dir":"Changelog","previous_headings":"","what":"devtools 1.13.5","title":"devtools 1.13.5","text":"CRAN release: 2018-02-18 Fix two test errors related GitHub rate limiting mocking base functions.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1134","dir":"Changelog","previous_headings":"","what":"devtools 1.13.4","title":"devtools 1.13.4","text":"CRAN release: 2017-11-09 Fix test errors upcoming testthat release.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1133","dir":"Changelog","previous_headings":"","what":"devtools 1.13.3","title":"devtools 1.13.3","text":"CRAN release: 2017-08-02 Workaround change Rcpp::compileAttributes stores symbol names broke tests.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1132","dir":"Changelog","previous_headings":"","what":"devtools 1.13.2","title":"devtools 1.13.2","text":"CRAN release: 2017-06-02 Workaround regression Rcpp::compileAttributes. Add trimws implementation R 3.1 support.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1131","dir":"Changelog","previous_headings":"","what":"devtools 1.13.1","title":"devtools 1.13.1","text":"CRAN release: 2017-05-13 Bugfix installing git remote passing git2r credentials (@james-atkins, #1498) Bugfix installation dependencies dependencies (@jimhester, #1409). Bugfix installation dependencies CRAN-like repositories created drat (@jimhester, #1243, #1339). load_all() longer automatically creates description . use_test() template longer includes useless comments (#1349) Fix test() compatibility testthat versions 1.0.2 (#1503). Fix install_version(), install_bitbucket(), install_local(), install_url(), install_svn(), install_bioc() gain quiet arguments properly pass internal functions. (#1502)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1130","dir":"Changelog","previous_headings":"","what":"devtools 1.13.0","title":"devtools 1.13.0","text":"CRAN release: 2017-05-08","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-13-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"devtools 1.13.0","text":"spell_check gains dict argument set custom language dictionary release() now checks documentation spelling errors default. New use_gpl3_license() sets license field DESCRIPTION includes copy license LICENSE.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"revdep-check-improvements-1-13-0","dir":"Changelog","previous_headings":"","what":"Revdep check improvements","title":"devtools 1.13.0","text":"Various minor improvements around checking reverse dependencies (#1284, @krlmlr). packages involved listed start, whole process now resilient package installation failures. revdep_check() revdep_check_resume() gain skip argument takes character vector packages skip. revdep_check() check_cran() gain quiet_check argument. can use quiet_check = FALSE see actual text R CMD check runs (recommending multiple threads). revdep_check_resume() now takes ... can used override settings revdep_check(). debugging problem package checks, try revdep_check(threads = 1, quiet_check = FALSE) revdep_check() collects timing information timing.md (#1319, @krlmlr). Package names examples sorted case-insensitive C collation (#1322, @krlmlr). use_revdep() adds .gitignore entry check database (#1321, @krlmlr). package installed temporary library revdep checking (#1338, @krlmlr). Automated revdep check e-mails now can use new my_version you_cant_install variables. e-mail template updated use variables (#1285, @krlmlr). Installation failures logged revdep checking, default revdep/install. installation failed, attempted second time (#1300, @krlmlr). Print summary table README.md problems.md (#1284, @krlmlr). Revdep check improvements (#1284)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-and-minor-improvements-1-13-0","dir":"Changelog","previous_headings":"","what":"Bug fixes and minor improvements","title":"devtools 1.13.0","text":"Handle case un-installed package passed session_info (#1281). Using authentication access Github package name. (#1262, @eriknil). spell_check() checks hunspell running (#1475, @jimvine). add_desc_package() checks package dependencies correctly (#1463, @thomasp85). Remove deprecated args argument install_git() allow passthrough install (#1373, @ReportMort). added quiet argument install_bitbucket(), default value FALSE (fixes issue #1345, @plantarum). update_packages() allows override interactive prompt (#1260, @pkq). use_test() template longer includes useless comments (#1349) Add encoding support test_dir() call adding reference pkg$encoding (#1306, @hansharhoff) Parse valid Git remote URLs lack trailing .git, e.g. GitHub browser URLs (#1253, @jennybc). Add check_bioconductor() internal function automatically install BiocInstaller() installed user wants . Improve Git integration. use_git_ignore() use_git_config() gain quiet argument, tests work without setting user.name user.email Git configuration settings (#1320, @krlmlr). Improve Git status checks used release() (#1205, @krlmlr). Improved handling local file:// repositories install() (#1284, @krlmlr). setup() create() gain new quiet argument (#1284, @krlmlr). Avoid unnecessary query available_packages() (#1269, @krlmlr). Add cache setting AppVeyor template (#1290, @krlmlr). Fix AppVeyor test manually installing curl (#1301). install(dependencies = FALSE) doesn’t query available packages anymore (@krlmlr, #1269). use_travis() now opens webpage browser easily activate repo. use_readme_rmd() use_readme() share common template sections package overview, GitHub installation (applicable), example (@jennybc, #1287). test() doesn’t load helpers twice anymore (@krlmlr, #1256). Fix auto download method selection install_github() R 3.1 lacks “libcurl” capabilities(). (@kiwiroy, #1244) Fix removal vignette files trying remove files twice anymore (#1291) add timestamp messages build_win() (@achubaty, #1367).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1120","dir":"Changelog","previous_headings":"","what":"devtools 1.12.0","title":"devtools 1.12.0","text":"CRAN release: 2016-06-24","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-12-0","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 1.12.0","text":"New install_bioc() function bioc remote install Bioconductor packages SVN repository. install_dev_deps() gets everything need start development source package - installs dependencies, roxygen2 (#1193). use_dev_version() automates process switching release version number tweaking DESCRIPTION, adding heading NEWS.md (present), checking git (use ) (#1076.) use_github() accepts host argument, similar install_github() (@ijlyttle, #1101)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-and-minor-improvements-1-12-0","dir":"Changelog","previous_headings":"","what":"Bug fixes and minor improvements","title":"devtools 1.12.0","text":"Update Rtools-3.4 information, (@jimhester) devtools now uses https access RStudio CRAN mirror work system (#1059) Handle case GitHub request returns non-JSON error response. (@jimhester, #1204, #1211) Suggested packages, including specified Remotes: now installed package installation. allows use circular Remotes: dependencies two related packages long one dependencies Suggested package. (@jimhester, #1184, hadley/dplyr#1809) bug fix installation binary packages windows, must installed directly zip file. (@jimhester, #1191, #1192) build_vignette() now install “VignetteBuilder” ’s present, try upgrade (#1139). clean_dll() removes package_name.def files now operates recursively. (@jimhester, #1175, #1159, #1161) check_man() now prints message problems found (#1187). install_* functions update_packages() refactored allow updating packages installed using install methods. (@jimhester, #1067) install_github() now uses https://api.github.com host argument, users can specify ‘http:’ protocols needed. (@jimhester, #1131, #1200) load_all() runs package hooks sourcing test helper files allowing test helper make use objects created package loaded attached. (@imanuelcostigan, #1146) revdep_check() now create revdep/ directory already exist (#1178). source_gist() gains filename argument specify particular file source GitHub gist. (@ateucher, #1172) Add default codecov.yml file turn commenting use_coverage() (@jimhester, #1188) Bug fix ‘nchar(text) : invalid multibyte string’ errors running write_dcf() DESCRIPTION files non-ASCII encodings (#1224, @jimhester).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1111","dir":"Changelog","previous_headings":"","what":"devtools 1.11.1","title":"devtools 1.11.1","text":"CRAN release: 2016-04-21 Bug fix search_path_for_rtools() using gcc-4.9.3 toolchain rtools setting windows registry. (@jimhester, #1155)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1110","dir":"Changelog","previous_headings":"","what":"devtools 1.11.0","title":"devtools 1.11.0","text":"CRAN release: 2016-04-12","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"infrastructure-helpers-1-11-0","dir":"Changelog","previous_headings":"","what":"Infrastructure helpers","title":"devtools 1.11.0","text":"create_description() now sets Encoding: UTF-8. helps non-English package authors (#1123). use_ function overhauled consistent, particularly around notification. functions now also ask overwrite file already exists (#1074). use_coverage() now adds covr “Suggests”, rather recommending install explicitly .travis.yml. use_cran_badge() now uses HTTPS URL (@krlmlr, #1124). use_github() now confirms ’ve picked good title description (#1092) prints url repo (#1063). use_news(), use_test() open files RStudio (’re using rstudioapi package installed). use_testthat() tells ’s (#1056). use_travis() generates template compatible newest R-travis. use_readme_md() creates basic README.md template (#1064). use_revdep() updated template new revdep check system (#1090, @krlmlr). Removed deprecated use_coveralls(), add_rstudio_project(), add_test_infrastructure(), add_travis(). Deprecated build_github_devtools() removed.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"checks-and-release-1-11-0","dir":"Changelog","previous_headings":"","what":"Checks and release()","title":"devtools 1.11.0","text":"check() now always succeeds (instead throwing error R CMD check finds ERROR), returning object summarises check failures. check() gains run_dont_test manual arguments control whether \\donttest{} tests tested, manuals built. defaults FALSE, release() runs check set TRUE (#1071; #1087, @krlmlr). cleanup argument check() deprecated: now always returns path check directory. check_built() allows run R CMD check already built package. check_cran() suppresses X11 DISPLAY = \"\". release() tweaked improve order questions, ensure ’re ok problems. warns inst/NEWS.Rd NEWS.md exist (@krlmlr, #1135), doesn’t throw error Git head detached (@krlmlr, #1136). release() gains args argument control build options, e.g. allow passing args = \"--compact-vignettes=\" packages heavy PDF vignettes (@krlmlr, #1077). system_check() gains new arguments path controls working directory command, throw control whether throws error command failure. env renamed explicit env_vars.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"revdep-checks-1-11-0","dir":"Changelog","previous_headings":"","what":"Revdep checks","title":"devtools 1.11.0","text":"revdep_check() overhauled. revdep_ functions now work like devtools functions, taking path package first argument. revdep_check() now saves results disk check/check.rds, revdep() functions read cache. also allows resume partial run revdep_check_resume(). big time saver something goes unexpected wrong middle checks. can blow away cache start afresh revdep_check_reset(). revdep_check_save_summary() now creates README.md save one level clicking github. also creates problems.md contains results packages warnings errors. problem limited 25 lines output - avoids lengthy output failing examples. revdep_check_print_problems() prints bulleted list problems, suitable inclusion cran-comments.md. Summary results reported come , every messages ’ll get message giving elapsed estimated remaining time. experimental revdep_email() emails individual maintainers R CMD check summary results (#1014). See testthat dplyr example usage. handful smaller fixes: revdep_check() doesn’t complain missing git2r package anymore (#1068, @krlmlr). Package index caches revdep_check() now time 30 minutes. revdep_check_save_logs() removed - just useful. revdep_check_summary() removed - never part exported API.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"other-improvements-1-11-0","dir":"Changelog","previous_headings":"","what":"Other improvements","title":"devtools 1.11.0","text":"Devtools now uses new gcc toolchain windows, installed (@jimhester). install_git() now allows pass credentials git2r specify specific ssh credentials (@onlymee, #982) load_all() now sources test helpers use testthat. makes much easier interactively run tests (#1125). load_all() also correctly handles unix windows subdirectories within R (@gaborcsardi, #1102) build_win() defaults R-devel, since commonly want. Help shims now inform ’re using development documentation (#1049). git_sha1() Fix fetching latest git commit also works shallow git clones, .e. git clones make use depth. (#1048, #1046, @nparley)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1100","dir":"Changelog","previous_headings":"","what":"devtools 1.10.0","title":"devtools 1.10.0","text":"CRAN release: 2016-01-23","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-10-0","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 1.10.0","text":"curl, evaluate, roxygen2 rversions moved Imports Suggests lighten dependency load devtools. run function needs one packages, ’ll prompted install (#962, @jimhester). Devtools uses new strategy detecting RTools windows: now looks Rtools need load_all() build() package compiled code. make easier work devtools ’re developing pure R packages (#947). package_file() lets find files inside package. starts finding root directory package (.e. directory contains DESCRIPTION) (#985). use_news_md() adds basic NEWS.md template (#957). use_mit_license() writes necessary infrastructure declare release R package MIT license CRAN-compliant way. (#995, @kevinushey) check(cran = TRUE) adds --run-donttest since need test code \\donttest() CRAN submission (#1002).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"package-installation-1-10-0","dir":"Changelog","previous_headings":"","what":"Package installation","title":"devtools 1.10.0","text":"install() installs packages specified Additional_repositories field, drat repositories. (#907, #1028, @jimhester). correctly installs missing dependencies (#1013, @gaborcsardi). called Bioconductor package, include Bioconductor repositories already set (#895, @jimhester). install() gains metadata argument lets add extra fields DESCRIPTION install. (#1027, @rmflight) install_github() install_git() downloads installs package remote SHA1 reference differs currently installed reference (#903, @jimhester). install_local() captures git github information stores DESCRIPTION (#1027, @rmflight). install_version() robust handling multiple repos (#943, #1030, @jimhester). Bugfix Remotes: feature prevented working devtools attached done travis-r (#936, @jimhester).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-and-minor-improvements-1-10-0","dir":"Changelog","previous_headings":"","what":"Bug fixes and minor improvements","title":"devtools 1.10.0","text":"check_dev_versions() checks package dependencies (#983). check_man() replaces check_doc() (since functions named corresponding directory). check_doc() hang around alias foreseeable future (#958). create() produces dummy namespace fake comment roxygen2 overwrite silently (#1016). create() setup() permissive – now accept path either new directory empty directory. (#966, @kevinushey) document() now runs update_collate() . load_all() resolves longstanding lazy load database corruption issue reloading packages define S3 methods generics base packages (#1001, @jimhester). release_checks() gains two new checks: check_vignette_titles() checks vignette titles aren’t default “Vignette Title” (#960, @jennybc). check_news_md() checks NEWS.md isn’t .Rbuildignore (since ’s now supported CRAN, #1042). revdep_check(): verbose package installed (#926, @krlmlr) Verifies integrity already downloaded package archives (#930, @krlmlr) now tolerant errors retrieving summary checked package (#929, @krlmlr). ncpus > 1, includes package name know package failed can start looking output without needing wait packages finish (@mattdowle). Uses proper repository BiocInstaller::useDevel(TRUE) (#937, @jimhester). Shimmed system.file() now respects mustWork = TRUE throws error file exist (#1034). use_appveyor() template now creates failure.zip artifact instead polluting logs R CMD check output (#1017, @krlmlr, @HenrikBengtsson). use_cran_comments() template improved (#1038). use_data() now warns trying save object twice, stops object save (#948, @krlmlr). use_revdep_check() longer includes revdep_check_save_logs default template. found never used logs just cluttered package directory (#1003). with_*() functions moved withr package, devtools functions deprecated (#925, @jimhester).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-191","dir":"Changelog","previous_headings":"","what":"devtools 1.9.1","title":"devtools 1.9.1","text":"CRAN release: 2015-09-11 Avoid importing heavy dependencies speed loading (#830, @krlmlr). Remove explicit library(testthat) call test() (#798, @krlmlr). .package() load_all() gain new argument create. Like functions pkg argument, load_all() looks DESCRIPTION file parent directories - create = TRUE automatically created ’s R/ data/ directory (#852, @krlmlr). build_vignettes() gains dependencies argument (#825, @krlmlr). build_win() now uses curl instead RCurl ftp upload. build_win() asks consent receive e-mail maintainer address interactive mode (#800, @krlmlr). check() now uses better strategy cran = TRUE. Instead attempting simulate ---cran behaviour turning certain env vars, now uses ---cran turns problematic checks env vars (#866). problematic cran_env_vars() function removed. find_rtools() now looks registry keys HKCU (user) HKLM (admin) locations (@Kevin-Jin, #844) install() can now install dependencies remote repositories specifying Remotes DESCRIPTION file (#902, @jimhester). See vignette(\"dependencies\") details. install_*() detects called Bioconductor package , automatically includes Bioconductor repositories needed (#895, @jimhester). install_deps() now automatically upgrades date dependencies. typically want ’re working development version package. suppress behaviour, set upgrade_dependencies = FALSE (#863). install_deps() careful ... - means additional arguments install_* likely work (#870). install_gitorious() removed since gitorious longer exists (#913). load_all() longer fails useDynLib() entry NAMESPACE incorrect. make easy recover incorrect @useDynLib, re-documenting() now succeed. release() works packages located root git repository (#845, #846, @mbjones). revdep_check() now installs suggested packages default (#808), sets NOT_CRAN env var false (#809). makes testing similar CRAN packages pass cleanly. also sets RGL_USE_NULL true stop rgl windows popping testing (#897). also downloads source packages beginning - makes life bit easier ’re flaky internet connection (#906). New uninstall() removes installed package (#820, @krlmlr). Add use_coverage() function add codecov.io coveralls.io project, deprecate use_coveralls() (@jimhester, #822, #818). use_cran_badge() uses canonical url form preferred CRAN. use_data() also works data parent frame (#829, @krlmlr). use_git_hook() now creates .git/hooks needed (#888) GitHub integration extended: use_github() gains protocol argument (ssh https), populates URL BugReports fields DESCRIPTION (non-existent empty), pushes newly created GitHub repo, sets remote tracking branch. use_github_links() new exported function. dr_github() diagnoses possible problems. (#642, @jennybc). use_travis(): Default travis script leaves notifications default settings. uses_testthat() check_failures() now exported (#824, #839, @krlmlr). use_readme_rmd() uses uses_git() correctly (#793). with_debug() now uses with_makevars() rather with_env(), R reads compilation variables Makevars rather environment (@jimhester, #788). Properly reset library path with_lib() (#836, @krlmlr). remove_s4classes() performs topological sort classes (#848, #849, @famuvie). load_all() warns (instead failing) importing symbols, methods, classes NAMESPACE fails (@krlmlr, #921).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-180","dir":"Changelog","previous_headings":"","what":"devtools 1.8.0","title":"devtools 1.8.0","text":"CRAN release: 2015-05-09","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"helpers-1-8-0","dir":"Changelog","previous_headings":"","what":"Helpers","title":"devtools 1.8.0","text":"New dr_devtools() runs common diagnostics: using latest version R devtools? run automatically release() (#592). use_code_of_conduct() adds contributor code conduct http://contributor-covenant.org. (#729) use_coveralls() allows easily add test coverage coveralls (@jimhester, #680, #681). use_git() sets package use git, initialising repo checking existing files. use_test() adds new test file (#769, @krlmlr). New use_cran_badge() adds CRAN status badge can copy README file. Green indicates package CRAN. Packages yet submitted accepted CRAN get red badge.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"package-installation-and-info-1-8-0","dir":"Changelog","previous_headings":"","what":"Package installation and info","title":"devtools 1.8.0","text":"build_vignettes() automatically installs VignetteBuilder package, necessary (#736). install() install_deps() gain ... argument, additional arguments can passed utils::install.packages() (@jimhester, #712). install_svn() optionally accepts revision (@lev-kuznetsov, #739). install_version() now knows look multiple repos (#721). package_deps() (dev_package_deps()) determines recursive dependencies whether ’re --date (#663). Use update(package_deps(\"xyz\")) update date dependencies. code used install_deps() revdep_check() - ’s slightly aggressive previous code (.e. forces use latest version), avoid problems go submit CRAN. New update_packages() install package (dependencies) missing date (#675). session_info() can now take vector package names, case print version packages dependencies (#664).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"git-and-github-1-8-0","dir":"Changelog","previous_headings":"","what":"Git and github","title":"devtools 1.8.0","text":"Devtools now uses git2r package inspect git properties install remote git packages install_git(). considerably reliable previous strategy involves calling command line git client. two small downsides: install_git() longer accepts additional args, must deep clone installing. dr_github() checks common problems git/github setup (#643). use git, release() now warns uncommited changes, ’ve forgotten synchronise remote (#691). install_github() warns repository contains submodules (@ashander, #751).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-and-minor-improvements-1-8-0","dir":"Changelog","previous_headings":"","what":"Bug fixes and minor improvements","title":"devtools 1.8.0","text":"Previously, devtools ran external R processes R --vanilla. Now suppresses user profiles, constructs custom .Rprofile override default. Currently, .Rprofile sets repos option. Among others, enables cyclic dependency check devtools::release (#602, @krlmlr). R_BROWSER R_PDFVIEWER environment variables set “false” suppress random windows opening checks. Devtools correctly identifies RTools 3.1 3.2 (#738), preserves continuation lines DESCRIPTION (#709). dev_help() now uses normalizePath(). Hopefully make likely work ’re windows space path. lint() gains cache argument (@jimhester, #708). Fixed namespace issues related stats::setNames() (#734, #772) utils::unzip() (#761, @robertzk). release() now reminds check existing CRAN check results page (#613) shows file size uploading CRAN (#683, @krlmlr). RCMD() system_check() now exported can used packages. (@jimhester, #699). revdep_check() creates directories needed (#759). system_check() combines arguments , ,. (#753) test() gains ... argument additional arguments can passed testthat::test_dir (@jimhester, #747) use_travis() now suggests link svg icon since looks little sharper. Default template sets CRAN: http://cran.rstudio.com/ enable cyclic dependency check. NOT_CRAN envvar longer overrides externally set variable. check(check_version = TRUE) also checks spelling DESCRIPTION; spell checker installed, warning given (#784, @krlmlr).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-170","dir":"Changelog","previous_headings":"","what":"devtools 1.7.0","title":"devtools 1.7.0","text":"CRAN release: 2015-01-17","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"improve-reverse-dependency-checking-1-7-0","dir":"Changelog","previous_headings":"","what":"Improve reverse dependency checking","title":"devtools 1.7.0","text":"Devtools now supports new improved style revdep checking use_revdep(). creates new directory called revdep contains check.R template. Run template check reverse dependencies, save summarised results check/summary.md. can check file git, making much easier track reverse dependency results change versions. documentation revdep_check() much improved, useful (#635) recommend specify library use checking options(\"devtools.revdep.libpath\"). (directory already exists). difference default library keep revdep environment isolated development environment. ’ve also tweaked output revdep_maintainers() ’s easier copy paste email (#634). makes life little easier pre-release.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-helpers-1-7-0","dir":"Changelog","previous_headings":"","what":"New helpers","title":"devtools 1.7.0","text":"lint() runs lintr::lint_package() check style consistency errors package. (@jimhester, #694) use_appveyor() sets package testing AppVeyor (@krlmlr, #549). use_cran_comments() creates cran-comments.md template adds .Rbuildignore help CRAN submissions. (#661) use_git_hook() allows easily add git hook package. use_readme_rmd() sets template generate README.md README.Rmd knitr.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-1-7-0","dir":"Changelog","previous_headings":"","what":"Minor improvements","title":"devtools 1.7.0","text":"Deprecated doc_clean argument check() removed. Initial package version create() now 0.0.0.9000 (#632). create() create_description() checks package name valid (#610). load_all() runs roxygen2::update_collate() loading code. ensures files sourced way expect, defined roxygen @include tags. don’t @include tags, collate touched (#623). session_info() gains include_base argument also display loaded/attached base packages (#646). release() longer asks ’ve read CRAN policies since CRAN submission process now asks question (#692). release(check = TRUE) now runs additional custom checks. include: Checking don’t depend development version package. Checking version number exactly three components (#633). release() now builds packages without ---manual switch, checking actually building release package (#603, @krlmlr). build() gains additional argument manual, defaulting FALSE, check() gains ... unmodified build(). use_travis() now sets environment variable WARNING also cause build fail (#570). with_debug() compiler_flags() set CFLAGS etc instead PKG_CFLAGS. PKG_* packages use, raw values users set. (According http://cran.rstudio.com/doc/manuals/r-devel/R-exts.html#Using-Makevars) New setup() works like create() assumes existing, necessarily empty, directory (#627, @krlmlr).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-1-7-0","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 1.7.0","text":"installing pull request, install_github() now uses repository associated pull request’s branch (repository user created pull request) (#658, @krlmlr). missing_s3() works (#672) Fixed scoping issues unzip(). load_code() now executes package’s code package’s root working directory, just like R CMD build et al. (#640, @krlmlr).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-161","dir":"Changelog","previous_headings":"","what":"devtools 1.6.1","title":"devtools 1.6.1","text":"CRAN release: 2014-10-07 Don’t set non-portable compiler flags Solaris. file template.Rproj now correctly installed function use_rstudio works . (#595, @hmalmedal) function use_rcpp now create file src/.gitignore correct wildcards. (@hmalmedal) functions test, document, load_all, build, check function applies package directory work subdirectories package (like “R” “inst/tests” directories). (#616, @robertzk)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-16","dir":"Changelog","previous_headings":"","what":"devtools 1.6","title":"devtools 1.6","text":"CRAN release: 2014-09-23","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"tool-templates-and-create-1-6","dir":"Changelog","previous_headings":"","what":"Tool templates and create()","title":"devtools 1.6","text":"create() longer generates man/ directory - roxygen2 now automatically. also longer generates package-level doc template. want , use use_package_doc(). also makes dummy namespace can build & reload without running document() first. New use_data() makes easy include data package, either data/ (exported datasets) R/sysdata.rda (internal data). (#542) New use_data_raw() creates data-raw/ directory reproducible generation data/ files (#541). New use_package() allows set dependencies (#559). New use_package_doc() sets Roxygen template package-level docs. New use_rcpp() sets package use Rcpp. use_travis() now figures github username repo can construct markdown build image. (#546) New use_vignette() creates draft vignette using Rmarkdown (#572). renamed add_rstudio_project() use_rstudio(), add_travis() use_travis(), add_build_ignore() use_build_ignore(), add_test_infrastructure() use_testthat() (old functions aliased new)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"the-release-process-1-6","dir":"Changelog","previous_headings":"","what":"The release process","title":"devtools 1.6","text":"can add arbitrary extra questions release() defining function release_questions() package. release_questions() return character vector questions ask (#451). release() uses new CRAN submission process, implemented submit_cran() (#430).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"package-installation-1-6","dir":"Changelog","previous_headings":"","what":"Package installation","title":"devtools 1.6","text":"install_* now use code store much useful metadata. Currently session_info() takes advantage information, allow development future tools like generic update functions. Vignettes longer installed default potentially require suggested packages also installed. Use build_vignettes = TRUE force building install suggested packages (#573). install_bitbucket() bought alignment install_github(): means can now specify repos compact username/repo@ref syntax. username now deprecated. install_git() simplified many arguments changed names consistency metadata package installs. install_github() considerably improved: username deprecated - please include user repo name: rstudio/shiny, hadley/devtools etc. dependencies = TRUE longer forced (regression 1.5) (@krlmlr, #462). Deprecated parameters auth_user, branch, pull password removed. New host argument allows install packages github enterprise (#410, #506). GitHub API used download archive file (@krlmlr, #466) - makes less likely break future. download specified pull request, use ref = github_pull(...) (@krlmlr, #509). install latest release, use \"user/repo@*release\" ref = github_release() (@krlmlr, #350). install_gitorious() bought alignment install_github(): means can now specify repos compact username/repo@ref syntax. must now always supply user (project) name repo. install_svn() lets install R package subversion repository (assuming subversion installed). decompress() hence install_url() now work downloaded file decompresses without additional top-level directory (#537).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"other-minor-improvements-and-bug-fixes-1-6","dir":"Changelog","previous_headings":"","what":"Other minor improvements and bug fixes","title":"devtools 1.6","text":"’re using RStudio, ’re trying build binary package without necessary build tools, RStudio prompt download install right thing. (#488) Commands longer run LC_ALL=C - longer seems necessary (#507). build(binary = TRUE) creates even--temporary package library avoid conflicts (#557). check_dir() longer fails UNC paths (#522). check_devtools() also checks dependencies development versions packages (#534). load_all() longer fails partial loading package containing S4 RC classes (#577). windows, find_rtools() now run package load, package attach. help(), ?, system.file() now made available package loaded load_all(), even devtools package isn’t attached. httr 0.3 required (@krlmlr, #466). load_all() longer gives error objects listed exports missing. Shim added library.dynam.unload(). loaded_packages() now returns package name path loaded . (#486) parenvs() function removed devtools, now pryr package. missing_s3() uses better heuristic determining function S3 method (#393). New session_info() provides useful information R session. ’s little focussed sessionInfo() includes packages installed (#526). rstudioapi package moved suggests imports, since ’s always needed (’s job figure rstudio available, #458) Implemented version utils::unzip() throws error command fails doesn’t print unneeded messages non-Windows platforms (#540). Wrote version write.dcf() doesn’t butcher whitespace fieldnames.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"removed-functionality-1-6","dir":"Changelog","previous_headings":"","what":"Removed functionality","title":"devtools 1.6","text":"fresh argument test() removed - best done editor since can run tests completely clean environment starting new R session. compile_dll() can now build packages located R’s tempdir() directory (@richfitz, #531).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-15","dir":"Changelog","previous_headings":"","what":"devtools 1.5","title":"devtools 1.5","text":"CRAN release: 2014-04-07 Four new functions make easier add useful infrastructure packages: add_test_infrastructure() create test infrastructure new package. called automatically test() test directories found, session interactive agree. add_rstudio_project() adds RStudio project file package. create() gains rstudio argument automatically create RStudio project package directory. defaults TRUE: don’t use RStudio, just delete file. add_travis() adds basic travis template package. .travis.yml automatically added .Rbuildignore avoid including built package. add_build_ignore() makes easy add files .Rbuildignore, correctly escaping special characters Two dependencies incremented: devtools requires least R version 3.0.2. document() requires least roxygen2 version 3.0.0.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-1-5","dir":"Changelog","previous_headings":"","what":"Minor improvements","title":"devtools 1.5","text":"build_win() now builds R-release R-devel default (@krlmlr, #438). also gains parameter args, passed build() (@krlmlr, #421). check_doc() now runs document() automatically. install() gains thread argument allows install multiple packages parallel (@mllg, #401). threads argument check_cran() now defaults getOption(\"Ncpus\") install_deps(deps = T) longer installs dependencies dependencies (#369). install_github() now prefers personal access tokens supplied auth_token rather passwords (#418, @jeroenooms). install_github() now defaults dependencies = TRUE definitely get packages need build source. devtools supplies version system.file() function called R console, special behavior packages loaded devtools. devtools supplies version help ?, search devtools-loaded packages well normally-loaded packages.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-1-5","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 1.5","text":"check_devtools() longer called check() relevant functionality now included R CMD CHECK causing false positives (#446). install_deps(TRUE) now includes packages listed VignetteBuilder (#396) build() longer checks pdflatex building vignettes, many modern vignettes don’t need (#398). also uses ---build-vignettes >3.0.0 compatibility (#391). release() better job opening email client ’re inside RStudio (#433). check() now correctly reports location R CMD   check output called custom check_dir. (Thanks @brentonk) check_cran() records check times package tested. Improved default DESCRIPTION file created create_description(). (Thanks @ncarchedi, #428) Fixed bug install_github() prevented installing pull request supplying repo = \"username/repo#pull\". (#388) explicitly specify user agent querying user name ref pull request install_github. (Thanks Kirill Müller, #405) install_github() now removes blank lines found package DESCRIPTION file, protecting users vague error: contains blank line error. (#394) with_options() now works, instead throwing error (Thanks @krlmlr, #434)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-141","dir":"Changelog","previous_headings":"","what":"devtools 1.4.1","title":"devtools 1.4.1","text":"CRAN release: 2013-11-27 Fixed bug wd() path omitted. (#374) Fixed bug dev_help() prevented working using RStudio. source_gist() respects new github policy sending user agent (hadley/devtools) install_github() now takes repo names form [username/]repo[/subdir][@ref|#pull] - now recommended form specify username, subdir, ref /pull install_github. (Thanks Kirill Müller, #376)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-14","dir":"Changelog","previous_headings":"","what":"devtools 1.4","title":"devtools 1.4","text":"CRAN release: 2013-11-20","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"installation-improvements-1-4","dir":"Changelog","previous_headings":"","what":"Installation improvements","title":"devtools 1.4","text":"install() now respects global option keep.source.pkgs. install() gains build_vignettes defaults TRUE, ensures vignettes built even local install. forcing local = FALSE package vignettes, R CMD build can follow usual process. (#344) install_github() now takes repo names form username/repo - now recommended form install_github username hadley ;) install_github() now adds details source installed package (e.g. repository, SHA1, etc.) package DESCRIPTION file. (Thanks JJ Allaire) Adjusted install_version() new meta data structure CRAN. (Thanks Kornelius Rohmeyer) Fixed bug install_version() works version numbers contain hyphens. (Thanks Kornelius Rohmeyer) install_deps() now exported, making easier install dependencies package.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"other-minor-improvements-1-4","dir":"Changelog","previous_headings":"","what":"Other minor improvements","title":"devtools 1.4","text":"build(binary = TRUE) now longer installs package side-effect. (#335) build_github_devtools() new function makes easy Windows users upgrade development version devtools. create_description() better job combining defaults user specified options. (#332) install() also installs dependencies required versions; besides, argument dependencies now works like install.packages() (previous versions, essentially c(\"Depends\", \"Imports\", \"LinkingTo\")) (thanks, Yihui Xie, #355) check() check_cran() gain new check_dir argument control checking takes place (#337) check_devtools() longer incorrectly complains vignettes/ directory Decompression zip files now respects getOption(\"unzip\") (#326) dev_help now use RStudio help pane, ’re using recent version RStudio (#322) Release now little bit smarter: ’s new package, ’ll ask read agree CRAN policies; ask dependencies . source_url() (source_gist()) accept SHA1 prefixes. source_gist() uses GitHub API reliably locate raw gist. Additionally now attempts source files .R .r extensions, gains quiet argument. (#348) Safer installation source packages, previously extracted directly temp directory; problem directory names collide. Instead, source packages now extracted unique subdirectories.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-13","dir":"Changelog","previous_headings":"","what":"devtools 1.3","title":"devtools 1.3","text":"CRAN release: 2013-07-04","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"changes-to-best-practices-1-3","dir":"Changelog","previous_headings":"","what":"Changes to best practices","title":"devtools 1.3","text":"documentation many devtools functions considerably expanded, aiming give novice package developer hints . load_all() now defaults reset = TRUE changes NAMESPACE etc. incorporated. makes slightly slower (hopefully noticeably ), generally accurate, better simulation install + restart + reload cycle. test() now looks inst/test tests/testthat unit tests. recommended use tests/testthat allows users choose whether install test. move tests inst/tests tests/testthat, ’ll also need change tests/test-.R run test_check() instead test_package(). change requires testthat 0.8 available CRAN shortly. New devtools guarantee: devtools bug, CRAN maintainer yells , ’ll send hand-written apology note. Just forward email address.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-3","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 1.3","text":"New install_local() function installing local package files (zip, tar, tgz, etc.) (Suggested landroni) parse_deps(), parses R’s package dependency strings, now exported. package user events (e.g. load, unload, attach detach) now called correct place.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-bug-fixes-1-3","dir":"Changelog","previous_headings":"","what":"Minor improvements and bug fixes","title":"devtools 1.3","text":"build() gains args parameter allowing add additional arbitrary arguments, check() gains similar build_args parameter. install_git gains git_arg parameter allowing add arbitrary additional arguments. Files now loaded way preserves srcreferences - means get much better locations error messages, considerably aid debugging. Fixed bug build_vignettes() prevented files inst/doc updated .package() longer uses full path, make nicer error messages. flexibility installing package dependencies dependencies argument install_*() (thanks Martin Studer) deprecated show_rd() function now removed. install_bitbucket() gains auth_user password params can install private repos (thanks Brian Bolt) Better git detection windows (thanks Mikhail Titov) Fix bug document() automatically create man/ directory Default DESCRIPTION gains LazyData: true create_description() now checks directory probably package looking R/, data/ src/ directories Rolled back required R version 3.0 2.15. Add missing import digest() Bump max compatible version R RTools 3.0, add details RTools 3.1","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-12","dir":"Changelog","previous_headings":"","what":"devtools 1.2","title":"devtools 1.2","text":"CRAN release: 2013-04-17","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"better-installation-1-2","dir":"Changelog","previous_headings":"","what":"Better installation","title":"devtools 1.2","text":"install gains local option installing package local package directory, rather built tar.gz. now used default package installations. want guarantee clean build, run local = FALSE install now uses option devtools.install.args default installation arguments. allows set useful defaults (e.g. ---multiarch) Rprofile. install_git gains branch argument specify branch tag (Fixes #255)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"clean-sessions-1-2","dir":"Changelog","previous_headings":"","what":"Clean sessions","title":"devtools 1.2","text":"run_examples test gain fresh argument forces run fresh R session. completely insulates examples/tests current session means interactive code (like browser()) won’t work.(Fixes #258) New functions eval_clean evalq_clean make easy evaluate code clean R session. clean_source loses vanilla argument (work) gains quiet argument","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-2","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 1.2","text":"source_url source_gist now allow specify sha, can make sure files source internet don’t change without knowing . (Fixes #259) build_vignettes builds using buildVignette() movies/copies outputs using algorithm R CMD build. means build_vignettes() now exactly mimics R’s regular behaviour, including building non-Sweave vignettes (#277), building correct directory (#231), using make files (present), copying extra files. devtools now sets best practice compiler flags: check(), -Wall -pedantic load_all(), -Wall -pedantic -g -O0 -UNDEBUG. prefixed existing environment variables can override desired. (Fixes #257) ’s DESCRIPTION file present, load_all() automatically create one using create_description(). can set options .Rprofile control contains: see package?devtools details.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-1-2","dir":"Changelog","previous_headings":"","what":"Minor improvements","title":"devtools 1.2","text":"check() now also sets environment variable _R_CHECK_CODE_DATA_INTO_GLOBALENV_ TRUE (match current ---cran behaviour) (Fixes #256) Improved default email sent release(), eliminating create.post() boilerplate revdep includes LinkingTo default. Fixed regular expression problem caused RTools 3.0.* fail found Windows. load_data() got overhaul now respects LazyData correctly exports datasets default (Fixes #242) with_envvar gains option either replace, prefix suffix existing environmental variables. default replace, previous behaviour. check_cran includes sessionInfo() summary output (Fixes #273) create() gains check argument defaults FALSE. with_env deprecated 1.2 removed 1.3 load_all() calls .onAttach() .onLoad(), now passes lib path functions.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-11","dir":"Changelog","previous_headings":"","what":"devtools 1.1","title":"devtools 1.1","text":"CRAN release: 2013-02-09 source_gist() updated accept new gist URLs username. (Fixes #247) test() document() now set environment variables, including NOT_CRAN. Test packages renamed avoid conflicts existing packages CRAN. bug prevented devtools 1.0 passing check CRAN platforms. Catch additional case find_rtools(): previously installed, directory empty/deleted (Fixes #241)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-10","dir":"Changelog","previous_headings":"","what":"devtools 1.0","title":"devtools 1.0","text":"CRAN release: 2013-01-22","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"improvements-to-package-loading-1-0","dir":"Changelog","previous_headings":"","what":"Improvements to package loading","title":"devtools 1.0","text":"Rcpp attributes now automatically compiled build. Packages listed depends require()d (Fixes #161, #178, #192) load_all inserts special version system.file package’s imports environment. tries simulate behavior base::system.file gives modified results directory structure installed packages uninstalled source packages different. (Fixes #179). words, system.file now just work even package loaded devtools. Source files recompiled ’ve changed since last run, recompile clean (--preclean) exported header files changed. (Closes #224) compilation process now performs mock install instead using R CMD SHLIB. means Makevars makefiles now respected generally fewer mismatches load_all regular install reload process. S4 classes correctly loaded unloaded.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"windows-1-0","dir":"Changelog","previous_headings":"","what":"Windows","title":"devtools 1.0","text":"Rtools detection windows substantially overhauled reliable, fails give information wrong install. don’t rtools installed, devtools now automatically sets TAR environment variable internal can still build packages.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-features-1-0","dir":"Changelog","previous_headings":"","what":"Minor features","title":"devtools 1.0","text":"check_cran now downloads packages cran.rstudio.com. check() now makes CRAN version check optional, default. release() function still checks version number CRAN. check(), optional require suggested packages, using force_suggests option. check() called, new default behavior delete existing .Rd files man/. behavior can set “devtools.cleandoc” option. install_bitbucket() now always uses lowercase repo names. (Thanks mnel) New function with_lib(), runs expression code library path prepended existing libpaths. differs slightly with_libpaths(), replaces existing libpaths. New function install_git() installs package directly git repository. (Thanks David Coallier) pdflatex isn’t available, don’t try build vignettes install() check(). (Fixes #173) install_github() now downloads new URL, reflect changes files hosted GitHub. build() now vignettes option turn rebuilding vignettes. install(quick=TRUE) now builds package without rebuilding vignettes. (Fixes #167) R commands called devtools now environment variable NOT_CRAN set, can perform tasks know code definitely running CRAN. (Closes #227) devtools functions can quiet argument suppresses output. particularly useful testing.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-1-0","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 1.0","text":"Fixed path issue looking Rtools windows registry entry present. (Fixes #201) Reloading package requires forced-unload namespace now works. reloading package another loaded package depends , error loading code, devtools print something error unloadNamespace, confusing. now gives useful errors. intermittent error clear_topic_index related using rm() fixed. (Thanks Gregory Jefferis) revdep() now lists “Suggests” packages, addition “Depends” “Imports”. revdep_check() now correctly passes recursive argument revdep(). collection check results end check_cran() previously remove existing results, now . package loaded load_all(), now passes name package .onLoad() function. (Thanks Andrew Redd)","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-0-8-0","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 0.8.0","text":"create function makes easier create package skeleton using devtools standards. install_github() can now install pull request – installs branch referenced pull request. install_github now accepts auth_user password arguments want install package private github repo. need specify auth_user ’s package (.e. ’s username) (Fixes #116) new dev_help function replaces show_rd makes easy get help topic development package (.e. package loaded load_all) (Fixes #110) dev_example runs examples one -development package. (Fixes #108) build_vignettes now looks modern location vignettes (vignettes/) warn vignettes found old location (inst/doc). Building now occurs temporary directory (avoid polluting package build artefacts) final pdf files copied . new clean_vignettes function remove pdfs inst/doc built vignettes vignettes/ load_all much better job simulating package loading (see LOADING section). also compiles loads C/C++/Fortran code. unload() now exported function, unloads package, trying harder just detach. now also unloads DLLs. (Winston Chang. Fixes #119) run_examples now parameters show, test, run control \\dontrun{}, \\dontshow{}, \\donttest{} \\testonly{} commented . strict parameter removed since longer necessary load_all can respect namespaces. (Fixes #118) build(), check(), install() etc now run R --vanilla mode prevents reading site personal configuration files. prevent inconsistencies environment package run computer computers (e.g. CRAN server) (Fixes #145) system R command now print full command used make easier understand ’s going .","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"package-paths-0-8-0","dir":"Changelog","previous_headings":"","what":"Package paths","title":"devtools 0.8.0","text":".package longer uses ~/.Rpackages. .package provides informative error messages path exist, isn’t directory, doesn’t contain DESCRIPTION file. New function inst() takes name package returns installed path package. (Winston Chang. Fixes #130). makes possible use devtools functions (e.g. unload) regular installed packages, just -development source packages. New function devtest() returns paths internal testing packages devtools.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"loading-0-8-0","dir":"Changelog","previous_headings":"","what":"Loading","title":"devtools 0.8.0","text":"Development packages now loaded namespace environment, , objects namespace copied package environment, . accurately simulates packages normally loaded. However, objects (just exported ones) still copied package environment. (Winston Chang. Fixes #3, #60, #125) Packages listed Imports Depends now loaded imports environment, name attribute “imports:xxxx”, parent namespace environment. imports environment turn child NAMESPACE file now used loading imports, instead DESCRIPTION file. Previously, load_all loaded objects packages listed DESCRIPTION. Now loads packages (, ‘importFrom’ used, specific objects packages) listed NAMESPACE. closely simulates normal package loading. still checks version numbers packages listed DESCRIPTION. (Winston Chang) load_all can now used properly reload devtools. creating copy devtools namespace environment, calling load_all environment. (Winston Chang) .onLoad .onAttach functions development package now called loading package first time, reset=TRUE, order correctly simulates normal package loading (create namespace, call .onLoad, copy objects package environment, call .onAttach). (Winston Chang) load_all now throw warning dependency package satisfy version requirement listed DESCRIPTION. (Winston Chang. Fixes #109) package environment now ‘path’ attribute, similar package loaded normal way. (Winston Chang) load_all now option export_all. set TRUE, objects listed exports NAMESPACE exported. (Winston Chang) load_all now compiles C files /src directory. (Winston Chang) New functions compile_dll() clean_dll(), compile C/C++/ Fortran source code, clean compiled objects, respectively. (Winston Chang. Fixes #131)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-0-8-0","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 0.8.0","text":"load_code now properly skips missing files. (Winston Chang) Add ---resave-data default build command. subject line email created release now “CRAN submission [package] [version]”, per CRAN repository policy. install_bitbucket properly installs zip files projects stored Mercurial repositories. (Winston Chang. Fixes #148) build now builds vignettes install . (Fixes #155)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"introspection-0-8-0","dir":"Changelog","previous_headings":"","what":"Introspection","title":"devtools 0.8.0","text":"New function loaded_packages(), returns names packages loaded attached. Packages loaded load_all now store devtools metadata namespace environment, variable called .__DEVTOOLS__. can accessed dev_meta function. (Winston Chang. Fixes #128) dev_mode now stores path uses option dev_path. makes easy applications detect act accordingly. New function parse_ns_file(), parses NAMESPACE file package. New function parenvs(), parents parent environments object. (Winston Chang)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-071","dir":"Changelog","previous_headings":"","what":"devtools 0.7.1","title":"devtools 0.7.1","text":"CRAN release: 2012-07-02 bump dependency R 2.15 load_code now also looks files ending .q - recommended, needed older packages","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-07","dir":"Changelog","previous_headings":"","what":"devtools 0.7","title":"devtools 0.7","text":"CRAN release: 2012-06-19","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"installation-0-7","dir":"Changelog","previous_headings":"","what":"Installation","title":"devtools 0.7","text":"install_bitbucket installs R packages bitbucket. install now uses ---keep.source make debugging little easier. remote install functions give better error messages case http errors (Fixes #82). install new quick option make package installation faster, sacrificing documentation, demos multi-architecture binaries. (Fixes #77) install_url, install_github install_gitorious gain subdir argument makes possible install packages contained within sub-directory repository compressed file. (Fixes #64)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"checking-0-7","dir":"Changelog","previous_headings":"","what":"Checking","title":"devtools 0.7","text":"with_debug function temporarily sets env vars compilation performed appropriate debugging flags set. Contributed Andrew Redd. revdep, revdep_maintainers revdep_check calculating reverse dependencies, finding maintainers running R CMD check. (Fixes #78) check_cran received massive overhaul: now checks multiple packages, installs dependencies (user specified library), parse check output extract errors warnings check uses new ---cran option make checking close CRAN possible (fixes #68)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"other-new-features-0-7","dir":"Changelog","previous_headings":"","what":"Other new features","title":"devtools 0.7","text":"devtools now uses options devtools.path set default path use devmode, github.user set default user installing packages github. package supplied, package worked previously, functions now try working directory. (Fixes #87) windows, devtools now looks registry find Rtools installed, better job locating gcc. (Contributed Andrew Redd) show_rd passes ... Rd2txt - useful ’re checking build time \\Sexprs generated. suite functions allow temporarily alter environment code run: in_dir, with_collate, with_locale, with_options, with_path, … (Fixes #89) release ask questions randomises correct answers really need read (Fixes #79) source_gist now accepts default url “https://gist.github.com/nnn” New system path manipulation functions, get_path, set_path, add_path on_path, contributed Andrew Redd. ’re windows, devtools now suppresses unimportant warning CYGWIN dos style file paths","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-0-7","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 0.7","text":"decompress now uses target directory defined function call expanding compressed file. (Fixes #84) document always run C locale NAMESPACE sort order consistent across platforms. install now quotes libpath build path paths embedded spaces work (Fixes #73 #76) load_data now also loads .RData files (Fixes #81) install now args argument pass additional command line arguments R CMD install (replaces ... didn’t actually anything). (Fixes #69) load_code better job reconciling files DESCRIPTION collate files actually exist R directory. (Fixes #14)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-06","dir":"Changelog","previous_headings":"","what":"devtools 0.6","title":"devtools 0.6","text":"CRAN release: 2012-02-28","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-0-6","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 0.6","text":"test function takes filter argument allows restrict tests run check runs example timings, done CRAN. Run new param cleanup = F access timings. missing_s3 function help figure ’ve forgotten export s3 methods check_cran downloads checks CRAN package - useful run part testing process package want check dependencies package strict mode run_examples runs example clean environment. much slower default (running current environment), ensures example works standalone. dev_mode now updates prompt indicate ’s active (Thanks Kohske Takahashi) new source_url function sourcing script remote server via protocols http (e.g. https ftp). (Thanks Kohske Takahashi) new source_gist function source R code stored github gist. (Thanks Kohske Takahashi) load_all now also loads package dependencies (including suggestions) - works around bugs way devtools attaches development environment search path way fails recreate happens normally package loading.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"installation-0-6","dir":"Changelog","previous_headings":"","what":"Installation","title":"devtools 0.6","text":"remote installation ensure configure file executable. external package installation functions vectorised can install multiple packages time new install_gitorious function install packages gitorious repos. new install_url function installing package arbitrary url include install_version function Jeremy Stephens installing specific version CRAN package archive.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"better-windows-behaviour-0-6","dir":"Changelog","previous_headings":"","what":"Better windows behaviour","title":"devtools 0.6","text":"better check OS type (thanks Brian Ripley) better default paths 64-bit R windows (Fixes #35) check see Rtools already available trying mess paths. (Fixes #55)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-0-6","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 0.6","text":"error occurs calling loading R files, cache automatically cleared files loaded next time try (Fixes #55) functions run R now R_LIBS set current .libPaths() - ensure checking uses development library development mode. R_ENVIRON_USER set empty file avoid existing settings overriding . load_data (called load_all) also load data defined R files data directory. (Fixes #45) dev_mode performs basic tests make sure ’re setting development library directory ’s already R library. (Fixes #25)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-051","dir":"Changelog","previous_headings":"","what":"devtools 0.5.1","title":"devtools 0.5.1","text":"CRAN release: 2011-12-07 Fix error causing R commands fail windows.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-05","dir":"Changelog","previous_headings":"","what":"devtools 0.5","title":"devtools 0.5","text":"CRAN release: 2011-12-04","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-functions-0-5","dir":"Changelog","previous_headings":"","what":"New functions","title":"devtools 0.5","text":"new show_rd function show development version help file.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"improvements-and-bug-fixes-0-5","dir":"Changelog","previous_headings":"","what":"Improvements and bug fixes","title":"devtools 0.5","text":"external R commands always run locale C, ’s CRAN severs . clean_source sources R script fresh R environment, ensuring can run independently current working environment. Optionally (vanilla = T), source vanilla R environment ignores local environment settings. windows, devtools also add path mingw startup. (Thanks pointer Dave Lovell)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-04","dir":"Changelog","previous_headings":"","what":"devtools 0.4","title":"devtools 0.4","text":"CRAN release: 2011-07-23","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-functions-0-4","dir":"Changelog","previous_headings":"","what":"New functions","title":"devtools 0.4","text":"new wd function change working directory package subdirectory. check_doc now checks package documentation whole, way R CMD check , rather low-level syntax checking, done roxygen2. DESCRIPTION checking moved intoload_all.check_rd` removed. build now exported, defaults building package’s parent directory. also gains new binary parameter controls whether binary source version (vignettes manuals) built. Confusingly, binary packages built R CMD INSTALL. build_win sends package R windows builder, allowing make binary version package windows users ’re using linux macOS (’re using windows already, use build(binary = T))","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"improvements-and-bug-fixes-0-4","dir":"Changelog","previous_headings":"","what":"Improvements and bug fixes","title":"devtools 0.4","text":"using .Rpackages config file, default function used last, first. Windows, devtools now checks presence Rtools startup, automatically add path needed. document uses roxygen2 instead roxygen. now loads package dependency ’re available roxygen executes package source code. document new parameter clean clears roxygen caches removes existing man files. check now runs document mode. dev_mode create directories recursively, complain can’t create . also work better windows. install_github now allows specify branch download, automatically reloads package needed. reload now reload package already loaded. release gains check parameter allows skip package check (’ve just done .) test automatically reloads code never run tests old code","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-03","dir":"Changelog","previous_headings":"","what":"devtools 0.3","title":"devtools 0.3","text":"CRAN release: 2011-06-30 new bash() function starts bash shell package directory. Useful want use git etc. removed inelegant update_src() since now superseded bash() fix bug ftp upload adding extraneous space build function builds package specified directory. install, check release now use function. build, install, check release better cleaning - always try work session temporary directory delete files/directories create","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-02","dir":"Changelog","previous_headings":"","what":"devtools 0.2","title":"devtools 0.2","text":"CRAN release: 2011-06-29 install_github now uses RCurl instead external wget retrieve package. make robust wrt external dependencies. load_all skip missing files warning (thanks suggestion Jeff Laake) check automatically deletes .Rcheck directory successful completion Quote path R works even spaces path.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-01","dir":"Changelog","previous_headings":"","what":"devtools 0.1","title":"devtools 0.1","text":"CRAN release: 2011-06-22 Check presence DESCRIPTION loading packages avoid false positives install now works correctly devel_mode install packages development library release prints news can easily check R CMD xxx functions now use current R, first R found system path.","code":""}]
+[{"path":[]},{"path":"https://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.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://devtools.r-lib.org/dev/CONTRIBUTING.html","id":"contributing-to-devtools","dir":"","previous_headings":"","what":"Contributing to devtools","title":"NA","text":"goal guide help contribute devtools quickly easily possible. guide divided two main pieces: Filing bug report feature request issue. Suggesting change via pull request.","code":""},{"path":"https://devtools.r-lib.org/dev/CONTRIBUTING.html","id":"issues","dir":"","previous_headings":"","what":"Issues","title":"NA","text":"file issue: Check ’re using latest version devtools. ’s quite possible problem ’re experiencing already fixed. Check issue belongs devtools. Much functionality now lives separate packages. Please read list check submitting issue another repo: Building binary packages anything related finding R tools: pkgbuild: Anything related operation load_all(): pkgload. Running R CMD check one package: rcmdcheck. Running R CMD check reverse dependencies: revdepcheck Installing packages: remotes Session info: sessioninfo function starts use_: usethis Spend minutes looking existing issues. ’s possible issue already filed. ’s almost always better open new issue instead commenting existing issue. exception confident issue identical existing problem, contribution help us better understand general case. ’s generally bad idea comment closed issue commit. comments don’t show issue tracker easily misplaced. filing issue, important thing include minimal reproducible example can quickly verify problem, figure fix . three things need include make example reproducible: required packages, data, code. Packages loaded top script, ’s easy see ones example needs. Unless ’ve specifically asked , please don’t include output sessionInfo() devtools::session_info(). easiest way include data use dput() generate R code recreate . example, recreate mtcars dataset R, ’d perform following steps: Run dput(mtcars) R Copy output reproducible script, type mtcars <- paste. even better can create data.frame() just handful rows columns still illustrates problem. Spend little bit time ensuring code easy others read: make sure ’ve used spaces variable names concise, informative use comments indicate problem lies best remove everything related problem. shorter code , easier understand. Learn little markdown can correctly format issue. important thing surround code ``` R ``` ’s syntax highlighted (makes easier read). Check ’ve actually made reproducible example using reprex package.","code":""},{"path":"https://devtools.r-lib.org/dev/CONTRIBUTING.html","id":"pull-requests","dir":"","previous_headings":"","what":"Pull requests","title":"NA","text":"pull request easiest us read use common style: http://r-pkgs..co.nz/r.html#style. Please pay particular attention whitespace. always add bullet point NEWS.md motivating change. look like “changed (@yourusername, #issuenumber)”. Please don’t add headings like “bug fix” “new features” - added release process. can, also write test. Testing devtools particularly difficult devtools functions called side-effects, best can. ’re adding new parameters new function, ’ll also need document roxygen2. Make sure re-run devtools::document() code submitting. pull request process, unless ’re practiced contributor ’s unlikely pull request accepted . Typically process looks like : submit pull request. review high-level determine something want include package. , ’ll close pull request suggest alternative home code. ’ll take closer look code give feedback. respond feedback, update pull request add comment like “PTAL” (please take look). Adding comment important, otherwise don’t get notification pull request ready review. Don’t worry pull request isn’t perfect. ’s learning process ’ll happy help . can frustrating PR ignored months, request whole bunch changes within short time period. Don’t worry - PR doesn’t make release, next one.","code":""},{"path":"https://devtools.r-lib.org/dev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2023 devtools 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://devtools.r-lib.org/dev/MAINTENANCE.html","id":"current-state","dir":"","previous_headings":"","what":"Current state","title":"NA","text":"Devtools generally stable, active development moved sub-packages like remotes usethis, relatively little code lives devtools .","code":""},{"path":"https://devtools.r-lib.org/dev/MAINTENANCE.html","id":"known-outstanding-issues","dir":"","previous_headings":"","what":"Known outstanding issues","title":"NA","text":"don’t know major outstanding issues devtools .","code":""},{"path":"https://devtools.r-lib.org/dev/MAINTENANCE.html","id":"future-directions","dir":"","previous_headings":"","what":"Future directions","title":"NA","text":"package development cheatsheet likely needs major overhaul account much functionality usethis current state devtools. https://github.com/r-lib/devtools/issues/2107 devtools converted use pak installation, installation commands deprecated devtools users suggested use pak directly?","code":""},{"path":"https://devtools.r-lib.org/dev/MAINTENANCE.html","id":"r-cmd-check-notes","dir":"","previous_headings":"","what":"R CMD check notes","title":"NA","text":"devtools vintage tests around .Rnw vignettes. ’s clear makes sense keep , (jennybc) rushing remove tests. Since inherited maintainership devtools, pursued 2 tests fail locally (skipped GHA). However, today, sort want record . case comes future, caused necessary LaTeX package installed:","code":"tinytex::parse_install(   text = \"! LaTeX Error: File `grfext.sty' not found.\" )"},{"path":"https://devtools.r-lib.org/dev/articles/dependencies.html","id":"package-remotes","dir":"Articles","previous_headings":"","what":"Package remotes","title":"Devtools dependencies","text":"Devtools version 1.9 supports package dependency installation packages yet standard package repository CRAN Bioconductor. can mark regular dependency defined Depends, Imports, Suggests Enhances fields installed remote location adding remote location Remotes DESCRIPTION file. cause devtools download install prior installing package (won’t installed CRAN). remote dependencies specified Remotes described following form. type optional parameter. type missing default install GitHub. Additional remote dependencies separated commas, just like normal dependencies elsewhere DESCRIPTION file. important remember must always declare dependency usual way, .e. include Depends, Imports, Suggests Enhances. Remotes field provides instructions install dependency . example DESCRIPTION file, note rlang appears Imports Remotes:","code":"Remotes: [type::]<Repository>, [type2::]<Repository2> Package: xyz Title: What the Package Does (One Line, Title Case) Version: 0.0.0.9000 Authors@R:      person(given = \"First\",            family = \"Last\",            role = c(\"aut\", \"cre\"),            email = \"first.last@example.com\") Description: What the package does (one paragraph). License: MIT + file LICENSE Imports:      rlang Remotes:       r-lib/rlang"},{"path":"https://devtools.r-lib.org/dev/articles/dependencies.html","id":"github","dir":"Articles","previous_headings":"Package remotes","what":"GitHub","title":"Devtools dependencies","text":"GitHub commonly used unofficial package distribution R, ’s default: can also specify specific hash, tag, pull request (using syntax install_github() want particular commit. Otherwise latest commit HEAD branch used. type github can specified, required","code":"Remotes: hadley/testthat Remotes: hadley/httr@v0.4,   klutometis/roxygen#142,   hadley/testthat@c67018fa4970 Remotes: github::hadley/ggplot2"},{"path":"https://devtools.r-lib.org/dev/articles/dependencies.html","id":"other-sources","dir":"Articles","previous_headings":"Package remotes","what":"Other sources","title":"Devtools dependencies","text":"currently supported install sources available, see ‘See Also’ section ?install complete list.","code":"# GitLab Remotes: gitlab::jimhester/covr  # Git Remotes: git::git@bitbucket.org:djnavarro/lsr.git  # Bitbucket Remotes: bitbucket::sulab/mygene.r@default, djnavarro/lsr  # Bioconductor Remotes: bioc::3.3/SummarizedExperiment#117513, bioc::release/Biobase  # SVN Remotes: svn::https://github.com/tidyverse/stringr  # URL Remotes: url::https://github.com/tidyverse/stringr/archive/main.zip  # Local Remotes: local::/pkgs/testthat  # Gitorious Remotes: gitorious::r-mpc-package/r-mpc-package"},{"path":"https://devtools.r-lib.org/dev/articles/dependencies.html","id":"cran-submission","dir":"Articles","previous_headings":"Package remotes","what":"CRAN submission","title":"Devtools dependencies","text":"submit package CRAN, dependencies must also available CRAN. reason, release() warn try release package Remotes field.","code":""},{"path":"https://devtools.r-lib.org/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Hadley Wickham. Author. Jim Hester. Author. Winston Chang. Author. Jennifer Bryan. Author, maintainer. . Copyright holder, funder.","code":""},{"path":"https://devtools.r-lib.org/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Wickham H, Hester J, Chang W, Bryan J (2024). devtools: Tools Make Developing R Packages Easier. R package version 2.4.5.9000, https://github.com/r-lib/devtools, https://devtools.r-lib.org/.","code":"@Manual{,   title = {devtools: Tools to Make Developing R Packages Easier},   author = {Hadley Wickham and Jim Hester and Winston Chang and Jennifer Bryan},   year = {2024},   note = {R package version 2.4.5.9000, https://github.com/r-lib/devtools},   url = {https://devtools.r-lib.org/}, }"},{"path":"https://devtools.r-lib.org/dev/index.html","id":"devtools-","dir":"","previous_headings":"","what":"Tools to Make Developing R Packages Easier","title":"Tools to Make Developing R Packages Easier","text":"aim devtools make package development easier providing R functions simplify expedite common tasks. R Packages book based around workflow.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Tools to Make Developing R Packages Easier","text":"","code":"# Install devtools from CRAN install.packages(\"devtools\")  # Or the development version from GitHub: # install.packages(\"pak\") pak::pak(\"r-lib/devtools\")"},{"path":[]},{"path":"https://devtools.r-lib.org/dev/index.html","id":"usage","dir":"","previous_headings":"","what":"Usage","title":"Tools to Make Developing R Packages Easier","text":"devtools functions accept path argument, e.g. load_all(\"path//mypkg\"). don’t specify path, devtools look current working directory - recommended practice.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"frequent-development-tasks","dir":"","previous_headings":"Usage","what":"Frequent development tasks:","title":"Tools to Make Developing R Packages Easier","text":"load_all() simulates installing reloading package, loading R code R/, compiled shared objects src/ data files data/. development usually want access functions (even un-exported internal ones) load_all() works functions exported package NAMESPACE. document() updates generated documentation man/, file collation NAMESPACE. test() reloads code load_all(), runs testthat tests. test_coverage() runs test coverage package covr. makes easy see parts package use tests!","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"building-and-installing","dir":"","previous_headings":"Usage","what":"Building and installing:","title":"Tools to Make Developing R Packages Easier","text":"install() reinstalls package, detaches currently loaded version reloads new version library(). Reloading package guaranteed work: see documentation unload() caveats. build() builds package file package sources. can use build binary version package. install_* functions install R package: install_github() GitHub install_gitlab() GitLab install_bitbucket() Bitbucket install_url() arbitrary url install_git() install_svn() arbitrary git SVN repository install_local() local file disk install_version() specific version CRAN update_packages() updates package latest version. works packages installed CRAN well installed install_* functions.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"check-and-release","dir":"","previous_headings":"Usage","what":"Check and release:","title":"Tools to Make Developing R Packages Easier","text":"check() updates documentation, builds checks package locally. check_win() checks package using win-builder, check_rhub() checks package using r-hub. allows easily check package systems CRAN uses submission. release() makes sure everything ok package (including asking number questions), builds uploads CRAN.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"learning-more","dir":"","previous_headings":"","what":"Learning more","title":"Tools to Make Developing R Packages Easier","text":"R package development can intimidating, however now number valuable resources help!  R Packages book gives comprehensive treatment common parts package development uses devtools throughout. first edition available https://r-pkgs.org/, note grown somewhat sync current version devtools. second edition development evolving reflect current state devtools. available https://r-pkgs.org. Whole Game Package structure chapters make great places start. RStudio community - package development great place ask specific questions related package development. rOpenSci packages extensive documentation best practices R packages looking contributed rOpenSci, also useful general recommendations package authors. number fantastic blog posts writing first package, including Writing R package scratch - Hilary Parker develop good R packages - Maëlle Salmon Making first R package - Fong Chun Chan Writing R package scratch - Tomas Westlake Writing R Extensions exhaustive, canonical reference writing R packages, maintained R core developers.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"conscious-uncoupling","dir":"","previous_headings":"","what":"Conscious uncoupling","title":"Tools to Make Developing R Packages Easier","text":"devtools started lean--mean package facilitate local package development, years accumulated functionality. devtools undergone conscious uncoupling split functionality smaller, tightly focussed packages. includes: testthat: Writing running tests (.e. test()). roxygen2: Function package documentation (.e. document()). remotes: Installing packages (.e. install_github()). pkgbuild: Building binary packages (including checking build tools available) (.e. build()). pkgload: Simulating package loading (.e. load_all()). rcmdcheck: Running R CMD check reporting results (.e. check()). revdepcheck: Running R CMD check reverse dependencies, figuring ’s changed since last CRAN release (.e. revdep_check()). sessioninfo: R session info (.e. session_info()). usethis: Automating package setup (.e. use_test()). Generally, need worry different packages, devtools installs automatically. need care, however, ’re filing bug reporting correct place lead speedier resolution. may also need care trying use devtools functionality package deployed application. Generally cases better depend particular package directly rather depend devtools, e.g. use sessioninfo::session_info() rather devtools::session_info(), remotes::install_github() vs devtools::install_github(). However day day development recommend continue use library(devtools) quickly load needed development tools, just like library(tidyverse) quickly loads tools necessary data exploration visualization.","code":""},{"path":"https://devtools.r-lib.org/dev/index.html","id":"code-of-conduct","dir":"","previous_headings":"","what":"Code of conduct","title":"Tools to Make Developing R Packages Easier","text":"Please note devtools project released Contributor Code Conduct. contributing project, agree abide terms.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/as.package.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerce input to a package. — as.package","title":"Coerce input to a package. — as.package","text":"Possible specifications package: path package object","code":""},{"path":"https://devtools.r-lib.org/dev/reference/as.package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerce input to a package. — as.package","text":"","code":"as.package(x = NULL, create = deprecated())"},{"path":"https://devtools.r-lib.org/dev/reference/as.package.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerce input to a package. — as.package","text":"x object coerce package create worked time.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/bash.html","id":null,"dir":"Reference","previous_headings":"","what":"Open bash shell in package directory. — bash","title":"Open bash shell in package directory. — bash","text":"Open bash shell package directory.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/bash.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Open bash shell in package directory. — bash","text":"","code":"bash(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/bash.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Open bash shell in package directory. — bash","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":null,"dir":"Reference","previous_headings":"","what":"Build package — build","title":"Build package — build","text":"Building converts package source directory single bundled file. binary = FALSE creates tar.gz package can installed platform, provided full development environment (although packages without source code can typically installed box). binary = TRUE, package platform specific extension (e.g. .zip windows), installable current platform, development environment needed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build package — build","text":"","code":"build(   pkg = \".\",   path = NULL,   binary = FALSE,   vignettes = TRUE,   manual = FALSE,   args = NULL,   quiet = FALSE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build package — build","text":"pkg package use, can file path package package object.  See .package() information. path Path produce package.  NULL, defaults parent directory package. binary Produce binary (--binary) source ( ---manual ---resave-data) version package. vignettes, manual source packages: FALSE, build PDF vignettes (---build-vignettes) manual (---manual). args optional character vector additional command line arguments passed R CMD build binary = FALSE, R CMD install binary = TRUE. quiet TRUE suppresses output function. ... Additional arguments passed pkgbuild::build.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Build package — build","text":"string giving location (including file name) built package","code":""},{"path":[]},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"description-entries","dir":"Reference","previous_headings":"","what":"DESCRIPTION entries","title":"Build package — build","text":"Config/build/clean-inst-doc can set FALSE avoid cleaning inst/doc building source package. Set TRUE force cleanup. See clean_doc argument. Config/build/copy-method can used avoid copying large directories R CMD build. works copying (linking) files package temporary directory, leaving (possibly large) files part package. Possible values: none: pkgbuild copy package tree. default. copy: package files copied temporary directory  R CMD build. link: package files symbolic linked temporary directory R CMD build. Windows symbolic links, Windows equivalent copy. can also use pkg.build_copy_method option PKG_BUILD_COPY_METHOD environment variable set copy method. option consulted first, DESCRIPTION entry, environment variable. Config/build/extra-sources can used define extra source files pkgbuild decide whether package DLL needs recompiled needs_compile(). syntax comma separated list file names, globs. (See utils::glob2rx().) E.g. src/rust/src/*.rs configure*. Config/build/bootstrap can set TRUE run Rscript bootstrap.R source directory prior running subsequent build steps.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"options","dir":"Reference","previous_headings":"","what":"Options","title":"Build package — build","text":"pkg.build_copy_method: use option avoid copying large directories building package. See possible values , Config/build/copy-method DESCRIPTION entry. pkg.build_stop_for_warnings: set TRUE, pkgbuild stop R CMD build errors. takes precedence PKG_BUILD_STOP_FOR_WARNINGS environment variable.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"environment-variables","dir":"Reference","previous_headings":"","what":"Environment variables","title":"Build package — build","text":"PKG_BUILD_COLOR_DIAGNOSTICS: set false opt colored compiler diagnostics. Set true force colored compiler diagnostics. PKG_BUILD_COPY_METHOD: use environment variable avoid copying large directories building package. See possible values , Config/build/copy-method DESCRIPTION entry. stop R CMD build errors. pkg.build_stop_for_warnings option takes precedence environment variable.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Build package — build","text":"default manual = FALSE suitable CRAN submission, may require manual = TRUE.  Even better, use submit_cran() release().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_manual.html","id":null,"dir":"Reference","previous_headings":"","what":"Create package pdf manual — build_manual","title":"Create package pdf manual — build_manual","text":"Create package pdf manual","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_manual.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create package pdf manual — build_manual","text":"","code":"build_manual(pkg = \".\", path = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/build_manual.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create package pdf manual — build_manual","text":"pkg package use, can file path package package object.  See .package() information. path path produce package manual. NULL, defaults parent directory package.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/build_rmd.html","id":null,"dir":"Reference","previous_headings":"","what":"Build a Rmarkdown files package — build_rmd","title":"Build a Rmarkdown files package — build_rmd","text":"build_rmd() wrapper around rmarkdown::render() first installs temporary copy package, renders .Rmd clean R session. build_readme() locates README.Rmd builds README.md","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_rmd.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build a Rmarkdown files package — build_rmd","text":"","code":"build_rmd(files, path = \".\", output_options = list(), ..., quiet = TRUE)  build_readme(path = \".\", quiet = TRUE, ...)"},{"path":"https://devtools.r-lib.org/dev/reference/build_rmd.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build a Rmarkdown files package — build_rmd","text":"files Rmarkdown files rendered. path path package build readme. output_options List output options can override options specified metadata (e.g. used force self_contained mathjax = \"local\"). Note valid output format read metadata (.e. custom format object passed output_format). ... additional arguments passed rmarkdown::render() quiet TRUE, suppress output.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_site.html","id":null,"dir":"Reference","previous_headings":"","what":"Execute pkgdown build_site in a package — build_site","title":"Execute pkgdown build_site in a package — build_site","text":"build_site() shortcut pkgdown::build_site(), generates static HTML documentation.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_site.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Execute pkgdown build_site in a package — build_site","text":"","code":"build_site(path = \".\", quiet = TRUE, ...)"},{"path":"https://devtools.r-lib.org/dev/reference/build_site.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Execute pkgdown build_site in a package — build_site","text":"path path package build static HTML. quiet TRUE, suppress output. ... additional arguments passed pkgdown::build_site()","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_vignettes.html","id":null,"dir":"Reference","previous_headings":"","what":"Build package vignettes. — build_vignettes","title":"Build package vignettes. — build_vignettes","text":"Builds package vignettes using algorithm R CMD build . means including non-Sweave vignettes, using makefiles (present), copying extra files. files copied 'doc' directory vignette index created 'Meta/vignette.rds', built package. 'doc' 'Meta' added .Rbuildignore, included built package. files can checked version control, can viewed browseVignettes() vignette() package loaded load_all() without needing re-build locally.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/build_vignettes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build package vignettes. — build_vignettes","text":"","code":"build_vignettes(   pkg = \".\",   dependencies = \"VignetteBuilder\",   clean = TRUE,   upgrade = \"never\",   quiet = FALSE,   install = TRUE,   keep_md = TRUE )"},{"path":"https://devtools.r-lib.org/dev/reference/build_vignettes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build package vignettes. — build_vignettes","text":"pkg package use, can file path package package object.  See .package() information. dependencies dependencies want check? Can character vector (selecting \"Depends\", \"Imports\", \"LinkingTo\", \"Suggests\", \"Enhances\"), logical vector. TRUE shorthand \"Depends\", \"Imports\", \"LinkingTo\" \"Suggests\". NA shorthand \"Depends\", \"Imports\" \"LinkingTo\" default. FALSE shorthand dependencies (.e. just check package, dependencies). value \"soft\" means TRUE, \"hard\" means NA. can also specify dependencies one additional fields, common ones include: Config/Needs/website - dependencies used building pkgdown site. Config/Needs/coverage dependencies used calculating test coverage. clean Remove files generated build, even     copies . upgrade package dependencies upgraded? One \"default\", \"ask\", \"always\", \"never\". \"default\" respects value R_REMOTES_UPGRADE environment variable set, falls back \"ask\" unset. \"ask\" prompts user date packages upgrade. non-interactive sessions \"ask\" equivalent \"always\". TRUE FALSE also accepted correspond \"always\" \"never\" respectively. quiet TRUE, suppresses output. Set FALSE need debug. install TRUE, install package building vignettes. keep_md TRUE, move md intermediates well rendered outputs. useful using keep_md YAML option Rmarkdown outputs. See https://bookdown.org/yihui/rmarkdown/html-document.html#keeping-markdown.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":null,"dir":"Reference","previous_headings":"","what":"Build and check a package — check","title":"Build and check a package — check","text":"check() automatically builds checks source package, using known best practices. check_built() checks already-built package. Passing R CMD check essential want submit package CRAN: must ERRORs WARNINGs, want ensure NOTEs possible.  submitting CRAN, least ensure ERRORs WARNINGs: typically represent serious problems. check() automatically builds package calling check_built(), recommended way check packages.  Note process runs independent R session, nothing current workspace affect process. --hood, check() check_built() rely pkgbuild::build() rcmdcheck::rcmdcheck().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build and check a package — check","text":"","code":"check(   pkg = \".\",   document = NULL,   build_args = NULL,   ...,   manual = FALSE,   cran = TRUE,   remote = FALSE,   incoming = remote,   force_suggests = FALSE,   run_dont_test = FALSE,   args = \"--timings\",   env_vars = c(NOT_CRAN = \"true\"),   quiet = FALSE,   check_dir = NULL,   cleanup = deprecated(),   vignettes = TRUE,   error_on = c(\"never\", \"error\", \"warning\", \"note\") )  check_built(   path = NULL,   cran = TRUE,   remote = FALSE,   incoming = remote,   force_suggests = FALSE,   run_dont_test = FALSE,   manual = FALSE,   args = \"--timings\",   env_vars = NULL,   check_dir = tempdir(),   quiet = FALSE,   error_on = c(\"never\", \"error\", \"warning\", \"note\") )"},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build and check a package — check","text":"pkg package use, can file path package package object.  See .package() information. document default (NULL) document installed roxygen2 version matches version declared DESCRIPTION file. Use TRUE FALSE override default. build_args Additional arguments passed R CMD build ... Additional arguments passed pkgbuild::build(). manual FALSE, build check manual (---manual). cran TRUE (default), check using settings CRAN uses. moving target uniform across CRAN's machine, \"best effort\" basis. complicated simply setting ---cran. remote Sets _R_CHECK_CRAN_INCOMING_REMOTE_ env var. TRUE, performs number CRAN incoming checks require remote access. incoming Sets _R_CHECK_CRAN_INCOMING_ env var. TRUE, performs number CRAN incoming checks. force_suggests Sets _R_CHECK_FORCE_SUGGESTS_. FALSE (default), check proceed even suggested packages found. run_dont_test Sets --run-donttest examples surrounded \\donttest{} also run. cran = TRUE, affects R 3.6 earlier; R 4.0, code \\donttest{} always run part CRAN submission. args Character vector arguments pass R CMD check. Pass argument single element character vector (use spaces delimit arguments like shell). example, skip running examples tests, use args = c(\"---examples\", \"---tests\") args = \"---examples ---tests\". (Note instead --output option use check_dir argument,  --output deal spaces special characters Windows.) env_vars Environment variables set R CMD check quiet TRUE suppresses output function. check_dir Path directory check performed. NULL, temporary directory used, cleaned returned object garbage collected. cleanup See check_dir details. vignettes FALSE, build check vignettes, equivalent using args = '--ignore-vignettes' build_args = '–-build-vignettes'. error_on Whether throw error R CMD check failures. Note check always completed (unless timeout happens), error thrown completion. error_on passed rcmdcheck::rcmdcheck(), definitive source different values mean. specified user, check() check_built() default error_on = \"never\" interactive use \"warning\" non-interactive setting. path Path built package.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Build and check a package — check","text":"object containing errors, warnings, notes, .","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check.html","id":"environment-variables","dir":"Reference","previous_headings":"","what":"Environment variables","title":"Build and check a package — check","text":"Devtools best set environment combines best practices check works CRAN. includes: standard environment variables set devtools: r_env_vars(). particular note package tests NOT_CRAN env var, lets know tests running somewhere CRAN, hence can take reasonable amount time. Debugging flags compiler, set compiler_flags(FALSE). aspell found, _R_CHECK_CRAN_INCOMING_USE_ASPELL_ set TRUE. spell checker installed, warning issued. Environment variables, controlled arguments incoming, remote force_suggests.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/check_mac_release.html","id":null,"dir":"Reference","previous_headings":"","what":"Check a package on macOS — check_mac_release","title":"Check a package on macOS — check_mac_release","text":"function first bundles source package, uploads https://mac.r-project.org/macbuilder/submit.html. function returns link page check results appear.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_mac_release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check a package on macOS — check_mac_release","text":"","code":"check_mac_release(   pkg = \".\",   dep_pkgs = character(),   args = NULL,   manual = TRUE,   quiet = FALSE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/check_mac_release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check a package on macOS — check_mac_release","text":"pkg package use, can file path package package object.  See .package() information. dep_pkgs Additional custom dependencies install prior checking package. args optional character vector additional command line arguments passed R CMD build binary = FALSE, R CMD install binary = TRUE. manual manual built? quiet TRUE, suppresses output. ... Additional arguments passed pkgbuild::build().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_mac_release.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check a package on macOS — check_mac_release","text":"url check results (invisibly)","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":null,"dir":"Reference","previous_headings":"","what":"Check documentation, as R CMD check does. — check_man","title":"Check documentation, as R CMD check does. — check_man","text":"function attempts run documentation related checks way R CMD check . Unfortunately run tests require package loaded, way attempt load code conflicts devtools .","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check documentation, as R CMD check does. — check_man","text":"","code":"check_man(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check documentation, as R CMD check does. — check_man","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check documentation, as R CMD check does. — check_man","text":"Nothing. function called purely side effects: errors output.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_man.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check documentation, as R CMD check does. — check_man","text":"","code":"if (FALSE) { # \\dontrun{ check_man(\"mypkg\") } # }"},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":null,"dir":"Reference","previous_headings":"","what":"Run CRAN checks for package on R-hub — check_rhub","title":"Run CRAN checks for package on R-hub — check_rhub","text":"runs build() package, arguments specified args, submits R-hub builder https://builder.r-hub.io. interactive option controls whether function waits check output. Regardless, check complete, R-hub sends email results package maintainer.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run CRAN checks for package on R-hub — check_rhub","text":"","code":"check_rhub(   pkg = \".\",   platforms = NULL,   email = NULL,   interactive = TRUE,   build_args = NULL,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run CRAN checks for package on R-hub — check_rhub","text":"pkg package use, can file path package package object.  See .package() information. platforms R-hub platforms run check . NULL uses default list CRAN checkers (one major platform, one extra checks compiled code). can also specify , see rhub::platforms() complete list. email email address notify, defaults maintainer address package. interactive whether show status build interactively. R-hub send email package maintainer's email address, regardless whether check interactive . build_args Arguments passed R CMD build ... extra arguments, passed rhub::check_for_cran().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Run CRAN checks for package on R-hub — check_rhub","text":"rhub_check object.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_rhub.html","id":"about-email-validation-on-r-hub","dir":"Reference","previous_headings":"","what":"About email validation on r-hub","title":"Run CRAN checks for package on R-hub — check_rhub","text":"build check R packages R-hub, need validate email address. R-hub sends emails build results. See rhub::validate_email().","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/check_win.html","id":null,"dir":"Reference","previous_headings":"","what":"Check a package on Windows — check_win","title":"Check a package on Windows — check_win","text":"function first bundles source package, uploads https://win-builder.r-project.org/. service built checked package, email sent address maintainer listed DESCRIPTION. usually takes around 30 minutes. email contains link directory package binary check logs, deleted couple days.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_win.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check a package on Windows — check_win","text":"","code":"check_win_devel(   pkg = \".\",   args = NULL,   manual = TRUE,   email = NULL,   quiet = FALSE,   ... )  check_win_release(   pkg = \".\",   args = NULL,   manual = TRUE,   email = NULL,   quiet = FALSE,   ... )  check_win_oldrelease(   pkg = \".\",   args = NULL,   manual = TRUE,   email = NULL,   quiet = FALSE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/check_win.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check a package on Windows — check_win","text":"pkg package use, can file path package package object.  See .package() information. args optional character vector additional command line arguments passed R CMD build binary = FALSE, R CMD install binary = TRUE. manual manual built? email alternative email address use. NULL, default use package maintainer's email. quiet TRUE, suppresses output. ... Additional arguments passed pkgbuild::build().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/check_win.html","id":"functions","dir":"Reference","previous_headings":"","what":"Functions","title":"Check a package on Windows — check_win","text":"check_win_devel(): Check package development version R. check_win_release(): Check package released version R. check_win_oldrelease(): Check package previous major release version R.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/clean_vignettes.html","id":null,"dir":"Reference","previous_headings":"","what":"Clean built vignettes. — clean_vignettes","title":"Clean built vignettes. — clean_vignettes","text":"uses fairly rudimentary algorithm files doc name exists vignettes removed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/clean_vignettes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Clean built vignettes. — clean_vignettes","text":"","code":"clean_vignettes(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/clean_vignettes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Clean built vignettes. — clean_vignettes","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/create.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a package — create","title":"Create a package — create","text":"Create package","code":""},{"path":"https://devtools.r-lib.org/dev/reference/create.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a package — create","text":"","code":"create(path, ..., open = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/create.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a package — create","text":"path path. exists, used. exist, created, provided parent path exists. ... Additional arguments passed usethis::create_package() open TRUE, activates new project: using RStudio desktop, package opened new session. RStudio server, current RStudio project activated. Otherwise, working directory active project changed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/create.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a package — create","text":"path created package, invisibly.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_mode.html","id":null,"dir":"Reference","previous_headings":"","what":"Activate and deactivate development mode — dev_mode","title":"Activate and deactivate development mode — dev_mode","text":"longer recommend dev_mode() removed future release devtools. Instead, now rely load_all() test drive -development package. really like idea corralling experimental packages special library, might enjoy withr::local_libpaths(). concerned different projects interfering use shared library, consider using renv package. Original description: activated, dev_mode creates new library storing installed packages. new library automatically created dev_mode activated already exist. allows test development packages sandbox, without interfering packages installed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_mode.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Activate and deactivate development mode — dev_mode","text":"","code":"dev_mode(on = NULL, path = getOption(\"devtools.path\"))"},{"path":"https://devtools.r-lib.org/dev/reference/dev_mode.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Activate and deactivate development mode — dev_mode","text":"turn dev mode (TRUE) (FALSE).  omitted guess based whether path .libPaths() path directory library.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_mode.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Activate and deactivate development mode — dev_mode","text":"","code":"if (FALSE) { # \\dontrun{ dev_mode() dev_mode() } # }"},{"path":"https://devtools.r-lib.org/dev/reference/dev_packages.html","id":null,"dir":"Reference","previous_headings":"","what":"Return a vector of names of packages loaded by devtools — dev_packages","title":"Return a vector of names of packages loaded by devtools — dev_packages","text":"Return vector names packages loaded devtools","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_packages.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return a vector of names of packages loaded by devtools — dev_packages","text":"","code":"dev_packages()"},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":null,"dir":"Reference","previous_headings":"","what":"Report package development situation — dev_sitrep","title":"Report package development situation — dev_sitrep","text":"dev_sitrep() reports R date RStudio date compiler build tools installed available use devtools dependencies date package's dependencies date Call function things seem weird sure wrong fix . function returns output everything ready package development.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Report package development situation — dev_sitrep","text":"","code":"dev_sitrep(pkg = \".\", debug = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Report package development situation — dev_sitrep","text":"pkg package use, can file path package package object.  See .package() information. debug TRUE, print extra information useful debugging. FALSE, use result cached previous run.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Report package development situation — dev_sitrep","text":"named list, S3 class dev_sitrep (printing purposes).","code":""},{"path":"https://devtools.r-lib.org/dev/reference/dev_sitrep.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Report package development situation — dev_sitrep","text":"","code":"if (FALSE) { # \\dontrun{ dev_sitrep() } # }"},{"path":"https://devtools.r-lib.org/dev/reference/devtools-deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"Deprecated Functions — test_file","title":"Deprecated Functions — test_file","text":"functions Deprecated release devtools, marked Defunct removed future version.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/devtools-deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deprecated Functions — test_file","text":"","code":"test_file(file = find_active_file(), ...)  test_coverage_file(file = find_active_file(), ...)"},{"path":"https://devtools.r-lib.org/dev/reference/devtools-package.html","id":null,"dir":"Reference","previous_headings":"","what":"devtools: Tools to Make Developing R Packages Easier — devtools-package","title":"devtools: Tools to Make Developing R Packages Easier — devtools-package","text":"Collection package development tools.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/devtools-package.html","id":"package-options","dir":"Reference","previous_headings":"","what":"Package options","title":"devtools: Tools to Make Developing R Packages Easier — devtools-package","text":"Devtools uses following options() configure behaviour: devtools.install.args: string giving extra arguments passed R CMD install install(). devtools.path: Deprecated. Path used now-deprecated dev_mode() function.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/devtools-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"devtools: Tools to Make Developing R Packages Easier — devtools-package","text":"Maintainer: Jennifer Bryan jenny@posit.co (ORCID) Authors: Hadley Wickham Jim Hester Winston Chang contributors: Posit Software, PBC [copyright holder, funder]","code":""},{"path":"https://devtools.r-lib.org/dev/reference/document.html","id":null,"dir":"Reference","previous_headings":"","what":"Use roxygen to document a package. — document","title":"Use roxygen to document a package. — document","text":"function wrapper roxygen2::roxygenize() function roxygen2 package. See documentation vignettes package learn use roxygen.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/document.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use roxygen to document a package. — document","text":"","code":"document(pkg = \".\", roclets = NULL, quiet = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/document.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use roxygen to document a package. — document","text":"pkg package use, can file path package package object.  See .package() information. roclets Character vector roclet names use package. default, NULL, uses roxygen roclets option, defaults c(\"collate\", \"namespace\", \"rd\"). quiet TRUE suppresses output function.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/git_checks.html","id":null,"dir":"Reference","previous_headings":"","what":"Git checks. — git_checks","title":"Git checks. — git_checks","text":"function performs Git checks checks prior release. called automatically release().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/git_checks.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Git checks. — git_checks","text":"","code":"git_checks(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/git_checks.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Git checks. — git_checks","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.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://devtools.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://devtools.r-lib.org/dev/reference/install.html","id":null,"dir":"Reference","previous_headings":"","what":"Install a local development package. — install","title":"Install a local development package. — install","text":"Uses R CMD INSTALL install package. also try install dependencies package CRAN, already installed.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/install.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Install a local development package. — install","text":"","code":"install(   pkg = \".\",   reload = TRUE,   quick = FALSE,   build = !quick,   args = getOption(\"devtools.install.args\"),   quiet = FALSE,   dependencies = NA,   upgrade = \"default\",   build_vignettes = FALSE,   keep_source = getOption(\"keep.source.pkgs\"),   force = FALSE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/install.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Install a local development package. — install","text":"pkg package use, can file path package package object.  See .package() information. reload TRUE (default), automatically reload package installing. quick TRUE skips docs, multiple-architectures, demos, vignettes, make installation fast possible. build TRUE pkgbuild::build()s package first: ensures installation completely clean, prevents binary artefacts (like .o, .) appearing local package directory, considerably slower, every compile start scratch. args optional character vector additional command line arguments passed R CMD INSTALL. defaults value option \"devtools.install.args\". quiet TRUE, suppress output. dependencies dependencies want check? Can character vector (selecting \"Depends\", \"Imports\", \"LinkingTo\", \"Suggests\", \"Enhances\"), logical vector. TRUE shorthand \"Depends\", \"Imports\", \"LinkingTo\" \"Suggests\". NA shorthand \"Depends\", \"Imports\" \"LinkingTo\" default. FALSE shorthand dependencies (.e. just check package, dependencies). value \"soft\" means TRUE, \"hard\" means NA. can also specify dependencies one additional fields, common ones include: Config/Needs/website - dependencies used building pkgdown site. Config/Needs/coverage dependencies used calculating test coverage. upgrade package dependencies upgraded? One \"default\", \"ask\", \"always\", \"never\". \"default\" respects value R_REMOTES_UPGRADE environment variable set, falls back \"ask\" unset. \"ask\" prompts user date packages upgrade. non-interactive sessions \"ask\" equivalent \"always\". TRUE FALSE also accepted correspond \"always\" \"never\" respectively. build_vignettes TRUE, build vignettes. Normally build responsible creating vignettes; argument makes sure vignettes built even build never happens (.e. build = FALSE). keep_source TRUE keep srcrefs installed package. useful debugging (especially inside RStudio). defaults option \"keep.source.pkgs\". force Force installation, even remote state changed since previous install. ... additional arguments passed remotes::install_deps() installing dependencies.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/install.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Install a local development package. — install","text":"quick = TRUE, installation takes place using current package directory. compiled code, means artefacts compilation created src/ directory. want avoid , can use build = TRUE first build package bundle install temporary directory. slower, keeps source directory pristine. package loaded, reloaded installation. always completely possible, see reload() caveats. install package non-default library, use withr::with_libpaths().","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/install_deps.html","id":null,"dir":"Reference","previous_headings":"","what":"Install package dependencies if needed. — install_deps","title":"Install package dependencies if needed. — install_deps","text":"install_deps() install user dependencies needed run package, install_dev_deps() also install development dependencies needed test build package.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/install_deps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Install package dependencies if needed. — install_deps","text":"","code":"install_deps(   pkg = \".\",   dependencies = NA,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \" --no-build-vignettes\"),   ... )  install_dev_deps(   pkg = \".\",   dependencies = TRUE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \" --no-build-vignettes\"),   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/install_deps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Install package dependencies if needed. — install_deps","text":"pkg package use, can file path package package object.  See .package() information. dependencies dependencies want check? Can character vector (selecting \"Depends\", \"Imports\", \"LinkingTo\", \"Suggests\", \"Enhances\"), logical vector. TRUE shorthand \"Depends\", \"Imports\", \"LinkingTo\" \"Suggests\". NA shorthand \"Depends\", \"Imports\" \"LinkingTo\" default. FALSE shorthand dependencies (.e. just check package, dependencies). value \"soft\" means TRUE, \"hard\" means NA. can also specify dependencies one additional fields, common ones include: Config/Needs/website - dependencies used building pkgdown site. Config/Needs/coverage dependencies used calculating test coverage. repos character vector giving repositories use. type Type package update. upgrade package dependencies upgraded? One \"default\", \"ask\", \"always\", \"never\". \"default\" respects value R_REMOTES_UPGRADE environment variable set, falls back \"ask\" unset. \"ask\" prompts user date packages upgrade. non-interactive sessions \"ask\" equivalent \"always\". TRUE FALSE also accepted correspond \"always\" \"never\" respectively. quiet TRUE, suppress output. build TRUE pkgbuild::build()s package first: ensures installation completely clean, prevents binary artefacts (like .o, .) appearing local package directory, considerably slower, every compile start scratch. build_opts Options pass R CMD build, used build TRUE. ... additional arguments passed remotes::install_deps() installing dependencies.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/install_deps.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Install package dependencies if needed. — install_deps","text":"","code":"if (FALSE) install_deps(\".\") # \\dontrun{}"},{"path":"https://devtools.r-lib.org/dev/reference/is.package.html","id":null,"dir":"Reference","previous_headings":"","what":"Is the object a package? — is.package","title":"Is the object a package? — is.package","text":"object package?","code":""},{"path":"https://devtools.r-lib.org/dev/reference/is.package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is the object a package? — is.package","text":"","code":"is.package(x)"},{"path":"https://devtools.r-lib.org/dev/reference/lint.html","id":null,"dir":"Reference","previous_headings":"","what":"Lint all source files in a package — lint","title":"Lint all source files in a package — lint","text":"default linters correspond style guide https://style.tidyverse.org/, however possible override using linters parameter.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/lint.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Lint all source files in a package — lint","text":"","code":"lint(pkg = \".\", cache = TRUE, ...)"},{"path":"https://devtools.r-lib.org/dev/reference/lint.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Lint all source files in a package — lint","text":"pkg package use, can file path package package object.  See .package() information. cache Store lint results repeated lints content use previous results. Consult lintr package learn caching behaviour. ... Additional arguments passed lintr::lint_package().","code":""},{"path":[]},{"path":"https://devtools.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.","code":""},{"path":"https://devtools.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,   recompile = FALSE,   export_all = TRUE,   helpers = TRUE,   quiet = FALSE,   ... )"},{"path":"https://devtools.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 clear package environment reset file cache loading pieces package. largely equivalent running unload(), however old namespaces completely removed .onUnload() hooks called. Use reset = FALSE may faster large code bases, significantly less accurate approximation. recompile DEPRECATED. force recompile DLL source code, present. equivalent running pkgbuild::clean_dll() load_all() export_all TRUE (default), export objects. FALSE, export objects listed exports NAMESPACE file. helpers TRUE loads testthat test helpers. quiet TRUE suppresses output function. ... Additional arguments passed pkgload::load_all().","code":""},{"path":"https://devtools.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://devtools.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 reset=TRUE, unload and reload the package for a clean start load_all(\"./\", TRUE)  # With export_all=FALSE, only objects listed as exports in NAMESPACE # are exported load_all(\"./\", export_all = FALSE) } # }"},{"path":"https://devtools.r-lib.org/dev/reference/loaded_packages.html","id":null,"dir":"Reference","previous_headings":"","what":"Return a vector of names of attached packages — loaded_packages","title":"Return a vector of names of attached packages — loaded_packages","text":"Return vector names attached packages","code":""},{"path":"https://devtools.r-lib.org/dev/reference/loaded_packages.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return a vector of names of attached packages — loaded_packages","text":"","code":"loaded_packages()"},{"path":"https://devtools.r-lib.org/dev/reference/loaded_packages.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Return a vector of names of attached packages — loaded_packages","text":"data frame columns package path, giving name package path loaded .","code":""},{"path":"https://devtools.r-lib.org/dev/reference/missing_s3.html","id":null,"dir":"Reference","previous_headings":"","what":"Find missing s3 exports. — missing_s3","title":"Find missing s3 exports. — missing_s3","text":"method heuristic - looking objs period name.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/missing_s3.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find missing s3 exports. — missing_s3","text":"","code":"missing_s3(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/missing_s3.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find missing s3 exports. — missing_s3","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.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 walking path finds root directory, .e. directory containing DESCRIPTION. find root directory, find specified path, throw error.","code":""},{"path":"https://devtools.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://devtools.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://devtools.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://devtools.r-lib.org/dev/reference/r_env_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Environment variables to set when calling R — r_env_vars","title":"Environment variables to set when calling R — r_env_vars","text":"Devtools sets number environmental variables ensure consistent current R session new session, ensure everything behaves across systems. also suppresses common warning windows, sets NOT_CRAN can tell code running CRAN. NOT_CRAN set externally, overwritten.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/r_env_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Environment variables to set when calling R — r_env_vars","text":"","code":"r_env_vars()"},{"path":"https://devtools.r-lib.org/dev/reference/r_env_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Environment variables to set when calling R — r_env_vars","text":"named character vector","code":""},{"path":"https://devtools.r-lib.org/dev/reference/reexports.html","id":null,"dir":"Reference","previous_headings":"","what":"Objects exported from other packages — reexports","title":"Objects exported from other packages — reexports","text":"objects imported packages. Follow links see documentation. pkgbuild clean_dll, find_rtools, has_devel, with_debug pkgload check_dep_version, parse_deps, unload remotes github_pull, github_release sessioninfo package_info, session_info","code":""},{"path":"https://devtools.r-lib.org/dev/reference/release.html","id":null,"dir":"Reference","previous_headings":"","what":"Release package to CRAN. — release","title":"Release package to CRAN. — release","text":"Run automated manual tests, post package CRAN.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Release package to CRAN. — release","text":"","code":"release(pkg = \".\", check = FALSE, args = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Release package to CRAN. — release","text":"pkg package use, can file path package package object.  See .package() information. check TRUE, run checking, otherwise omit .  useful just checked package ready release . args optional character vector additional command line arguments passed R CMD build.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Release package to CRAN. — release","text":"package release process : Confirm package passes R CMD check relevant platforms Confirm important files --date Build package Submit package CRAN, using comments \"cran-comments.md\" can add arbitrary extra questions defining (un-exported) function called release_questions() returns character vector additional questions ask. also need read CRAN repository policy 'https://cran.r-project.org/web/packages/policies.html' make sure line policies. release tries automate many polices possible, impossible completely comprehensive, change releases devtools.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/release_checks.html","id":null,"dir":"Reference","previous_headings":"","what":"Custom devtools release checks. — release_checks","title":"Custom devtools release checks. — release_checks","text":"function performs additional checks prior release. called automatically release().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/release_checks.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Custom devtools release checks. — release_checks","text":"","code":"release_checks(pkg = \".\", built_path = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/release_checks.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Custom devtools release checks. — release_checks","text":"pkg package use, can file path package package object.  See .package() information.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/reload.html","id":null,"dir":"Reference","previous_headings":"","what":"Unload and reload package. — reload","title":"Unload and reload package. — reload","text":"attempts unload reload installed package. package loaded already, nothing. always possible cleanly unload package: see caveats unload() potential failure points. doubt, restart R reload package library().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/reload.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Unload and reload package. — reload","text":"","code":"reload(pkg = \".\", quiet = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/reload.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Unload and reload package. — reload","text":"pkg package use, can file path package package object.  See .package() information. quiet TRUE suppresses output function.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/reload.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Unload and reload package. — reload","text":"","code":"if (FALSE) { # \\dontrun{ # Reload package that is in current directory reload(\".\")  # Reload package that is in ./ggplot2/ reload(\"ggplot2/\")  # Can use inst() to find the package path # This will reload the installed ggplot2 package reload(pkgload::inst(\"ggplot2\")) } # }"},{"path":"https://devtools.r-lib.org/dev/reference/remote-reexports.html","id":null,"dir":"Reference","previous_headings":"","what":"Functions re-exported from the remotes package — remote-reexports","title":"Functions re-exported from the remotes package — remote-reexports","text":"functions re-exported remotes package. differ ones devtools use ellipsis package ensure dotted arguments used.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/remote-reexports.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Functions re-exported from the remotes package — remote-reexports","text":"","code":"install_bioc(   repo,   mirror = getOption(\"BioC_git\", download_url(\"git.bioconductor.org/packages\")),   git = c(\"auto\", \"git2r\", \"external\"),   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_bitbucket(   repo,   ref = \"HEAD\",   subdir = NULL,   auth_user = bitbucket_user(),   password = bitbucket_password(),   host = \"api.bitbucket.org/2.0\",   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_cran(   pkgs,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   ... )  install_dev(package, cran_url = getOption(\"repos\")[[\"CRAN\"]], ...)  install_git(   url,   subdir = NULL,   ref = NULL,   branch = NULL,   credentials = git_credentials(),   git = c(\"auto\", \"git2r\", \"external\"),   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_github(   repo,   ref = \"HEAD\",   subdir = NULL,   auth_token = github_pat(quiet),   host = \"api.github.com\",   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_gitlab(   repo,   subdir = NULL,   auth_token = gitlab_pat(quiet),   host = \"gitlab.com\",   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_local(   path = \".\",   subdir = NULL,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = !is_binary_pkg(path),   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_svn(   url,   subdir = NULL,   args = character(0),   revision = NULL,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_url(   url,   subdir = NULL,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  install_version(   package,   version = NULL,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = FALSE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = \"source\",   ... )  update_packages(   packages = TRUE,   dependencies = NA,   upgrade = c(\"default\", \"ask\", \"always\", \"never\"),   force = FALSE,   quiet = FALSE,   build = TRUE,   build_opts = c(\"--no-resave-data\", \"--no-manual\", \"--no-build-vignettes\"),   build_manual = FALSE,   build_vignettes = FALSE,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\"),   ... )  dev_package_deps(   pkgdir = \".\",   dependencies = NA,   repos = getOption(\"repos\"),   type = getOption(\"pkgType\") )"},{"path":"https://devtools.r-lib.org/dev/reference/remote-reexports.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Functions re-exported from the remotes package — remote-reexports","text":"Follow links see documentation. remotes::install_bioc(), remotes::install_bitbucket(), remotes::install_cran(), remotes::install_dev(), remotes::install_git(), remotes::install_github(), remotes::install_gitlab(), remotes::install_local(), remotes::install_svn(), remotes::install_url(), remotes::install_version(), remotes::update_packages(), remotes::dev_package_deps().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":null,"dir":"Reference","previous_headings":"","what":"Reverse dependency tools. — revdep","title":"Reverse dependency tools. — revdep","text":"Tools check notify maintainers CRAN Bioconductor packages depend specified package.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Reverse dependency tools. — revdep","text":"","code":"revdep(   pkg,   dependencies = c(\"Depends\", \"Imports\", \"Suggests\", \"LinkingTo\"),   recursive = FALSE,   ignore = NULL,   bioconductor = FALSE )  revdep_maintainers(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Reverse dependency tools. — revdep","text":"pkg Package name. unlike devtools packages take path might want determine dependencies package installed. omitted, defaults name current package. dependencies character vector listing types dependencies follow. recursive TRUE look full set recursive dependencies. ignore character vector package names ignore. packages appear returned vector. bioconductor TRUE also look dependencies amongst Bioconductor packages.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Reverse dependency tools. — revdep","text":"first run session time-consuming must download package metadata CRAN Bioconductor. Subsequent runs faster.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/revdep.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Reverse dependency tools. — revdep","text":"","code":"if (FALSE) { # \\dontrun{ revdep(\"ggplot2\")  revdep(\"ggplot2\", ignore = c(\"xkcd\", \"zoo\")) } # }"},{"path":"https://devtools.r-lib.org/dev/reference/run_examples.html","id":null,"dir":"Reference","previous_headings":"","what":"Run all examples in a package. — run_examples","title":"Run all examples in a package. — run_examples","text":"One frustrating parts R CMD check getting examples pass - whenever one fails need fix problem restart whole process.  function makes little easier making possible run examples R function.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/run_examples.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run all examples in a package. — run_examples","text":"","code":"run_examples(   pkg = \".\",   start = NULL,   show = deprecated(),   run_donttest = FALSE,   run_dontrun = FALSE,   fresh = FALSE,   document = TRUE,   run = deprecated(),   test = deprecated() )"},{"path":"https://devtools.r-lib.org/dev/reference/run_examples.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run all examples in a package. — run_examples","text":"pkg package use, can file path package package object.  See .package() information. start start running examples: can either name Rd file start (without extensions), topic name. omitted, start (lexicographically) first file. useful lot examples want rerun every time fix problem. show DEPRECATED. run_donttest TRUE, run \\donttest sections Rd files. run_dontrun TRUE, run \\dontrun sections Rd files. fresh TRUE, run fresh R session. advantage way examples can depend anything current session, interactive code (like browser()) work. document TRUE, document() run ensure examples updated running . run, test Deprecated, see run_dontrun run_donttest .","code":""},{"path":"https://devtools.r-lib.org/dev/reference/save_all.html","id":null,"dir":"Reference","previous_headings":"","what":"Save all documents in an active IDE session. — save_all","title":"Save all documents in an active IDE session. — save_all","text":"Helper function wrapping IDE-specific calls save documents active session. form, callers save_all() need execute IDE-specific code. function can extended include IDE implementations equivalent rstudioapi::documentSaveAll() methods.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/save_all.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Save all documents in an active IDE session. — save_all","text":"","code":"save_all()"},{"path":"https://devtools.r-lib.org/dev/reference/show_news.html","id":null,"dir":"Reference","previous_headings":"","what":"Show package news — show_news","title":"Show package news — show_news","text":"Show package news","code":""},{"path":"https://devtools.r-lib.org/dev/reference/show_news.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Show package news — show_news","text":"","code":"show_news(pkg = \".\", latest = TRUE, ...)"},{"path":"https://devtools.r-lib.org/dev/reference/show_news.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Show package news — show_news","text":"pkg package use, can file path package package object.  See .package() information. latest TRUE, show news recent version. ... arguments passed news","code":""},{"path":"https://devtools.r-lib.org/dev/reference/source_gist.html","id":null,"dir":"Reference","previous_headings":"","what":"Run a script on gist — source_gist","title":"Run a script on gist — source_gist","text":"“Gist simple way share snippets pastes others. gists git repositories, automatically versioned, forkable usable git repository.” https://gist.github.com/","code":""},{"path":"https://devtools.r-lib.org/dev/reference/source_gist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run a script on gist — source_gist","text":"","code":"source_gist(id, ..., filename = NULL, sha1 = NULL, quiet = FALSE)"},{"path":"https://devtools.r-lib.org/dev/reference/source_gist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run a script on gist — source_gist","text":"id either full url (character), gist ID (numeric character numeric). ... options passed source() filename one R file gist, one source (filename ending '.R')? Default NULL source first file. sha1 SHA-1 hash file remote URL. highly recommend prevents accidentally running code expect. See source_url() information using SHA-1 hash. quiet FALSE, default, prints informative messages.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/source_gist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run a script on gist — source_gist","text":"","code":"if (FALSE) { # \\dontrun{ # You can run gists given their id source_gist(6872663) source_gist(\"6872663\")  # Or their html url source_gist(\"https://gist.github.com/hadley/6872663\") source_gist(\"gist.github.com/hadley/6872663\")  # It's highly recommend that you run source_gist with the optional # sha1 argument - this will throw an error if the file has changed since # you first ran it source_gist(6872663, sha1 = \"54f1db27e60\") # Wrong hash will result in error source_gist(6872663, sha1 = \"54f1db27e61\")  #' # You can speficy a particular R file in the gist source_gist(6872663, filename = \"hi.r\") source_gist(6872663, filename = \"hi.r\", sha1 = \"54f1db27e60\") } # }"},{"path":"https://devtools.r-lib.org/dev/reference/source_url.html","id":null,"dir":"Reference","previous_headings":"","what":"Run a script through some protocols such as http, https, ftp, etc. — source_url","title":"Run a script through some protocols such as http, https, ftp, etc. — source_url","text":"SHA-1 hash specified sha1 argument, function check SHA-1 hash downloaded file make sure matches expected value, throw error match. SHA-1 hash specified, print message displaying hash downloaded file. purpose improve security running remotely-hosted code; hash file, can sure changed. convenience, possible use truncated SHA1 hash, 6 characters, keep mind truncated hash secure full hash.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/source_url.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run a script through some protocols such as http, https, ftp, etc. — source_url","text":"","code":"source_url(url, ..., sha1 = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/source_url.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run a script through some protocols such as http, https, ftp, etc. — source_url","text":"url url ... options passed source() sha1 (prefix ) SHA-1 hash file remote URL.","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/source_url.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run a script through some protocols such as http, https, ftp, etc. — source_url","text":"","code":"if (FALSE) { # \\dontrun{  source_url(\"https://gist.github.com/hadley/6872663/raw/hi.r\")  # With a hash, to make sure the remote file hasn't changed source_url(\"https://gist.github.com/hadley/6872663/raw/hi.r\",   sha1 = \"54f1db27e60bb7e0486d785604909b49e8fef9f9\")  # With a truncated hash source_url(\"https://gist.github.com/hadley/6872663/raw/hi.r\",   sha1 = \"54f1db27e60\") } # }"},{"path":"https://devtools.r-lib.org/dev/reference/spell_check.html","id":null,"dir":"Reference","previous_headings":"","what":"Spell checking — spell_check","title":"Spell checking — spell_check","text":"Runs spell check text fields package description file, manual pages, optionally vignettes. Wraps spelling package.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/spell_check.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spell checking — spell_check","text":"","code":"spell_check(pkg = \".\", vignettes = TRUE, use_wordlist = TRUE)"},{"path":"https://devtools.r-lib.org/dev/reference/spell_check.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spell checking — spell_check","text":"pkg package use, can file path package package object.  See .package() information. vignettes also check rmd rnw files pkg vignettes folder use_wordlist ignore words package WORDLIST file","code":""},{"path":"https://devtools.r-lib.org/dev/reference/submit_cran.html","id":null,"dir":"Reference","previous_headings":"","what":"Submit a package to CRAN — submit_cran","title":"Submit a package to CRAN — submit_cran","text":"submits package CRAN using web-form submission process. submission, receive email asking confirm submission used check package submitted maintainer. may prefer use submit_cran() indirectly, calling release() instead. release() performs many checks verifying package indeed ready CRAN, eventually asking confirmation like submit CRAN (calling submit_cran()). Whether use release() submit_cran() depends rest development process. want super cautious, use release(), even though may redundant checks performed. hand, many checks place (automated checks via GitHub Actions task list generated usethis::use_release_issue()), makes sense use submit_cran() directly.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/submit_cran.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Submit a package to CRAN — submit_cran","text":"","code":"submit_cran(pkg = \".\", args = NULL)"},{"path":"https://devtools.r-lib.org/dev/reference/submit_cran.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Submit a package to CRAN — submit_cran","text":"pkg package use, can file path package package object.  See .package() information. args optional character vector additional command line arguments passed R CMD build.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/test.html","id":null,"dir":"Reference","previous_headings":"","what":"Execute testthat tests in a package — test","title":"Execute testthat tests in a package — test","text":"test() runs tests package. shortcut testthat::test_dir() test_active_file() runs test() active file. test_coverage() computes test coverage package. shortcut covr::package_coverage() plus covr::report(). test_coverage_active_file() computes test coverage active file. shortcut covr::file_coverage() plus covr::report().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/test.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Execute testthat tests in a package — test","text":"","code":"test(pkg = \".\", filter = NULL, stop_on_failure = FALSE, export_all = TRUE, ...)  test_active_file(file = find_active_file(), ...)  test_coverage(pkg = \".\", show_report = interactive(), ...)  test_coverage_active_file(   file = find_active_file(),   filter = TRUE,   show_report = interactive(),   export_all = TRUE,   ... )"},{"path":"https://devtools.r-lib.org/dev/reference/test.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Execute testthat tests in a package — test","text":"pkg package use, can file path package package object.  See .package() information. filter NULL, tests file names matching regular expression executed. Matching performed file name stripped \"test-\" \".R\". stop_on_failure TRUE, throw error tests fail. export_all TRUE (default), export objects. FALSE, export objects listed exports NAMESPACE file. ... additional arguments passed wrapped functions. file One source test files. source file corresponding test file run. default use active file RStudio (available). show_report Show test coverage report.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/uninstall.html","id":null,"dir":"Reference","previous_headings":"","what":"Uninstall a local development package — uninstall","title":"Uninstall a local development package — uninstall","text":"Uses remove.packages() uninstall package. uninstall package non-default library, use combination withr::with_libpaths().","code":""},{"path":"https://devtools.r-lib.org/dev/reference/uninstall.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Uninstall a local development package — uninstall","text":"","code":"uninstall(pkg = \".\", unload = TRUE, quiet = FALSE, lib = .libPaths()[[1]])"},{"path":"https://devtools.r-lib.org/dev/reference/uninstall.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Uninstall a local development package — uninstall","text":"pkg package use, can file path package package object.  See .package() information. unload TRUE (default), ensures package unloaded, prior uninstalling. quiet TRUE, suppress output. lib character vector giving library directories remove     packages .  missing, defaults first element     .libPaths().","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/reference/uses_testthat.html","id":null,"dir":"Reference","previous_headings":"","what":"Does a package use testthat? — uses_testthat","title":"Does a package use testthat? — uses_testthat","text":"package use testthat?","code":""},{"path":"https://devtools.r-lib.org/dev/reference/uses_testthat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Does a package use testthat? — uses_testthat","text":"","code":"uses_testthat(pkg = \".\")"},{"path":"https://devtools.r-lib.org/dev/reference/wd.html","id":null,"dir":"Reference","previous_headings":"","what":"Set working directory. — wd","title":"Set working directory. — wd","text":"Set working directory.","code":""},{"path":"https://devtools.r-lib.org/dev/reference/wd.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set working directory. — wd","text":"","code":"wd(pkg = \".\", path = \"\")"},{"path":"https://devtools.r-lib.org/dev/reference/wd.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set working directory. — wd","text":"pkg package use, can file path package package object.  See .package() information. path path within package. Leave empty change working directory package directory.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-development-version","dir":"Changelog","previous_headings":"","what":"devtools (development version)","title":"devtools (development version)","text":"Functions use httr now explicitly check installed (@catalamarti, #2573). test_coverage() now works package installed. test_coverage_active_file() now reports tests failed better job executing snapshot comparisons.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-245","dir":"Changelog","previous_headings":"","what":"devtools 2.4.5","title":"devtools 2.4.5","text":"CRAN release: 2022-10-11 check(cleanup =) deprecated devtools v1.11.0 (2016-04-12) made defunct v2.4.4 (2022-07-20). documentation clear now recommended alternatives. check(check_dir = NULL) new default, align default behaviour underlying rcmdcheck::rcmdcheck(). check(cran = TRUE) sets env var _R_CHECK_PACKAGES_USED_IGNORE_UNUSED_IMPORTS_ FALSE, order surface \"Namespace Imports field imported \" NOTE. applies R >= 4.2, due favorable changes behaviour R CMD check ---cran (#2459). test_active_file() passes package onto testthat can correctly set TESTTHAT_PKG envvar (#2470). test() test_active_file() work testthat . dev_mode() deprecated (@billdenney, #2467).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-244","dir":"Changelog","previous_headings":"","what":"devtools 2.4.4","title":"devtools 2.4.4","text":"CRAN release: 2022-07-20 install(reload = TRUE) now calls pkgload::unregister() instead pkload::unload() (#2349). allows package keep functioning still use R session (e.g. event handlers). test() longer calls load_all() twice. test_active_file() now calls load_all() via testthat. aspell_env_var() better job matching R CMD check behaviour, use aspell, hunspell ispell (#2376). Installing devtools now installs pkgdown, profvis, bench, miniUI, urlchecker, ensuring everything needed package development (#2388). dev_sitrep() updated calendar-based version number scheme adopted RStudio IDE September 2021 (#2397, #2410).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-243","dir":"Changelog","previous_headings":"","what":"devtools 2.4.3","title":"devtools 2.4.3","text":"CRAN release: 2021-11-30 New check_mac_release() function check package using macOS builder https://mac.r-project.org/macbuilder/submit.html (#2375) Jenny Bryan now official maintainer. release() submit_cran() now record submission details using Debian Control File format, better machine-readability. file new name, CRAN-SUBMISSION (instead CRAN-RELEASE) now includes package version, addition full SHA timestamp.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-242","dir":"Changelog","previous_headings":"","what":"devtools 2.4.2","title":"devtools 2.4.2","text":"CRAN release: 2021-06-07 check_man() now works R versions 4.1+ (#2354) test_active_file() now works windows projects stored user’s home directory (~) (#2355) document(quiet = TRUE) now works without failure windows (#2351) Minor test failure R 4.2 fixed. New Rstudio addin run_examples() (#2358)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-241","dir":"Changelog","previous_headings":"","what":"devtools 2.4.1","title":"devtools 2.4.1","text":"CRAN release: 2021-05-05 build_readme() now uses path argument, designed (#2344) create() longer opens projects default avoid duplicate projects opened RStudio IDE project template (#2347, @malcolmbarrett) RStudio addins now use test_active_file() test_coverage_active_file() instead deprecated test_file() test_coverage_file() (#2339) RStudio addins now run interactive mode, rather background mode (@jennybc, #2350) install(upgrade) now defaults ‘default’ rather ‘ask’. allows control default asking behavior R_REMOTES_UPGRADE environment variable (#2345)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-240","dir":"Changelog","previous_headings":"","what":"devtools 2.4.0","title":"devtools 2.4.0","text":"CRAN release: 2021-04-07","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"breaking-changes-and-deprecated-functions-2-4-0","dir":"Changelog","previous_headings":"","what":"Breaking changes and deprecated functions","title":"devtools 2.4.0","text":"check_results() function removed. used CRAN package, much better alternatives available rcmdcheck package. pkgload::inst() longer re-exported (#2218). test_file() renamed test_active_file() test_coverage_file() renamed test_coverage_active_file() avoid name collision testthat::test_file(). previous names soft deprecated release, hard deprecated next release eventually removed. (#2125)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"re-licensing-2-4-0","dir":"Changelog","previous_headings":"","what":"Re-licensing","title":"devtools 2.4.0","text":"devtools now released MIT license (#2326)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-fixes-2-4-0","dir":"Changelog","previous_headings":"","what":"Minor improvements and fixes","title":"devtools 2.4.0","text":"build_readme() now supports readme files located inst/README.Rmd, intended (#2333) build_vignettes() now creates specific .gitignore entries (@klmr, #2317) check() now re-documents matching version roxygen2 (#2263). change_maintainer_email() now check assess whether email actually changed. email changed, code now stops email accidentally sent wrong recipient. (@emilsjoerup, #2073) run_examples(fresh = TRUE) works without error (#2264) covr DT packages moved Imports Suggests. needed running test_coverage() test_coverage_active_file() now ’ll prompted install needed. Switched fs file system functions (#2331, @malcolmbarrett) Now uses testthat 3.0.0 power test(), test_active_file(), test_coverage(), test_coverage_active_file(). major difference test_active_file() now generates compact summary takes less space console.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-232","dir":"Changelog","previous_headings":"","what":"devtools 2.3.2","title":"devtools 2.3.2","text":"CRAN release: 2020-09-18 Fix compatibility withr 2.3.0","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-231","dir":"Changelog","previous_headings":"","what":"devtools 2.3.1","title":"devtools 2.3.1","text":"CRAN release: 2020-07-21 check_win_*() function now resets email original email execution, bug fixed crept back (@muschellij2, #2152). run_examples() arguments run test deprecated favor (hopefully) clear run_dontrun run_donttest (pkgload/#107). Previously deprecated functions dr_devtools() dr_github() removed. Documentation synced remotes 2.2.0","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-230","dir":"Changelog","previous_headings":"","what":"devtools 2.3.0","title":"devtools 2.3.0","text":"CRAN release: 2020-04-10 build() now errors informative error message passed invalid pkg. (#2177) New build_rmd() can build .Rmd file clean session. dev_sitrep() now works correctly R date (#2204)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-222","dir":"Changelog","previous_headings":"","what":"devtools 2.2.2","title":"devtools 2.2.2","text":"CRAN release: 2020-02-17 install_dev_deps() now passes formal args onto remotes::install_deps() (@t-gibson, #2166) spell_check() now checks spelling installed prompts users install (@mikemahoney218, #2172) submit_cran() now returns informative error CRAN submission portal (#1958) check() gains vignettes argument, easily disable checks vignettes (#2165). check_win_*() function now resets email original email execution (@muschellij2, #2152). check() now sets NOT_CRAN=true default, originally intended (#2135). install_deps() now supports options(\"devtools.ellipsis_action\") well (#2169) test() now takes stop_on_failure formal argument (FALSE default) instead .... value still passed testthat::test_dir (@infotroph, #2129). test() test_coverage_file() gain export_all argument, controls functions package automatically exported (#1201). dev_sitrep() now works run outside package directory (#2127). release() now works package root working directory.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-221","dir":"Changelog","previous_headings":"","what":"devtools 2.2.1","title":"devtools 2.2.1","text":"CRAN release: 2019-09-24 test() now sets collation order C running, matches behavior tests run R CMD check (#2121) New options(\"devtools.ellipsis_action\") option added control action ellipsis devtools. one rlang::abort - emit error arguments unused rlang::warn - emit warning arguments unused rlang::inform - emit message arguments unused rlang::signal - emit message arguments unused Using rlang::signal produce output unless custom condition caught, best way retain backwards compatibility devtools behavior prior 2.2.0. default behavior also changed issue warning rather error arguments unused, cases devtools need install package, unused arguments false positives (#2109). install() now throws error fails, intended (#2120) install() now reloads re-attaches packages previously loaded (#2111). release() longer calls deprecated dr_devtools() (#2105) test() now explicitly passes stop_on_failure = FALSE testthat::test_dir() (@jameslamb, #2099)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-220","dir":"Changelog","previous_headings":"","what":"devtools 2.2.0","title":"devtools 2.2.0","text":"CRAN release: 2019-09-07","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-2-2-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"devtools 2.2.0","text":"create() added back, RStudio IDE uses create() create packages dialog, removing version 2.1.0 broke old versions IDE. New dev_sitrep() function return information development environment diagnose common problems. former functions dr_devtools() dr_github() deprecated. (#1970) functions taking ... now use ellipsis package. catches errors arguments misspelled incorrectly specified (#2016)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-fixes-2-2-0","dir":"Changelog","previous_headings":"","what":"Minor improvements and fixes","title":"devtools 2.2.0","text":"build_vignettes() now correctly installs vignette builder already installed (#2089). dev_sitrep() now uses endpoint detect current RStudio version IDE (#2050). document() gains quiet parameter, silence output check() now passes quiet argument (#1986). Add DT package dependency, test_coverage() test_coverage_file() work without install additional packages (#2085). check_man() now succeeds tools::undoc() returns empty results (#1944). check_win_*() functions gain email argument, temporarily change email check results sent (#1723). install() now explicitly unloads packages trying install new version (#2094). install_*() functions now attach build tools PATH, makes work Windows RTools default PATH (#2093). test_coverage_file() now works 1 1 correspondence test source files (#2011). release() now works pkg current working directory (#1974). release() now works without error options(\"repos\") unnamed (#1956). create() added, RStudio IDE uses create(), removing version 2.1.0 broke old versions IDE. several places http: URLs used instead https:, critical cran_mirror, cran_pacakges, cran_submission_url values enabled discrete activity disclosure person---middle attacks (.e. changing contents uploading/downloading). http: URLS changed https: URLs. (@hrbrmstr, #2091)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-210","dir":"Changelog","previous_headings":"","what":"devtools 2.1.0","title":"devtools 2.1.0","text":"CRAN release: 2019-07-06","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-2-1-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"devtools 2.1.0","text":"testthat roxygen2 now added Imports rather Suggests, automatically installed install devtools.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"deprecated-functions-now-removed-2-1-0","dir":"Changelog","previous_headings":"","what":"Deprecated functions now removed","title":"devtools 2.1.0","text":"create(), create_description(), setup() use_appveyor(), use_build_ignore(), use_code_of_conduct(), use_coverage(), use_cran_badge(), use_cran_comments(), use_data(), use_data_raw(), use_dev_version(), use_git(), use_git_hook(), use_github(), use_github_links(), use_gpl3_license(), use_mit_license(), use_news_md(), use_package(), use_package_doc(), use_rcpp(), use_readme_md(), use_readme_rmd(), use_revdep(), use_rstudio(), use_test(), use_testthat(), use_travis(), use_vignette(), removed deprecated previous releases. Use versions usethis package directly. check_cran(), revdep_check(), revdep_check_print_problems(), revdep_check_reset(), revdep_check_resume(), revdep_check_save_summary(), revdep_email() removed deprecated previous releases. recommended use revdepcheck package instead. system_check(), system_output() removed deprecated previous releases. recommend use processx package instead. build_win() removed, deprecated previous releases. yesno() used release() now clearer synonyms “yes” (@mattmalin, #1993)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-fixes-2-1-0","dir":"Changelog","previous_headings":"","what":"Minor improvements and fixes","title":"devtools 2.1.0","text":"check_rhub gains new argument build_args arguments passed R CMD build. ... now passed rhub::check_for_cran() (@gaborcsardi, @maelle, #2041) build_manual() now fails manual fails build. (#2056) test_file() test_coverage_file() now work C C++ files src/ directory well.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-202","dir":"Changelog","previous_headings":"","what":"devtools 2.0.2","title":"devtools 2.0.2","text":"CRAN release: 2019-04-08 Two tests now skipped run CRAN, fail due outdated pandoc restrictions writing package library respectively. load_all() now accepts ‘package’ objects, regaining previous behavior devtools prior 2.0.0 (#1923) test(), test_coverage() test_coverage_file() now set TESTTHAT_PKG environment variable, consistent running tests R CMD check (testthat#787). check() now replaces existing environment variables rather appending (#1914).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-201","dir":"Changelog","previous_headings":"","what":"devtools 2.0.1","title":"devtools 2.0.1","text":"CRAN release: 2018-10-26 minor release mainly fixing bugs snuck devtools 2.0.0 release. install() now correctly passes upgrade parameter remotes::install_deps() (@Paxanator, #1898). install_deps() now works directory within package (#1905) Add RStudio addin test_coverage(). tests use remote resources now skipped CRAN, avoid spurious failures","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-200","dir":"Changelog","previous_headings":"","what":"devtools 2.0.0","title":"devtools 2.0.0","text":"CRAN release: 2018-10-19 Devtools 2.0.0 major release contains work past year half, since major devtools release (1.13.0). release splits functionality devtools number smaller packages simpler develop also easier packages depend . particular following packages spun calling ‘conscious uncoupling’ devtools. remotes: Installing packages (.e. install_github()). pkgbuild: Building binary packages (including checking build tools available) (.e. build()). pkgload: Simulating package loading (.e. load_all()). rcmdcheck: Running R CMD check reporting results (.e. check()). revdepcheck: Running R CMD check reverse dependencies, figuring ’s changed since last CRAN release (.e. revdep_check()). sessioninfo: R session info (.e. session_info()). usethis: Automating package setup (.e. use_test()). devtools remain main package developers interact writing R packages; just rely packages internally functionality.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"breaking-changes-2-0-0","dir":"Changelog","previous_headings":"","what":"Breaking changes","title":"devtools 2.0.0","text":"number breaking changes release, cause short term pain users result easier understand API future, feel tradeoff worthwhile. devtools::install() arguments changed follows. local -> build force_deps -> force upgrade_dependencies -> upgrade threads -> Removed, can use Ncpus, passed ... install.packages() metadata -> Removed out_dir -> Removed skip_if_log_exists -> Removed check() argument check_version renamed remote better describe tests disabled (#1811) get_path(), set_path(), add_path() on_path() removed, functionality available withr::with_path() (#1796). lang argument spell_check() removed, compatibility spelling v1.1. (#1715) previously deprecated with_ functions now removed. functionality moved withr package. RCMD(), clean_source(), eval_clean() evalq_clean() removed. functions never worked terribly well, replaced much better functions callr. build_win() renamed check_win_release(), check_win_devel(), check_win_oldrelease() (#1598).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"deprecated-functions-2-0-0","dir":"Changelog","previous_headings":"","what":"Deprecated functions","title":"devtools 2.0.0","text":"Infrastructure functions (use_*) now use implementations usethis versions devtools deprecated. use package switch package depend usethis directly instead. revdep_check_* functions deprecated favor revdepcheck package. system_check() system_output() deprecated factor processx package.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"major-changes-2-0-0","dir":"Changelog","previous_headings":"","what":"Major changes","title":"devtools 2.0.0","text":"install_*() functions now re-exported remotes rather defined devtools devtools now depends roxygen2 6.1.0: considerably simplifies devtools::document() makes consistent roxygen2::roxygenise(). test_file() function added test one files package (#1755). test_coverage() function added provide helper compute test coverage using covr (#1628). test_file() test_coverage_file() now RStudio addins (#1650) test_file_coverage() function added show test coverage one files package. (#1755). session_info() now uses implementation sessioninfo package. Packages using devtools::session_info() encouraged switch using sessioninfo::session_info() instead. package_info() function now re-exported sessioninfo package. check() now uses rcmdcheck run parse R CMD check output (#1153). Code related simulating package loading pulled separate package, pkgload. following functions moved pkgload without shim: clean_dll(), compile_dll(), dev_example(), dev_help(), dev_meta(), find_topic(), imports_env(), inst(), load_code(), load_dll(), ns_env(), parse_ns_file(), pkg_env(). functions primarily internal use. load_all() unload() moved pkgload, devtools provides shims since commonly used. find_rtools(), setup_rtools(), has_devel(), compiler_flags(), build() with_debug() moved new pkgbuild package. build() with_debug() re-exported devtools spell_check() code moved new spelling package thereby gained support vignettes package wordlists. devtools function now wraps spelling::spell_check_package().","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-fixes-2-0-0","dir":"Changelog","previous_headings":"","what":"Minor improvements and fixes","title":"devtools 2.0.0","text":"check_win_*() now build package manual = TRUE default (#1890). check() output now works nicely recent changes rcmdcheck (#1874). reload() now reloads loaded attached packages well attached ones. Executed styler::style_pkg() update code style (#1851, @amundsenjunior). save_all() helper function wraps rstudioapi::documentSaveAll() calls (#1850, @amundsenjunior). check() now allows users run without --timings (#1655) update_packages() better documented advertise can used update packages installed install_* functions. check() gains incoming option toggle CRAN incoming checks. build_vignette() gains keep_md option allow keeping intermediate markdown output (#1726) remote_sha.github() now correctly looks SHA private repositories (#1827, @renozao). devtools use_*() functions now temporarily set active usethis project given pkg argument current directory. provides backwards compatibility previous behavior (#1823). Vignettes now built separate process, package installed building vignettes (#1822) build_readme() added build README.md README.Rmd (#1762) build_vignettes() now clean upgrade arguments, control cleaning intermediate files upgrading vignette dependencies respectively. (#1770). release() gains additional question ensuring updated codemeta.json one exists (#1774, #1754) test() now sets useFancyQuotes = FALSE better mimic environment tests run R CMD check (#1735). test() longer passes encoding argument testthat::test_dir() (#1776) install_url() can now install package binaries windows (#1765) Fix skipping installing full SHA (#1624) add pkgdown::build_site() wrapper (@kiwiroy, #1777) add pkgdown site (https://devtools.r-lib.org) (#1779, @jayhesselberth) install_version() can now install current version CRAN package Windows macOS (@jdblischak, #1730) CRAN-RELEASE file now added .Rbuildignore (#1711) check() check_built() now error_on argument specify throw error check failures. run non-interactively set “warnings” unless specified. check() now sets _R_CHECK_CRAN_INCOMING_REMOTE_ instead _R_CHECK_CRAN_INCOMING_on R versions support former option (#1271, #1276, #1702). Now use cli package draw rules - aesthetically pleasing correct width RStudio build pane (#1627). release() tweaked reflect modern submission workflow ask questions rather running code (#1632). document(), load_all(), check(), build() test() now automatically save open files run inside RStudio IDE. (#1576) New check_rhub() function check packages using https://builder.r-hub.io/. run_examples mistakenly passing show pkgload::run_example, causing fail (@amcdavid, #1449) New build_manual() function produces pdf manual package (@twolodzko, #1238). use git release() now generates file called CRAN-RELEASE reminds tag commit submitted CRAN (#1198). release() looks additional release questions correct environment (#1434). submit_cran() now checks ’re ready submit, since potentially expensive operation (#1228) check() defaults running document() used roxygen previously (#1437). Signal error commas missing remote entries (#1511, @ianmcook). build_vignettes() gains quiet argument (#1543). source_gist() works single file gist (#1266). order run test helpers document(), helpers argument  load_all() set FALSE (@nbenn, #1669) my_unzip() function now able use utils::unzip fallback R compiled source unzip package present (@theGreatWhiteShark, #1678) foghorn package installed, release() displays results CRAN checks (#1672, @fmichonneau).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1135","dir":"Changelog","previous_headings":"","what":"devtools 1.13.5","title":"devtools 1.13.5","text":"CRAN release: 2018-02-18 Fix two test errors related GitHub rate limiting mocking base functions.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1134","dir":"Changelog","previous_headings":"","what":"devtools 1.13.4","title":"devtools 1.13.4","text":"CRAN release: 2017-11-09 Fix test errors upcoming testthat release.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1133","dir":"Changelog","previous_headings":"","what":"devtools 1.13.3","title":"devtools 1.13.3","text":"CRAN release: 2017-08-02 Workaround change Rcpp::compileAttributes stores symbol names broke tests.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1132","dir":"Changelog","previous_headings":"","what":"devtools 1.13.2","title":"devtools 1.13.2","text":"CRAN release: 2017-06-02 Workaround regression Rcpp::compileAttributes. Add trimws implementation R 3.1 support.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1131","dir":"Changelog","previous_headings":"","what":"devtools 1.13.1","title":"devtools 1.13.1","text":"CRAN release: 2017-05-13 Bugfix installing git remote passing git2r credentials (@james-atkins, #1498) Bugfix installation dependencies dependencies (@jimhester, #1409). Bugfix installation dependencies CRAN-like repositories created drat (@jimhester, #1243, #1339). load_all() longer automatically creates description . use_test() template longer includes useless comments (#1349) Fix test() compatibility testthat versions 1.0.2 (#1503). Fix install_version(), install_bitbucket(), install_local(), install_url(), install_svn(), install_bioc() gain quiet arguments properly pass internal functions. (#1502)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1130","dir":"Changelog","previous_headings":"","what":"devtools 1.13.0","title":"devtools 1.13.0","text":"CRAN release: 2017-05-08","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-13-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"devtools 1.13.0","text":"spell_check gains dict argument set custom language dictionary release() now checks documentation spelling errors default. New use_gpl3_license() sets license field DESCRIPTION includes copy license LICENSE.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"revdep-check-improvements-1-13-0","dir":"Changelog","previous_headings":"","what":"Revdep check improvements","title":"devtools 1.13.0","text":"Various minor improvements around checking reverse dependencies (#1284, @krlmlr). packages involved listed start, whole process now resilient package installation failures. revdep_check() revdep_check_resume() gain skip argument takes character vector packages skip. revdep_check() check_cran() gain quiet_check argument. can use quiet_check = FALSE see actual text R CMD check runs (recommending multiple threads). revdep_check_resume() now takes ... can used override settings revdep_check(). debugging problem package checks, try revdep_check(threads = 1, quiet_check = FALSE) revdep_check() collects timing information timing.md (#1319, @krlmlr). Package names examples sorted case-insensitive C collation (#1322, @krlmlr). use_revdep() adds .gitignore entry check database (#1321, @krlmlr). package installed temporary library revdep checking (#1338, @krlmlr). Automated revdep check e-mails now can use new my_version you_cant_install variables. e-mail template updated use variables (#1285, @krlmlr). Installation failures logged revdep checking, default revdep/install. installation failed, attempted second time (#1300, @krlmlr). Print summary table README.md problems.md (#1284, @krlmlr). Revdep check improvements (#1284)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-and-minor-improvements-1-13-0","dir":"Changelog","previous_headings":"","what":"Bug fixes and minor improvements","title":"devtools 1.13.0","text":"Handle case un-installed package passed session_info (#1281). Using authentication access Github package name. (#1262, @eriknil). spell_check() checks hunspell running (#1475, @jimvine). add_desc_package() checks package dependencies correctly (#1463, @thomasp85). Remove deprecated args argument install_git() allow passthrough install (#1373, @ReportMort). added quiet argument install_bitbucket(), default value FALSE (fixes issue #1345, @plantarum). update_packages() allows override interactive prompt (#1260, @pkq). use_test() template longer includes useless comments (#1349) Add encoding support test_dir() call adding reference pkg$encoding (#1306, @hansharhoff) Parse valid Git remote URLs lack trailing .git, e.g. GitHub browser URLs (#1253, @jennybc). Add check_bioconductor() internal function automatically install BiocInstaller() installed user wants . Improve Git integration. use_git_ignore() use_git_config() gain quiet argument, tests work without setting user.name user.email Git configuration settings (#1320, @krlmlr). Improve Git status checks used release() (#1205, @krlmlr). Improved handling local file:// repositories install() (#1284, @krlmlr). setup() create() gain new quiet argument (#1284, @krlmlr). Avoid unnecessary query available_packages() (#1269, @krlmlr). Add cache setting AppVeyor template (#1290, @krlmlr). Fix AppVeyor test manually installing curl (#1301). install(dependencies = FALSE) doesn’t query available packages anymore (@krlmlr, #1269). use_travis() now opens webpage browser easily activate repo. use_readme_rmd() use_readme() share common template sections package overview, GitHub installation (applicable), example (@jennybc, #1287). test() doesn’t load helpers twice anymore (@krlmlr, #1256). Fix auto download method selection install_github() R 3.1 lacks “libcurl” capabilities(). (@kiwiroy, #1244) Fix removal vignette files trying remove files twice anymore (#1291) add timestamp messages build_win() (@achubaty, #1367).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1120","dir":"Changelog","previous_headings":"","what":"devtools 1.12.0","title":"devtools 1.12.0","text":"CRAN release: 2016-06-24","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-12-0","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 1.12.0","text":"New install_bioc() function bioc remote install Bioconductor packages SVN repository. install_dev_deps() gets everything need start development source package - installs dependencies, roxygen2 (#1193). use_dev_version() automates process switching release version number tweaking DESCRIPTION, adding heading NEWS.md (present), checking git (use ) (#1076.) use_github() accepts host argument, similar install_github() (@ijlyttle, #1101)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-and-minor-improvements-1-12-0","dir":"Changelog","previous_headings":"","what":"Bug fixes and minor improvements","title":"devtools 1.12.0","text":"Update Rtools-3.4 information, (@jimhester) devtools now uses https access RStudio CRAN mirror work system (#1059) Handle case GitHub request returns non-JSON error response. (@jimhester, #1204, #1211) Suggested packages, including specified Remotes: now installed package installation. allows use circular Remotes: dependencies two related packages long one dependencies Suggested package. (@jimhester, #1184, hadley/dplyr#1809) bug fix installation binary packages windows, must installed directly zip file. (@jimhester, #1191, #1192) build_vignette() now install “VignetteBuilder” ’s present, try upgrade (#1139). clean_dll() removes package_name.def files now operates recursively. (@jimhester, #1175, #1159, #1161) check_man() now prints message problems found (#1187). install_* functions update_packages() refactored allow updating packages installed using install methods. (@jimhester, #1067) install_github() now uses https://api.github.com host argument, users can specify ‘http:’ protocols needed. (@jimhester, #1131, #1200) load_all() runs package hooks sourcing test helper files allowing test helper make use objects created package loaded attached. (@imanuelcostigan, #1146) revdep_check() now create revdep/ directory already exist (#1178). source_gist() gains filename argument specify particular file source GitHub gist. (@ateucher, #1172) Add default codecov.yml file turn commenting use_coverage() (@jimhester, #1188) Bug fix ‘nchar(text) : invalid multibyte string’ errors running write_dcf() DESCRIPTION files non-ASCII encodings (#1224, @jimhester).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1111","dir":"Changelog","previous_headings":"","what":"devtools 1.11.1","title":"devtools 1.11.1","text":"CRAN release: 2016-04-21 Bug fix search_path_for_rtools() using gcc-4.9.3 toolchain rtools setting windows registry. (@jimhester, #1155)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1110","dir":"Changelog","previous_headings":"","what":"devtools 1.11.0","title":"devtools 1.11.0","text":"CRAN release: 2016-04-12","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"infrastructure-helpers-1-11-0","dir":"Changelog","previous_headings":"","what":"Infrastructure helpers","title":"devtools 1.11.0","text":"create_description() now sets Encoding: UTF-8. helps non-English package authors (#1123). use_ function overhauled consistent, particularly around notification. functions now also ask overwrite file already exists (#1074). use_coverage() now adds covr “Suggests”, rather recommending install explicitly .travis.yml. use_cran_badge() now uses HTTPS URL (@krlmlr, #1124). use_github() now confirms ’ve picked good title description (#1092) prints url repo (#1063). use_news(), use_test() open files RStudio (’re using rstudioapi package installed). use_testthat() tells ’s (#1056). use_travis() generates template compatible newest R-travis. use_readme_md() creates basic README.md template (#1064). use_revdep() updated template new revdep check system (#1090, @krlmlr). Removed deprecated use_coveralls(), add_rstudio_project(), add_test_infrastructure(), add_travis(). Deprecated build_github_devtools() removed.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"checks-and-release-1-11-0","dir":"Changelog","previous_headings":"","what":"Checks and release()","title":"devtools 1.11.0","text":"check() now always succeeds (instead throwing error R CMD check finds ERROR), returning object summarises check failures. check() gains run_dont_test manual arguments control whether \\donttest{} tests tested, manuals built. defaults FALSE, release() runs check set TRUE (#1071; #1087, @krlmlr). cleanup argument check() deprecated: now always returns path check directory. check_built() allows run R CMD check already built package. check_cran() suppresses X11 DISPLAY = \"\". release() tweaked improve order questions, ensure ’re ok problems. warns inst/NEWS.Rd NEWS.md exist (@krlmlr, #1135), doesn’t throw error Git head detached (@krlmlr, #1136). release() gains args argument control build options, e.g. allow passing args = \"--compact-vignettes=\" packages heavy PDF vignettes (@krlmlr, #1077). system_check() gains new arguments path controls working directory command, throw control whether throws error command failure. env renamed explicit env_vars.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"revdep-checks-1-11-0","dir":"Changelog","previous_headings":"","what":"Revdep checks","title":"devtools 1.11.0","text":"revdep_check() overhauled. revdep_ functions now work like devtools functions, taking path package first argument. revdep_check() now saves results disk check/check.rds, revdep() functions read cache. also allows resume partial run revdep_check_resume(). big time saver something goes unexpected wrong middle checks. can blow away cache start afresh revdep_check_reset(). revdep_check_save_summary() now creates README.md save one level clicking github. also creates problems.md contains results packages warnings errors. problem limited 25 lines output - avoids lengthy output failing examples. revdep_check_print_problems() prints bulleted list problems, suitable inclusion cran-comments.md. Summary results reported come , every messages ’ll get message giving elapsed estimated remaining time. experimental revdep_email() emails individual maintainers R CMD check summary results (#1014). See testthat dplyr example usage. handful smaller fixes: revdep_check() doesn’t complain missing git2r package anymore (#1068, @krlmlr). Package index caches revdep_check() now time 30 minutes. revdep_check_save_logs() removed - just useful. revdep_check_summary() removed - never part exported API.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"other-improvements-1-11-0","dir":"Changelog","previous_headings":"","what":"Other improvements","title":"devtools 1.11.0","text":"Devtools now uses new gcc toolchain windows, installed (@jimhester). install_git() now allows pass credentials git2r specify specific ssh credentials (@onlymee, #982) load_all() now sources test helpers use testthat. makes much easier interactively run tests (#1125). load_all() also correctly handles unix windows subdirectories within R (@gaborcsardi, #1102) build_win() defaults R-devel, since commonly want. Help shims now inform ’re using development documentation (#1049). git_sha1() Fix fetching latest git commit also works shallow git clones, .e. git clones make use depth. (#1048, #1046, @nparley)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-1100","dir":"Changelog","previous_headings":"","what":"devtools 1.10.0","title":"devtools 1.10.0","text":"CRAN release: 2016-01-23","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-10-0","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 1.10.0","text":"curl, evaluate, roxygen2 rversions moved Imports Suggests lighten dependency load devtools. run function needs one packages, ’ll prompted install (#962, @jimhester). Devtools uses new strategy detecting RTools windows: now looks Rtools need load_all() build() package compiled code. make easier work devtools ’re developing pure R packages (#947). package_file() lets find files inside package. starts finding root directory package (.e. directory contains DESCRIPTION) (#985). use_news_md() adds basic NEWS.md template (#957). use_mit_license() writes necessary infrastructure declare release R package MIT license CRAN-compliant way. (#995, @kevinushey) check(cran = TRUE) adds --run-donttest since need test code \\donttest() CRAN submission (#1002).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"package-installation-1-10-0","dir":"Changelog","previous_headings":"","what":"Package installation","title":"devtools 1.10.0","text":"install() installs packages specified Additional_repositories field, drat repositories. (#907, #1028, @jimhester). correctly installs missing dependencies (#1013, @gaborcsardi). called Bioconductor package, include Bioconductor repositories already set (#895, @jimhester). install() gains metadata argument lets add extra fields DESCRIPTION install. (#1027, @rmflight) install_github() install_git() downloads installs package remote SHA1 reference differs currently installed reference (#903, @jimhester). install_local() captures git github information stores DESCRIPTION (#1027, @rmflight). install_version() robust handling multiple repos (#943, #1030, @jimhester). Bugfix Remotes: feature prevented working devtools attached done travis-r (#936, @jimhester).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-and-minor-improvements-1-10-0","dir":"Changelog","previous_headings":"","what":"Bug fixes and minor improvements","title":"devtools 1.10.0","text":"check_dev_versions() checks package dependencies (#983). check_man() replaces check_doc() (since functions named corresponding directory). check_doc() hang around alias foreseeable future (#958). create() produces dummy namespace fake comment roxygen2 overwrite silently (#1016). create() setup() permissive – now accept path either new directory empty directory. (#966, @kevinushey) document() now runs update_collate() . load_all() resolves longstanding lazy load database corruption issue reloading packages define S3 methods generics base packages (#1001, @jimhester). release_checks() gains two new checks: check_vignette_titles() checks vignette titles aren’t default “Vignette Title” (#960, @jennybc). check_news_md() checks NEWS.md isn’t .Rbuildignore (since ’s now supported CRAN, #1042). revdep_check(): verbose package installed (#926, @krlmlr) Verifies integrity already downloaded package archives (#930, @krlmlr) now tolerant errors retrieving summary checked package (#929, @krlmlr). ncpus > 1, includes package name know package failed can start looking output without needing wait packages finish (@mattdowle). Uses proper repository BiocInstaller::useDevel(TRUE) (#937, @jimhester). Shimmed system.file() now respects mustWork = TRUE throws error file exist (#1034). use_appveyor() template now creates failure.zip artifact instead polluting logs R CMD check output (#1017, @krlmlr, @HenrikBengtsson). use_cran_comments() template improved (#1038). use_data() now warns trying save object twice, stops object save (#948, @krlmlr). use_revdep_check() longer includes revdep_check_save_logs default template. found never used logs just cluttered package directory (#1003). with_*() functions moved withr package, devtools functions deprecated (#925, @jimhester).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-191","dir":"Changelog","previous_headings":"","what":"devtools 1.9.1","title":"devtools 1.9.1","text":"CRAN release: 2015-09-11 Avoid importing heavy dependencies speed loading (#830, @krlmlr). Remove explicit library(testthat) call test() (#798, @krlmlr). .package() load_all() gain new argument create. Like functions pkg argument, load_all() looks DESCRIPTION file parent directories - create = TRUE automatically created ’s R/ data/ directory (#852, @krlmlr). build_vignettes() gains dependencies argument (#825, @krlmlr). build_win() now uses curl instead RCurl ftp upload. build_win() asks consent receive e-mail maintainer address interactive mode (#800, @krlmlr). check() now uses better strategy cran = TRUE. Instead attempting simulate ---cran behaviour turning certain env vars, now uses ---cran turns problematic checks env vars (#866). problematic cran_env_vars() function removed. find_rtools() now looks registry keys HKCU (user) HKLM (admin) locations (@Kevin-Jin, #844) install() can now install dependencies remote repositories specifying Remotes DESCRIPTION file (#902, @jimhester). See vignette(\"dependencies\") details. install_*() detects called Bioconductor package , automatically includes Bioconductor repositories needed (#895, @jimhester). install_deps() now automatically upgrades date dependencies. typically want ’re working development version package. suppress behaviour, set upgrade_dependencies = FALSE (#863). install_deps() careful ... - means additional arguments install_* likely work (#870). install_gitorious() removed since gitorious longer exists (#913). load_all() longer fails useDynLib() entry NAMESPACE incorrect. make easy recover incorrect @useDynLib, re-documenting() now succeed. release() works packages located root git repository (#845, #846, @mbjones). revdep_check() now installs suggested packages default (#808), sets NOT_CRAN env var false (#809). makes testing similar CRAN packages pass cleanly. also sets RGL_USE_NULL true stop rgl windows popping testing (#897). also downloads source packages beginning - makes life bit easier ’re flaky internet connection (#906). New uninstall() removes installed package (#820, @krlmlr). Add use_coverage() function add codecov.io coveralls.io project, deprecate use_coveralls() (@jimhester, #822, #818). use_cran_badge() uses canonical url form preferred CRAN. use_data() also works data parent frame (#829, @krlmlr). use_git_hook() now creates .git/hooks needed (#888) GitHub integration extended: use_github() gains protocol argument (ssh https), populates URL BugReports fields DESCRIPTION (non-existent empty), pushes newly created GitHub repo, sets remote tracking branch. use_github_links() new exported function. dr_github() diagnoses possible problems. (#642, @jennybc). use_travis(): Default travis script leaves notifications default settings. uses_testthat() check_failures() now exported (#824, #839, @krlmlr). use_readme_rmd() uses uses_git() correctly (#793). with_debug() now uses with_makevars() rather with_env(), R reads compilation variables Makevars rather environment (@jimhester, #788). Properly reset library path with_lib() (#836, @krlmlr). remove_s4classes() performs topological sort classes (#848, #849, @famuvie). load_all() warns (instead failing) importing symbols, methods, classes NAMESPACE fails (@krlmlr, #921).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-180","dir":"Changelog","previous_headings":"","what":"devtools 1.8.0","title":"devtools 1.8.0","text":"CRAN release: 2015-05-09","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"helpers-1-8-0","dir":"Changelog","previous_headings":"","what":"Helpers","title":"devtools 1.8.0","text":"New dr_devtools() runs common diagnostics: using latest version R devtools? run automatically release() (#592). use_code_of_conduct() adds contributor code conduct http://contributor-covenant.org. (#729) use_coveralls() allows easily add test coverage coveralls (@jimhester, #680, #681). use_git() sets package use git, initialising repo checking existing files. use_test() adds new test file (#769, @krlmlr). New use_cran_badge() adds CRAN status badge can copy README file. Green indicates package CRAN. Packages yet submitted accepted CRAN get red badge.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"package-installation-and-info-1-8-0","dir":"Changelog","previous_headings":"","what":"Package installation and info","title":"devtools 1.8.0","text":"build_vignettes() automatically installs VignetteBuilder package, necessary (#736). install() install_deps() gain ... argument, additional arguments can passed utils::install.packages() (@jimhester, #712). install_svn() optionally accepts revision (@lev-kuznetsov, #739). install_version() now knows look multiple repos (#721). package_deps() (dev_package_deps()) determines recursive dependencies whether ’re --date (#663). Use update(package_deps(\"xyz\")) update date dependencies. code used install_deps() revdep_check() - ’s slightly aggressive previous code (.e. forces use latest version), avoid problems go submit CRAN. New update_packages() install package (dependencies) missing date (#675). session_info() can now take vector package names, case print version packages dependencies (#664).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"git-and-github-1-8-0","dir":"Changelog","previous_headings":"","what":"Git and github","title":"devtools 1.8.0","text":"Devtools now uses git2r package inspect git properties install remote git packages install_git(). considerably reliable previous strategy involves calling command line git client. two small downsides: install_git() longer accepts additional args, must deep clone installing. dr_github() checks common problems git/github setup (#643). use git, release() now warns uncommited changes, ’ve forgotten synchronise remote (#691). install_github() warns repository contains submodules (@ashander, #751).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-and-minor-improvements-1-8-0","dir":"Changelog","previous_headings":"","what":"Bug fixes and minor improvements","title":"devtools 1.8.0","text":"Previously, devtools ran external R processes R --vanilla. Now suppresses user profiles, constructs custom .Rprofile override default. Currently, .Rprofile sets repos option. Among others, enables cyclic dependency check devtools::release (#602, @krlmlr). R_BROWSER R_PDFVIEWER environment variables set “false” suppress random windows opening checks. Devtools correctly identifies RTools 3.1 3.2 (#738), preserves continuation lines DESCRIPTION (#709). dev_help() now uses normalizePath(). Hopefully make likely work ’re windows space path. lint() gains cache argument (@jimhester, #708). Fixed namespace issues related stats::setNames() (#734, #772) utils::unzip() (#761, @robertzk). release() now reminds check existing CRAN check results page (#613) shows file size uploading CRAN (#683, @krlmlr). RCMD() system_check() now exported can used packages. (@jimhester, #699). revdep_check() creates directories needed (#759). system_check() combines arguments , ,. (#753) test() gains ... argument additional arguments can passed testthat::test_dir (@jimhester, #747) use_travis() now suggests link svg icon since looks little sharper. Default template sets CRAN: http://cran.rstudio.com/ enable cyclic dependency check. NOT_CRAN envvar longer overrides externally set variable. check(check_version = TRUE) also checks spelling DESCRIPTION; spell checker installed, warning given (#784, @krlmlr).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-170","dir":"Changelog","previous_headings":"","what":"devtools 1.7.0","title":"devtools 1.7.0","text":"CRAN release: 2015-01-17","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"improve-reverse-dependency-checking-1-7-0","dir":"Changelog","previous_headings":"","what":"Improve reverse dependency checking","title":"devtools 1.7.0","text":"Devtools now supports new improved style revdep checking use_revdep(). creates new directory called revdep contains check.R template. Run template check reverse dependencies, save summarised results check/summary.md. can check file git, making much easier track reverse dependency results change versions. documentation revdep_check() much improved, useful (#635) recommend specify library use checking options(\"devtools.revdep.libpath\"). (directory already exists). difference default library keep revdep environment isolated development environment. ’ve also tweaked output revdep_maintainers() ’s easier copy paste email (#634). makes life little easier pre-release.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-helpers-1-7-0","dir":"Changelog","previous_headings":"","what":"New helpers","title":"devtools 1.7.0","text":"lint() runs lintr::lint_package() check style consistency errors package. (@jimhester, #694) use_appveyor() sets package testing AppVeyor (@krlmlr, #549). use_cran_comments() creates cran-comments.md template adds .Rbuildignore help CRAN submissions. (#661) use_git_hook() allows easily add git hook package. use_readme_rmd() sets template generate README.md README.Rmd knitr.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-1-7-0","dir":"Changelog","previous_headings":"","what":"Minor improvements","title":"devtools 1.7.0","text":"Deprecated doc_clean argument check() removed. Initial package version create() now 0.0.0.9000 (#632). create() create_description() checks package name valid (#610). load_all() runs roxygen2::update_collate() loading code. ensures files sourced way expect, defined roxygen @include tags. don’t @include tags, collate touched (#623). session_info() gains include_base argument also display loaded/attached base packages (#646). release() longer asks ’ve read CRAN policies since CRAN submission process now asks question (#692). release(check = TRUE) now runs additional custom checks. include: Checking don’t depend development version package. Checking version number exactly three components (#633). release() now builds packages without ---manual switch, checking actually building release package (#603, @krlmlr). build() gains additional argument manual, defaulting FALSE, check() gains ... unmodified build(). use_travis() now sets environment variable WARNING also cause build fail (#570). with_debug() compiler_flags() set CFLAGS etc instead PKG_CFLAGS. PKG_* packages use, raw values users set. (According http://cran.rstudio.com/doc/manuals/r-devel/R-exts.html#Using-Makevars) New setup() works like create() assumes existing, necessarily empty, directory (#627, @krlmlr).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-1-7-0","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 1.7.0","text":"installing pull request, install_github() now uses repository associated pull request’s branch (repository user created pull request) (#658, @krlmlr). missing_s3() works (#672) Fixed scoping issues unzip(). load_code() now executes package’s code package’s root working directory, just like R CMD build et al. (#640, @krlmlr).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-161","dir":"Changelog","previous_headings":"","what":"devtools 1.6.1","title":"devtools 1.6.1","text":"CRAN release: 2014-10-07 Don’t set non-portable compiler flags Solaris. file template.Rproj now correctly installed function use_rstudio works . (#595, @hmalmedal) function use_rcpp now create file src/.gitignore correct wildcards. (@hmalmedal) functions test, document, load_all, build, check function applies package directory work subdirectories package (like “R” “inst/tests” directories). (#616, @robertzk)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-16","dir":"Changelog","previous_headings":"","what":"devtools 1.6","title":"devtools 1.6","text":"CRAN release: 2014-09-23","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"tool-templates-and-create-1-6","dir":"Changelog","previous_headings":"","what":"Tool templates and create()","title":"devtools 1.6","text":"create() longer generates man/ directory - roxygen2 now automatically. also longer generates package-level doc template. want , use use_package_doc(). also makes dummy namespace can build & reload without running document() first. New use_data() makes easy include data package, either data/ (exported datasets) R/sysdata.rda (internal data). (#542) New use_data_raw() creates data-raw/ directory reproducible generation data/ files (#541). New use_package() allows set dependencies (#559). New use_package_doc() sets Roxygen template package-level docs. New use_rcpp() sets package use Rcpp. use_travis() now figures github username repo can construct markdown build image. (#546) New use_vignette() creates draft vignette using Rmarkdown (#572). renamed add_rstudio_project() use_rstudio(), add_travis() use_travis(), add_build_ignore() use_build_ignore(), add_test_infrastructure() use_testthat() (old functions aliased new)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"the-release-process-1-6","dir":"Changelog","previous_headings":"","what":"The release process","title":"devtools 1.6","text":"can add arbitrary extra questions release() defining function release_questions() package. release_questions() return character vector questions ask (#451). release() uses new CRAN submission process, implemented submit_cran() (#430).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"package-installation-1-6","dir":"Changelog","previous_headings":"","what":"Package installation","title":"devtools 1.6","text":"install_* now use code store much useful metadata. Currently session_info() takes advantage information, allow development future tools like generic update functions. Vignettes longer installed default potentially require suggested packages also installed. Use build_vignettes = TRUE force building install suggested packages (#573). install_bitbucket() bought alignment install_github(): means can now specify repos compact username/repo@ref syntax. username now deprecated. install_git() simplified many arguments changed names consistency metadata package installs. install_github() considerably improved: username deprecated - please include user repo name: rstudio/shiny, hadley/devtools etc. dependencies = TRUE longer forced (regression 1.5) (@krlmlr, #462). Deprecated parameters auth_user, branch, pull password removed. New host argument allows install packages github enterprise (#410, #506). GitHub API used download archive file (@krlmlr, #466) - makes less likely break future. download specified pull request, use ref = github_pull(...) (@krlmlr, #509). install latest release, use \"user/repo@*release\" ref = github_release() (@krlmlr, #350). install_gitorious() bought alignment install_github(): means can now specify repos compact username/repo@ref syntax. must now always supply user (project) name repo. install_svn() lets install R package subversion repository (assuming subversion installed). decompress() hence install_url() now work downloaded file decompresses without additional top-level directory (#537).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"other-minor-improvements-and-bug-fixes-1-6","dir":"Changelog","previous_headings":"","what":"Other minor improvements and bug fixes","title":"devtools 1.6","text":"’re using RStudio, ’re trying build binary package without necessary build tools, RStudio prompt download install right thing. (#488) Commands longer run LC_ALL=C - longer seems necessary (#507). build(binary = TRUE) creates even--temporary package library avoid conflicts (#557). check_dir() longer fails UNC paths (#522). check_devtools() also checks dependencies development versions packages (#534). load_all() longer fails partial loading package containing S4 RC classes (#577). windows, find_rtools() now run package load, package attach. help(), ?, system.file() now made available package loaded load_all(), even devtools package isn’t attached. httr 0.3 required (@krlmlr, #466). load_all() longer gives error objects listed exports missing. Shim added library.dynam.unload(). loaded_packages() now returns package name path loaded . (#486) parenvs() function removed devtools, now pryr package. missing_s3() uses better heuristic determining function S3 method (#393). New session_info() provides useful information R session. ’s little focussed sessionInfo() includes packages installed (#526). rstudioapi package moved suggests imports, since ’s always needed (’s job figure rstudio available, #458) Implemented version utils::unzip() throws error command fails doesn’t print unneeded messages non-Windows platforms (#540). Wrote version write.dcf() doesn’t butcher whitespace fieldnames.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"removed-functionality-1-6","dir":"Changelog","previous_headings":"","what":"Removed functionality","title":"devtools 1.6","text":"fresh argument test() removed - best done editor since can run tests completely clean environment starting new R session. compile_dll() can now build packages located R’s tempdir() directory (@richfitz, #531).","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-15","dir":"Changelog","previous_headings":"","what":"devtools 1.5","title":"devtools 1.5","text":"CRAN release: 2014-04-07 Four new functions make easier add useful infrastructure packages: add_test_infrastructure() create test infrastructure new package. called automatically test() test directories found, session interactive agree. add_rstudio_project() adds RStudio project file package. create() gains rstudio argument automatically create RStudio project package directory. defaults TRUE: don’t use RStudio, just delete file. add_travis() adds basic travis template package. .travis.yml automatically added .Rbuildignore avoid including built package. add_build_ignore() makes easy add files .Rbuildignore, correctly escaping special characters Two dependencies incremented: devtools requires least R version 3.0.2. document() requires least roxygen2 version 3.0.0.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-1-5","dir":"Changelog","previous_headings":"","what":"Minor improvements","title":"devtools 1.5","text":"build_win() now builds R-release R-devel default (@krlmlr, #438). also gains parameter args, passed build() (@krlmlr, #421). check_doc() now runs document() automatically. install() gains thread argument allows install multiple packages parallel (@mllg, #401). threads argument check_cran() now defaults getOption(\"Ncpus\") install_deps(deps = T) longer installs dependencies dependencies (#369). install_github() now prefers personal access tokens supplied auth_token rather passwords (#418, @jeroenooms). install_github() now defaults dependencies = TRUE definitely get packages need build source. devtools supplies version system.file() function called R console, special behavior packages loaded devtools. devtools supplies version help ?, search devtools-loaded packages well normally-loaded packages.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-1-5","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 1.5","text":"check_devtools() longer called check() relevant functionality now included R CMD CHECK causing false positives (#446). install_deps(TRUE) now includes packages listed VignetteBuilder (#396) build() longer checks pdflatex building vignettes, many modern vignettes don’t need (#398). also uses ---build-vignettes >3.0.0 compatibility (#391). release() better job opening email client ’re inside RStudio (#433). check() now correctly reports location R CMD   check output called custom check_dir. (Thanks @brentonk) check_cran() records check times package tested. Improved default DESCRIPTION file created create_description(). (Thanks @ncarchedi, #428) Fixed bug install_github() prevented installing pull request supplying repo = \"username/repo#pull\". (#388) explicitly specify user agent querying user name ref pull request install_github. (Thanks Kirill Müller, #405) install_github() now removes blank lines found package DESCRIPTION file, protecting users vague error: contains blank line error. (#394) with_options() now works, instead throwing error (Thanks @krlmlr, #434)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-141","dir":"Changelog","previous_headings":"","what":"devtools 1.4.1","title":"devtools 1.4.1","text":"CRAN release: 2013-11-27 Fixed bug wd() path omitted. (#374) Fixed bug dev_help() prevented working using RStudio. source_gist() respects new github policy sending user agent (hadley/devtools) install_github() now takes repo names form [username/]repo[/subdir][@ref|#pull] - now recommended form specify username, subdir, ref /pull install_github. (Thanks Kirill Müller, #376)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-14","dir":"Changelog","previous_headings":"","what":"devtools 1.4","title":"devtools 1.4","text":"CRAN release: 2013-11-20","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"installation-improvements-1-4","dir":"Changelog","previous_headings":"","what":"Installation improvements","title":"devtools 1.4","text":"install() now respects global option keep.source.pkgs. install() gains build_vignettes defaults TRUE, ensures vignettes built even local install. forcing local = FALSE package vignettes, R CMD build can follow usual process. (#344) install_github() now takes repo names form username/repo - now recommended form install_github username hadley ;) install_github() now adds details source installed package (e.g. repository, SHA1, etc.) package DESCRIPTION file. (Thanks JJ Allaire) Adjusted install_version() new meta data structure CRAN. (Thanks Kornelius Rohmeyer) Fixed bug install_version() works version numbers contain hyphens. (Thanks Kornelius Rohmeyer) install_deps() now exported, making easier install dependencies package.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"other-minor-improvements-1-4","dir":"Changelog","previous_headings":"","what":"Other minor improvements","title":"devtools 1.4","text":"build(binary = TRUE) now longer installs package side-effect. (#335) build_github_devtools() new function makes easy Windows users upgrade development version devtools. create_description() better job combining defaults user specified options. (#332) install() also installs dependencies required versions; besides, argument dependencies now works like install.packages() (previous versions, essentially c(\"Depends\", \"Imports\", \"LinkingTo\")) (thanks, Yihui Xie, #355) check() check_cran() gain new check_dir argument control checking takes place (#337) check_devtools() longer incorrectly complains vignettes/ directory Decompression zip files now respects getOption(\"unzip\") (#326) dev_help now use RStudio help pane, ’re using recent version RStudio (#322) Release now little bit smarter: ’s new package, ’ll ask read agree CRAN policies; ask dependencies . source_url() (source_gist()) accept SHA1 prefixes. source_gist() uses GitHub API reliably locate raw gist. Additionally now attempts source files .R .r extensions, gains quiet argument. (#348) Safer installation source packages, previously extracted directly temp directory; problem directory names collide. Instead, source packages now extracted unique subdirectories.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-13","dir":"Changelog","previous_headings":"","what":"devtools 1.3","title":"devtools 1.3","text":"CRAN release: 2013-07-04","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"changes-to-best-practices-1-3","dir":"Changelog","previous_headings":"","what":"Changes to best practices","title":"devtools 1.3","text":"documentation many devtools functions considerably expanded, aiming give novice package developer hints . load_all() now defaults reset = TRUE changes NAMESPACE etc. incorporated. makes slightly slower (hopefully noticeably ), generally accurate, better simulation install + restart + reload cycle. test() now looks inst/test tests/testthat unit tests. recommended use tests/testthat allows users choose whether install test. move tests inst/tests tests/testthat, ’ll also need change tests/test-.R run test_check() instead test_package(). change requires testthat 0.8 available CRAN shortly. New devtools guarantee: devtools bug, CRAN maintainer yells , ’ll send hand-written apology note. Just forward email address.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-3","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 1.3","text":"New install_local() function installing local package files (zip, tar, tgz, etc.) (Suggested landroni) parse_deps(), parses R’s package dependency strings, now exported. package user events (e.g. load, unload, attach detach) now called correct place.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-and-bug-fixes-1-3","dir":"Changelog","previous_headings":"","what":"Minor improvements and bug fixes","title":"devtools 1.3","text":"build() gains args parameter allowing add additional arbitrary arguments, check() gains similar build_args parameter. install_git gains git_arg parameter allowing add arbitrary additional arguments. Files now loaded way preserves srcreferences - means get much better locations error messages, considerably aid debugging. Fixed bug build_vignettes() prevented files inst/doc updated .package() longer uses full path, make nicer error messages. flexibility installing package dependencies dependencies argument install_*() (thanks Martin Studer) deprecated show_rd() function now removed. install_bitbucket() gains auth_user password params can install private repos (thanks Brian Bolt) Better git detection windows (thanks Mikhail Titov) Fix bug document() automatically create man/ directory Default DESCRIPTION gains LazyData: true create_description() now checks directory probably package looking R/, data/ src/ directories Rolled back required R version 3.0 2.15. Add missing import digest() Bump max compatible version R RTools 3.0, add details RTools 3.1","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-12","dir":"Changelog","previous_headings":"","what":"devtools 1.2","title":"devtools 1.2","text":"CRAN release: 2013-04-17","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"better-installation-1-2","dir":"Changelog","previous_headings":"","what":"Better installation","title":"devtools 1.2","text":"install gains local option installing package local package directory, rather built tar.gz. now used default package installations. want guarantee clean build, run local = FALSE install now uses option devtools.install.args default installation arguments. allows set useful defaults (e.g. ---multiarch) Rprofile. install_git gains branch argument specify branch tag (Fixes #255)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"clean-sessions-1-2","dir":"Changelog","previous_headings":"","what":"Clean sessions","title":"devtools 1.2","text":"run_examples test gain fresh argument forces run fresh R session. completely insulates examples/tests current session means interactive code (like browser()) won’t work.(Fixes #258) New functions eval_clean evalq_clean make easy evaluate code clean R session. clean_source loses vanilla argument (work) gains quiet argument","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-1-2","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 1.2","text":"source_url source_gist now allow specify sha, can make sure files source internet don’t change without knowing . (Fixes #259) build_vignettes builds using buildVignette() movies/copies outputs using algorithm R CMD build. means build_vignettes() now exactly mimics R’s regular behaviour, including building non-Sweave vignettes (#277), building correct directory (#231), using make files (present), copying extra files. devtools now sets best practice compiler flags: check(), -Wall -pedantic load_all(), -Wall -pedantic -g -O0 -UNDEBUG. prefixed existing environment variables can override desired. (Fixes #257) ’s DESCRIPTION file present, load_all() automatically create one using create_description(). can set options .Rprofile control contains: see package?devtools details.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-improvements-1-2","dir":"Changelog","previous_headings":"","what":"Minor improvements","title":"devtools 1.2","text":"check() now also sets environment variable _R_CHECK_CODE_DATA_INTO_GLOBALENV_ TRUE (match current ---cran behaviour) (Fixes #256) Improved default email sent release(), eliminating create.post() boilerplate revdep includes LinkingTo default. Fixed regular expression problem caused RTools 3.0.* fail found Windows. load_data() got overhaul now respects LazyData correctly exports datasets default (Fixes #242) with_envvar gains option either replace, prefix suffix existing environmental variables. default replace, previous behaviour. check_cran includes sessionInfo() summary output (Fixes #273) create() gains check argument defaults FALSE. with_env deprecated 1.2 removed 1.3 load_all() calls .onAttach() .onLoad(), now passes lib path functions.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-11","dir":"Changelog","previous_headings":"","what":"devtools 1.1","title":"devtools 1.1","text":"CRAN release: 2013-02-09 source_gist() updated accept new gist URLs username. (Fixes #247) test() document() now set environment variables, including NOT_CRAN. Test packages renamed avoid conflicts existing packages CRAN. bug prevented devtools 1.0 passing check CRAN platforms. Catch additional case find_rtools(): previously installed, directory empty/deleted (Fixes #241)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-10","dir":"Changelog","previous_headings":"","what":"devtools 1.0","title":"devtools 1.0","text":"CRAN release: 2013-01-22","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"improvements-to-package-loading-1-0","dir":"Changelog","previous_headings":"","what":"Improvements to package loading","title":"devtools 1.0","text":"Rcpp attributes now automatically compiled build. Packages listed depends require()d (Fixes #161, #178, #192) load_all inserts special version system.file package’s imports environment. tries simulate behavior base::system.file gives modified results directory structure installed packages uninstalled source packages different. (Fixes #179). words, system.file now just work even package loaded devtools. Source files recompiled ’ve changed since last run, recompile clean (--preclean) exported header files changed. (Closes #224) compilation process now performs mock install instead using R CMD SHLIB. means Makevars makefiles now respected generally fewer mismatches load_all regular install reload process. S4 classes correctly loaded unloaded.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"windows-1-0","dir":"Changelog","previous_headings":"","what":"Windows","title":"devtools 1.0","text":"Rtools detection windows substantially overhauled reliable, fails give information wrong install. don’t rtools installed, devtools now automatically sets TAR environment variable internal can still build packages.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"minor-features-1-0","dir":"Changelog","previous_headings":"","what":"Minor features","title":"devtools 1.0","text":"check_cran now downloads packages cran.rstudio.com. check() now makes CRAN version check optional, default. release() function still checks version number CRAN. check(), optional require suggested packages, using force_suggests option. check() called, new default behavior delete existing .Rd files man/. behavior can set “devtools.cleandoc” option. install_bitbucket() now always uses lowercase repo names. (Thanks mnel) New function with_lib(), runs expression code library path prepended existing libpaths. differs slightly with_libpaths(), replaces existing libpaths. New function install_git() installs package directly git repository. (Thanks David Coallier) pdflatex isn’t available, don’t try build vignettes install() check(). (Fixes #173) install_github() now downloads new URL, reflect changes files hosted GitHub. build() now vignettes option turn rebuilding vignettes. install(quick=TRUE) now builds package without rebuilding vignettes. (Fixes #167) R commands called devtools now environment variable NOT_CRAN set, can perform tasks know code definitely running CRAN. (Closes #227) devtools functions can quiet argument suppresses output. particularly useful testing.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-1-0","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 1.0","text":"Fixed path issue looking Rtools windows registry entry present. (Fixes #201) Reloading package requires forced-unload namespace now works. reloading package another loaded package depends , error loading code, devtools print something error unloadNamespace, confusing. now gives useful errors. intermittent error clear_topic_index related using rm() fixed. (Thanks Gregory Jefferis) revdep() now lists “Suggests” packages, addition “Depends” “Imports”. revdep_check() now correctly passes recursive argument revdep(). collection check results end check_cran() previously remove existing results, now . package loaded load_all(), now passes name package .onLoad() function. (Thanks Andrew Redd)","code":""},{"path":[]},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-0-8-0","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 0.8.0","text":"create function makes easier create package skeleton using devtools standards. install_github() can now install pull request – installs branch referenced pull request. install_github now accepts auth_user password arguments want install package private github repo. need specify auth_user ’s package (.e. ’s username) (Fixes #116) new dev_help function replaces show_rd makes easy get help topic development package (.e. package loaded load_all) (Fixes #110) dev_example runs examples one -development package. (Fixes #108) build_vignettes now looks modern location vignettes (vignettes/) warn vignettes found old location (inst/doc). Building now occurs temporary directory (avoid polluting package build artefacts) final pdf files copied . new clean_vignettes function remove pdfs inst/doc built vignettes vignettes/ load_all much better job simulating package loading (see LOADING section). also compiles loads C/C++/Fortran code. unload() now exported function, unloads package, trying harder just detach. now also unloads DLLs. (Winston Chang. Fixes #119) run_examples now parameters show, test, run control \\dontrun{}, \\dontshow{}, \\donttest{} \\testonly{} commented . strict parameter removed since longer necessary load_all can respect namespaces. (Fixes #118) build(), check(), install() etc now run R --vanilla mode prevents reading site personal configuration files. prevent inconsistencies environment package run computer computers (e.g. CRAN server) (Fixes #145) system R command now print full command used make easier understand ’s going .","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"package-paths-0-8-0","dir":"Changelog","previous_headings":"","what":"Package paths","title":"devtools 0.8.0","text":".package longer uses ~/.Rpackages. .package provides informative error messages path exist, isn’t directory, doesn’t contain DESCRIPTION file. New function inst() takes name package returns installed path package. (Winston Chang. Fixes #130). makes possible use devtools functions (e.g. unload) regular installed packages, just -development source packages. New function devtest() returns paths internal testing packages devtools.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"loading-0-8-0","dir":"Changelog","previous_headings":"","what":"Loading","title":"devtools 0.8.0","text":"Development packages now loaded namespace environment, , objects namespace copied package environment, . accurately simulates packages normally loaded. However, objects (just exported ones) still copied package environment. (Winston Chang. Fixes #3, #60, #125) Packages listed Imports Depends now loaded imports environment, name attribute “imports:xxxx”, parent namespace environment. imports environment turn child NAMESPACE file now used loading imports, instead DESCRIPTION file. Previously, load_all loaded objects packages listed DESCRIPTION. Now loads packages (, ‘importFrom’ used, specific objects packages) listed NAMESPACE. closely simulates normal package loading. still checks version numbers packages listed DESCRIPTION. (Winston Chang) load_all can now used properly reload devtools. creating copy devtools namespace environment, calling load_all environment. (Winston Chang) .onLoad .onAttach functions development package now called loading package first time, reset=TRUE, order correctly simulates normal package loading (create namespace, call .onLoad, copy objects package environment, call .onAttach). (Winston Chang) load_all now throw warning dependency package satisfy version requirement listed DESCRIPTION. (Winston Chang. Fixes #109) package environment now ‘path’ attribute, similar package loaded normal way. (Winston Chang) load_all now option export_all. set TRUE, objects listed exports NAMESPACE exported. (Winston Chang) load_all now compiles C files /src directory. (Winston Chang) New functions compile_dll() clean_dll(), compile C/C++/ Fortran source code, clean compiled objects, respectively. (Winston Chang. Fixes #131)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-0-8-0","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 0.8.0","text":"load_code now properly skips missing files. (Winston Chang) Add ---resave-data default build command. subject line email created release now “CRAN submission [package] [version]”, per CRAN repository policy. install_bitbucket properly installs zip files projects stored Mercurial repositories. (Winston Chang. Fixes #148) build now builds vignettes install . (Fixes #155)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"introspection-0-8-0","dir":"Changelog","previous_headings":"","what":"Introspection","title":"devtools 0.8.0","text":"New function loaded_packages(), returns names packages loaded attached. Packages loaded load_all now store devtools metadata namespace environment, variable called .__DEVTOOLS__. can accessed dev_meta function. (Winston Chang. Fixes #128) dev_mode now stores path uses option dev_path. makes easy applications detect act accordingly. New function parse_ns_file(), parses NAMESPACE file package. New function parenvs(), parents parent environments object. (Winston Chang)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-071","dir":"Changelog","previous_headings":"","what":"devtools 0.7.1","title":"devtools 0.7.1","text":"CRAN release: 2012-07-02 bump dependency R 2.15 load_code now also looks files ending .q - recommended, needed older packages","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-07","dir":"Changelog","previous_headings":"","what":"devtools 0.7","title":"devtools 0.7","text":"CRAN release: 2012-06-19","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"installation-0-7","dir":"Changelog","previous_headings":"","what":"Installation","title":"devtools 0.7","text":"install_bitbucket installs R packages bitbucket. install now uses ---keep.source make debugging little easier. remote install functions give better error messages case http errors (Fixes #82). install new quick option make package installation faster, sacrificing documentation, demos multi-architecture binaries. (Fixes #77) install_url, install_github install_gitorious gain subdir argument makes possible install packages contained within sub-directory repository compressed file. (Fixes #64)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"checking-0-7","dir":"Changelog","previous_headings":"","what":"Checking","title":"devtools 0.7","text":"with_debug function temporarily sets env vars compilation performed appropriate debugging flags set. Contributed Andrew Redd. revdep, revdep_maintainers revdep_check calculating reverse dependencies, finding maintainers running R CMD check. (Fixes #78) check_cran received massive overhaul: now checks multiple packages, installs dependencies (user specified library), parse check output extract errors warnings check uses new ---cran option make checking close CRAN possible (fixes #68)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"other-new-features-0-7","dir":"Changelog","previous_headings":"","what":"Other new features","title":"devtools 0.7","text":"devtools now uses options devtools.path set default path use devmode, github.user set default user installing packages github. package supplied, package worked previously, functions now try working directory. (Fixes #87) windows, devtools now looks registry find Rtools installed, better job locating gcc. (Contributed Andrew Redd) show_rd passes ... Rd2txt - useful ’re checking build time \\Sexprs generated. suite functions allow temporarily alter environment code run: in_dir, with_collate, with_locale, with_options, with_path, … (Fixes #89) release ask questions randomises correct answers really need read (Fixes #79) source_gist now accepts default url “https://gist.github.com/nnn” New system path manipulation functions, get_path, set_path, add_path on_path, contributed Andrew Redd. ’re windows, devtools now suppresses unimportant warning CYGWIN dos style file paths","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-0-7","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 0.7","text":"decompress now uses target directory defined function call expanding compressed file. (Fixes #84) document always run C locale NAMESPACE sort order consistent across platforms. install now quotes libpath build path paths embedded spaces work (Fixes #73 #76) load_data now also loads .RData files (Fixes #81) install now args argument pass additional command line arguments R CMD install (replaces ... didn’t actually anything). (Fixes #69) load_code better job reconciling files DESCRIPTION collate files actually exist R directory. (Fixes #14)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-06","dir":"Changelog","previous_headings":"","what":"devtools 0.6","title":"devtools 0.6","text":"CRAN release: 2012-02-28","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-features-0-6","dir":"Changelog","previous_headings":"","what":"New features","title":"devtools 0.6","text":"test function takes filter argument allows restrict tests run check runs example timings, done CRAN. Run new param cleanup = F access timings. missing_s3 function help figure ’ve forgotten export s3 methods check_cran downloads checks CRAN package - useful run part testing process package want check dependencies package strict mode run_examples runs example clean environment. much slower default (running current environment), ensures example works standalone. dev_mode now updates prompt indicate ’s active (Thanks Kohske Takahashi) new source_url function sourcing script remote server via protocols http (e.g. https ftp). (Thanks Kohske Takahashi) new source_gist function source R code stored github gist. (Thanks Kohske Takahashi) load_all now also loads package dependencies (including suggestions) - works around bugs way devtools attaches development environment search path way fails recreate happens normally package loading.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"installation-0-6","dir":"Changelog","previous_headings":"","what":"Installation","title":"devtools 0.6","text":"remote installation ensure configure file executable. external package installation functions vectorised can install multiple packages time new install_gitorious function install packages gitorious repos. new install_url function installing package arbitrary url include install_version function Jeremy Stephens installing specific version CRAN package archive.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"better-windows-behaviour-0-6","dir":"Changelog","previous_headings":"","what":"Better windows behaviour","title":"devtools 0.6","text":"better check OS type (thanks Brian Ripley) better default paths 64-bit R windows (Fixes #35) check see Rtools already available trying mess paths. (Fixes #55)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"bug-fixes-0-6","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"devtools 0.6","text":"error occurs calling loading R files, cache automatically cleared files loaded next time try (Fixes #55) functions run R now R_LIBS set current .libPaths() - ensure checking uses development library development mode. R_ENVIRON_USER set empty file avoid existing settings overriding . load_data (called load_all) also load data defined R files data directory. (Fixes #45) dev_mode performs basic tests make sure ’re setting development library directory ’s already R library. (Fixes #25)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-051","dir":"Changelog","previous_headings":"","what":"devtools 0.5.1","title":"devtools 0.5.1","text":"CRAN release: 2011-12-07 Fix error causing R commands fail windows.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-05","dir":"Changelog","previous_headings":"","what":"devtools 0.5","title":"devtools 0.5","text":"CRAN release: 2011-12-04","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-functions-0-5","dir":"Changelog","previous_headings":"","what":"New functions","title":"devtools 0.5","text":"new show_rd function show development version help file.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"improvements-and-bug-fixes-0-5","dir":"Changelog","previous_headings":"","what":"Improvements and bug fixes","title":"devtools 0.5","text":"external R commands always run locale C, ’s CRAN severs . clean_source sources R script fresh R environment, ensuring can run independently current working environment. Optionally (vanilla = T), source vanilla R environment ignores local environment settings. windows, devtools also add path mingw startup. (Thanks pointer Dave Lovell)","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-04","dir":"Changelog","previous_headings":"","what":"devtools 0.4","title":"devtools 0.4","text":"CRAN release: 2011-07-23","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"new-functions-0-4","dir":"Changelog","previous_headings":"","what":"New functions","title":"devtools 0.4","text":"new wd function change working directory package subdirectory. check_doc now checks package documentation whole, way R CMD check , rather low-level syntax checking, done roxygen2. DESCRIPTION checking moved intoload_all.check_rd` removed. build now exported, defaults building package’s parent directory. also gains new binary parameter controls whether binary source version (vignettes manuals) built. Confusingly, binary packages built R CMD INSTALL. build_win sends package R windows builder, allowing make binary version package windows users ’re using linux macOS (’re using windows already, use build(binary = T))","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"improvements-and-bug-fixes-0-4","dir":"Changelog","previous_headings":"","what":"Improvements and bug fixes","title":"devtools 0.4","text":"using .Rpackages config file, default function used last, first. Windows, devtools now checks presence Rtools startup, automatically add path needed. document uses roxygen2 instead roxygen. now loads package dependency ’re available roxygen executes package source code. document new parameter clean clears roxygen caches removes existing man files. check now runs document mode. dev_mode create directories recursively, complain can’t create . also work better windows. install_github now allows specify branch download, automatically reloads package needed. reload now reload package already loaded. release gains check parameter allows skip package check (’ve just done .) test automatically reloads code never run tests old code","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-03","dir":"Changelog","previous_headings":"","what":"devtools 0.3","title":"devtools 0.3","text":"CRAN release: 2011-06-30 new bash() function starts bash shell package directory. Useful want use git etc. removed inelegant update_src() since now superseded bash() fix bug ftp upload adding extraneous space build function builds package specified directory. install, check release now use function. build, install, check release better cleaning - always try work session temporary directory delete files/directories create","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-02","dir":"Changelog","previous_headings":"","what":"devtools 0.2","title":"devtools 0.2","text":"CRAN release: 2011-06-29 install_github now uses RCurl instead external wget retrieve package. make robust wrt external dependencies. load_all skip missing files warning (thanks suggestion Jeff Laake) check automatically deletes .Rcheck directory successful completion Quote path R works even spaces path.","code":""},{"path":"https://devtools.r-lib.org/dev/news/index.html","id":"devtools-01","dir":"Changelog","previous_headings":"","what":"devtools 0.1","title":"devtools 0.1","text":"CRAN release: 2011-06-22 Check presence DESCRIPTION loading packages avoid false positives install now works correctly devel_mode install packages development library release prints news can easily check R CMD xxx functions now use current R, first R found system path.","code":""}]