- Site built with pkgdown 2.1.0.
+ Site built with pkgdown 2.1.1.
diff --git a/docs/search.json b/docs/search.json
index 33bf9df1..9c2b098f 100644
--- a/docs/search.json
+++ b/docs/search.json
@@ -1 +1 @@
-[{"path":"https://jabenninghoff.github.io/rdev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2024 John Benninghoff 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":[]},{"path":"https://jabenninghoff.github.io/rdev/TODO.html","id":"content","dir":"","previous_headings":"","what":"Content","title":"TODO","text":"Add README.Rmd Update DESCRIPTION use description data README.Rmd Add ORCID Update ORCID details","code":""},{"path":"https://jabenninghoff.github.io/rdev/TODO.html","id":"package","dir":"","previous_headings":"","what":"Package","title":"TODO","text":"Write utility function sort .Rbuildignore Implement pkgdown Add links / update Rd formatting function documentation. Add dummy imports silence R CMD check note per tidyverse Migrate build_analysis_site() rdev Switch development version styler (1.3.2.9000) new release becomes available Validate lint_all works expected within ci Add ‘create package’ workflow example README, remove TODO section “Analysis package creation process” Move _pkgdown.yml repository root make projects discoverable pgkdown GitHub query Update README.Rmd template dynamically generate list notebooks analysis Automate release process Automate creation feature branches, including ‘Bump version’ using desc::desc_bump_version(\"dev\") Add check stage_release() look missing topics _pkgdown.yml reference section Update use_rdev_package() Handle .Rmd files already html_document section Move rmd_metadata() README-analysis.Rmd rdev package Add tests per comments R/ reading package book, documentation Update Roxygen comments reading package book, documentation, review merge duplicate Roxygen docs Write manual regression test script (notes R commands) vignette validate ‘Creating Packages’ ‘GitHub Releases’ Add messages, warnings build_analysis_site() report progress Add function spell check notebooks Automate branch protection Address issue https://github.com/r-lib/usethis/issues/1568, closed Add dplyr running use_analysis_package() Consider switching getOption(\"pkgType\") source per R options per R macOS FAQ, “CRAN build guaranteed compatible package binaries CRAN (Bioconductor).” Support creating repos organizations Consider incorporating GitHub description DESCRIPTION Create wrapper spelling includes notebooks package spell checking, WORDLIST Add spell_check_test_notebooks() function CI spellchecks notebooks Convert manual tests (Setup.Rmd) R Script can run within package created create_github_repo() Add function add missing (notebook) dependencies DESCRIPTION, see renv::dependencies() desc::desc_get_deps() Add check_renv() ci() stop renv::status() date Replace proof-docs urlchecker, support checking GitHub Pages docs directory using url_db_from_HTML_files (ask PR accepted) Move scripts tools inst/bin similar, per Stack Overflow R Packages Switch development versions styler (1.3.2.9000) lintr (2.0.1.9000) new release becomes available - needed address bugs current release versions, 1.3.2 2.0.1. Add trailing slash GitHub Pages URL Update lint_all() lint types, including .Rpres Add custom CSS files _site.yml analysis notebook templates control font size, described article, possibly using bs_theme(), since pkgdown customizes default using build_bslib() (issue exists unsupported Safari 14 Safari 15) Remove pkgdown/extra.css https://github.com/r-lib/pkgdown/issues/2377 accepted Establish default knitr options, including knitr::opts_chunk$set(fig.align = \"center\"), add analysis template, also review settings Advanced R Use Project Templates like vertical? Add CSS R Markdown Template instead assets/extra.css? Move shift-heading-level-: 1 _quarto.yml analysis/_metadata.yml, TODO.md renders properly Remove preset: bootstrap workaround pkgdown 2.0.8+ released (per https://github.com/r-lib/pkgdown/issues/2376) Replace dev = TRUE logic https://github.com/rstudio/renv/issues/1695 accepted Update errors messages reading Advanced R Conditions re-reading Tidyverse Style Guide Reduce number Imports, per R CMD check:","code":"> devtools::check() ... > checking package dependencies ... NOTE Imports includes 30 non-default packages. Importing from so many packages makes the package vulnerable to any of them becoming unavailable. Move as many as possible to Suggests and use conditionally."},{"path":"https://jabenninghoff.github.io/rdev/TODO.html","id":"github","dir":"","previous_headings":"","what":"GitHub","title":"TODO","text":"Use standard R CMD check Use lintr Faster CI checks Switch full R CMD check ? Update GitHub Actions r-lib examples Run test coverage Skip CI checks changes docs/ directory Add GitHub Action html/link checking using something like htmlproofer Autobuild docs/ like pkgdown ?","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"overview","dir":"Articles","previous_headings":"","what":"Overview","title":"Introduction to rdev","text":"rdev supports personal workflow, including creation traditional R packages R Analysis Packages (vignette(\"analysis-package-layout\")), enforcing consistency across packages, providing Continuous Integration/Continuous Delivery (CI/CD) automation. use tools rdev improve code quality, speed development R code, publish results analyses R Quarto Notebooks HTML make accessible non-R users.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"installation","dir":"Articles","previous_headings":"","what":"Installation","title":"Introduction to rdev","text":"current R development environment uses Homebrew, rig, RStudio, GitHub, collection R packages including rdev, Visual Studio Code, Vim.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"homebrew","dir":"Articles","previous_headings":"Installation","what":"Homebrew","title":"Introduction to rdev","text":"use Homebrew Bundle install software systems; basic macOS working environment published GitHub macos-env.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"installing-r","dir":"Articles","previous_headings":"Installation","what":"Installing R","title":"Introduction to rdev","text":"rig supports installation multiple versions official R binaries, use reproducibility. install R using rig, first install rig: install desired versions R. following installs R 3.6 4.4 ARM based macs (2024-09-03): Note : don’t use pak, rig installs default, yet fully supported renv. oldest version R install 3.6, since RStudio now requires R 3.6 newer (version 2024.04.00) Since ARM binary release R 3.6 (oldrel/5) R 4.0 (oldrel/4), install Intel binaries run Rosetta 2.","code":"brew tap r-lib/rig brew install --cask rig rig install oldrel/5 --without-pak --arch x86_64 rig install oldrel/4 --without-pak --arch x86_64 rig install oldrel/3 --without-pak rig install oldrel/2 --without-pak rig install oldrel/1 --without-pak rig install oldrel --without-pak rig install release --without-pak rig default release"},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"development-tools","dir":"Articles","previous_headings":"Installation","what":"Development Tools","title":"Introduction to rdev","text":"Well, obviously, use RStudio. RStudio leading IDE R development integrates many R packages, although sometimes falls short; use GitHub command line Git, occasionally Visual Studio Code (better support markdown) Vim (faster types edits). Posit developing next-generation IDE based Visual Studio Code, Positron. ’ve tried using Positron, ’ve found ’s still new replace RStudio development. RStudio, GitHub desktop client, Visual Studio Code easily installed using Homebrew: recommended change default settings .RData RStudio (Options > General > Basic > Workspace): Uncheck “Restore .Data workspace startup” Set “Save workspace .Data exit” “Never” Vim installed default macOS Unix-like systems.","code":"brew install --cask rstudio brew install --cask github brew install --cask visual-studio-code"},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"packages","dir":"Articles","previous_headings":"Installation","what":"Packages","title":"Introduction to rdev","text":"Managing packages environments challenge modern languages. Thankfully R doesn’t level challenge python, even ruby, managing packages available within project best practice. use renv purpose, use renv install manage packages projects. setup-r script rdev installs base set packages needed run rdev R User Library. streamlined version script included . chown command needed allow updating base packages using RStudio Packages “Update” function. generally update packages RStudio projects open starting development, update packages projects using renv::update(). ’re installing (development) versions packages GitHub, recommended set personal access token using usethis::create_github_token() adding .Renviron GITHUB_PAT= using usethis::edit_r_environ().","code":"# fix rig permissions sudo chown -R \"$(whoami)\":admin /Library/Frameworks/R.framework/Versions/*/Resources/library RVERSION=\"$(Rscript -e 'cat(as.character(getRversion()[1,1:2]))')\" USERLIB=\"$HOME/Library/R/$(uname -m)/${RVERSION}/library\" DEVPKG='c(\"renv\", \"styler\", \"lintr\", \"miniUI\", \"languageserver\", \"rmarkdown\", \"devtools\", \"available\")' GITPKG='c(\"jabenninghoff/rdev\")' if [ ! -d \"${USERLIB}\" ] then mkdir -p \"${USERLIB}\" fi echo \"install.packages(${DEVPKG}, repos=\\\"https://cloud.r-project.org\\\", lib=\\\"${USERLIB}\\\")\" | R --no-save echo \"remotes::install_github(${GITPKG}, lib=\\\"${USERLIB}\\\")\" | R --no-save"},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"further-reading","dir":"Articles","previous_headings":"Installation","what":"Further Reading","title":"Introduction to rdev","text":"workflow heavily influenced DevOps movement research DevOps Research Assessment (DORA) team Google started Dr. Nicole Forsgren. research shows technical non-technical capabilities improve outcomes. functions included rdev support many technical capabilities, including: Code maintainability Continuous delivery Continuous integration Deployment automation Shifting left security Test automation Trunk-based development Version control outline SIRAcon 2022 talk, “Making R Work (Automation)” available GitHub siracon2022.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"rdev-conventions","dir":"Articles","previous_headings":"","what":"rdev conventions","title":"Style Guide","text":"rdev uses mix Google tidyverse conventions.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"naming-conventions","dir":"Articles","previous_headings":"rdev conventions","what":"Naming conventions","title":"Style Guide","text":"rdev follows tidyverse naming convention snake_case.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"right-hand-assignment","dir":"Articles","previous_headings":"rdev conventions","what":"Right-hand assignment","title":"Style Guide","text":"rdev follows Google’s style guide, use right-hand assignment.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"returns","dir":"Articles","previous_headings":"rdev conventions","what":"Returns","title":"Style Guide","text":"rdev typically uses implicit returns unless needed flow control construct specific return structure.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"qualifying-namespaces","dir":"Articles","previous_headings":"rdev conventions","what":"Qualifying namespaces","title":"Style Guide","text":"Use @import @importFrom discouraged, instead using :: functions defined R/. exception infix functions (%name%), always imported, using roxygen @importFrom. Within R Quarto Notebooks, use library() encouraged readability.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"package-level-documentation","dir":"Articles","previous_headings":"rdev conventions","what":"Package-level documentation","title":"Style Guide","text":"rdev package documentation lives R/package.R. Additionally, use base R encouraged within functions defined R/ (control dependencies), tidyverse R encouraged within notebooks readability. R Markdown documents generally wrap width code, exceptions R Notebook ‘description line’ (first non-blank line body), long hyperlinks.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"styler","dir":"Articles","previous_headings":"","what":"styler","title":"Style Guide","text":"rdev package implements styler using styler defaults, permanent caching enabled (options(styler.cache_root = \"styler-perm\")). style_all() function applies tidyverse style R Quarto files (R, Rprofile, Rmd, Rnw, qmd) package directory structure.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"lintr","dir":"Articles","previous_headings":"","what":"lintr","title":"Style Guide","text":"lint_all() function lints R Quarto files (R, Rmd, qmd, Rnw, Rhtml, Rpres, Rrst, Rtex, Rtxt) lintr using opinionated configuration (.lintr): settings deliberately chosen meet specific goals:","code":"linters: linters_with_tags( tags = NULL, extraction_operator_linter = NULL, implicit_integer_linter = NULL, line_length_linter(100), missing_package_linter = NULL, namespace_linter = NULL, nonportable_path_linter = NULL, paste_linter(allow_file_path = \"always\"), todo_comment_linter = NULL, undesirable_function_linter( within(all_undesirable_functions, rm(ifelse, library, require, structure)) ), undesirable_operator_linter(all_undesirable_operators), unnecessary_concatenation_linter(allow_single_expression = FALSE), unused_import_linter( except_packages = c(\"bit64\", \"data.table\", \"tidyverse\", pkgload::pkg_name(\".\")) ) )"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"use-all-linters","dir":"Articles","previous_headings":"lintr","what":"Use all linters","title":"Style Guide","text":"selects linters, including new Google linters. selecting linters, just defaults, forces evaluation new linters added lintr. Specific linters disabled configured per rdev style.","code":"linters: linters_with_tags( tags = NULL,"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"allow-extraction-operator","dir":"Articles","previous_headings":"lintr","what":"Allow $ extraction operator","title":"Style Guide","text":"extraction operator linter enforces use [[ $. Since $ intended interactive use supports partial mapping, safer use [[. However, use $ common practice, including within lintr code, leads readable code.","code":"extraction_operator_linter = NULL,"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"allow-implicit-integers","dir":"Articles","previous_headings":"lintr","what":"Allow implicit integers","title":"Style Guide","text":"implicit integer linter checks integers explicitly typed using form 1L. , safer, implicit integers common practice, including output dput():","code":"implicit_integer_linter = NULL, dput(character(0L)) #> character(0)"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"set-line-length","dir":"Articles","previous_headings":"lintr","what":"Set line length","title":"Style Guide","text":"line length 100 reasonable width working RStudio IDE laptop.","code":"line_length_linter(100),"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"use-renv-for-missing-packages","dir":"Articles","previous_headings":"lintr","what":"Use renv for missing packages","title":"Style Guide","text":"missing package linter namespace linter check packages referenced code installed. rdev uses renv manage packages, better job detecting missing packages, including complaining current package (\".\") installed.","code":"missing_package_linter = NULL, namespace_linter = NULL,"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"allow-non-portable-paths","dir":"Articles","previous_headings":"lintr","what":"Allow non-portable paths","title":"Style Guide","text":"non-portable path linter generates many false positives, including calls fs, essentially makes UNIX-style paths portable across operating systems. Similarly, allow_file_path default option \"double_slash\" generates false positives used fs.","code":"nonportable_path_linter = NULL, paste_linter(allow_file_path = \"always\"),"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"allow-todo-comments","dir":"Articles","previous_headings":"lintr","what":"Allow TODO comments","title":"Style Guide","text":"rdev conventions encourage use # TODO: comments convenient way identifying needed planned updates inline.","code":"todo_comment_linter = NULL,"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"disallow-almost-all-undesirable-functions-and-operators","dir":"Articles","previous_headings":"lintr","what":"Disallow almost all undesirable functions and operators","title":"Style Guide","text":"Enable undesirable functions operators, just defaults, except ifelse() succinct /else block, library(), require(), structure(). Use require() within .Rprofile library() within R Markdown documents appropriate common practice, although neither used within package code. structure() useful comparing test results values generated dput().","code":"undesirable_function_linter( within(all_undesirable_functions, rm(ifelse, library, require, structure)) ), undesirable_operator_linter(all_undesirable_operators),"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"enforce-strict-unnecessary-concatenation","dir":"Articles","previous_headings":"lintr","what":"Enforce strict unnecessary concatenation","title":"Style Guide","text":"Enforce stricter version unnecessary concatenation linter.","code":"unnecessary_concatenation_linter(allow_single_expression = FALSE),"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"verify-imported-packages-are-used","dir":"Articles","previous_headings":"lintr","what":"Verify imported packages are used","title":"Style Guide","text":"Verify imported packages used, except packages attached side effects, current package (support package development).","code":"unused_import_linter( except_packages = c(\"bit64\", \"data.table\", \"tidyverse\", pkgload::pkg_name(\".\")) ) )"},{"path":"https://jabenninghoff.github.io/rdev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"John Benninghoff. Author, maintainer.","code":""},{"path":"https://jabenninghoff.github.io/rdev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Benninghoff J (2024). rdev: R Development Tools. R package version 1.11.4, https://github.com/jabenninghoff/rdev, https://jabenninghoff.github.io/rdev/.","code":"@Manual{, title = {rdev: R Development Tools}, author = {John Benninghoff}, year = {2024}, note = {R package version 1.11.4, https://github.com/jabenninghoff/rdev}, url = {https://jabenninghoff.github.io/rdev/}, }"},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"overview","dir":"","previous_headings":"","what":"Overview","title":"R Development Tools","text":"R Development Tools: opinionated collection development tools, packages, utilities. Feel free use /fork project!","code":""},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"R Development Tools","text":"can install development version rdev GitHub : using renv:","code":"# install.packages(\"remotes\") remotes::install_github(\"jabenninghoff/rdev\") # install.packages(\"renv\") renv::install(\"jabenninghoff/rdev\")"},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"development","dir":"","previous_headings":"","what":"Development","title":"R Development Tools","text":"Changelog: See “Changelog” NEWS.md. Planned: TODO","code":""},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"creating-packages","dir":"","previous_headings":"","what":"Creating Packages","title":"R Development Tools","text":"rdev supports creation new R packages following rdev conventions well new R Analysis packages. typical setup workflow (per ?quickstart) : Use available::available() check package name project open, run create_github_repo() initialize GitHub R repository Without committing git, run init() newly created project Manually update Title Description fields DESCRIPTION file without committing Run setup_analysis() setup_rdev() configure package analysis package rdev package respectively. Update TODO.md, NEWS.md, README.Rmd, DESCRIPTION needed Re-run check_renv(), ci() validate package Commit git begin development","code":""},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"github-releases","dir":"","previous_headings":"","what":"GitHub Releases","title":"R Development Tools","text":"rdev automates workflow creating GitHub releases along updating GitHub pages either standard R packages R analysis packages, using release notes format NEWS.md. typical development workflow : Bump version create new feature branch new_branch() Write things Update release notes new version NEWS.md, following conventions described get_release() Finalize release merge changes git Run stage_release() create new pull request GitHub using details derived NEWS.md, including updating README GitHub pages pull request reviewed passes required status checks, accept staged release merge_release(), merges pull request, cleans branches, publishes new GitHub release Feature branches can merged without starting new release; stage_release() just requires everything committed, including new release notes NEWS.md running. ready release, stage_release() use existing branch feature branch, create new release branch default.","code":""},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"workflow","dir":"","previous_headings":"","what":"Workflow","title":"R Development Tools","text":"workflow, typically check renv start: also ci() function run continuous integration tests locally:","code":"library(rdev) check_renv() #> renv::status(dev = TRUE) #> No issues found -- the project is in a consistent state. #> #> renv::clean() #> - No stale package locks were found. #> - No temporary directories were found in the project library. #> - The project has been cleaned. ci() #> renv::status(dev = TRUE) #> No issues found -- the project is in a consistent state. #> #> missing_deps() #> Finding R package dependencies ... Done! #> renv::dependencies() not in DESCRIPTION: #> #> pkgdown::check_pkgdown() #> ✔ No problems found. #> #> style_all() #> Styling 67 files: #> .Rprofile ✔ #> README.Rmd ✔ #> inst/rmarkdown/templates/analysis/skeleton/skeleton.Rmd ✔ #> inst/templates/analysis.qmd ✔ #> inst/templates/changelog.qmd ✔ #> inst/templates/index.qmd ✔ #> inst/templates/package.R ✔ #> inst/templates/README-analysis.Rmd ✔ #> inst/templates/README-rdev.Rmd ✔ #> inst/templates/spelling.R ✔ #> inst/templates/test-spelling.R ✔ #> R/build.R ✔ #> R/ci.R ✔ #> R/helpers.R ✔ #> R/init.R ✔ #> R/package.R ✔ #> R/release.R ✔ #> R/setup.R ✔ #> R/to_document.R ✔ #> R/urlchecker.R ✔ #> R/utils.R ✔ #> tests/spelling.R ✔ #> tests/testthat.R ✔ #> tests/manual/setup.Rmd ✔ #> tests/manual/test-new-repo-1.R ✔ #> tests/manual/test-new-repo-2.R ✔ #> tests/manual/test-new-repo-3-analysis.R ✔ #> tests/manual/test-new-repo-3-package.R ✔ #> tests/testthat/test-build.R ✔ #> tests/testthat/test-ci.R ✔ #> tests/testthat/test-helpers.R ✔ #> tests/testthat/test-init.R ✔ #> tests/testthat/test-inst.R ✔ #> tests/testthat/test-release.R ✔ #> tests/testthat/test-setup.R ✔ #> tests/testthat/test-spelling.R ✔ #> tests/testthat/test-to_document.R ✔ #> tests/testthat/test-utils.R ✔ #> tests/testthat/test-ci/test-revealjs.qmd ✔ #> tests/testthat/test-ci/test.Rprofile ✔ #> tests/testthat/test-ci/testcode_1.R ✔ #> tests/testthat/test-ci/testcode_2.R ✔ #> tests/testthat/test-ci/testcode.qmd ✔ #> tests/testthat/test-ci/testcode.Rmd ✔ #> tests/testthat/test-ci/testcode.Rnw ✔ #> tests/testthat/test-ci/packrat/test.R ✔ #> tests/testthat/test-ci/R/RcppExports.R ✔ #> tests/testthat/test-ci/renv/test.R ✔ #> tests/testthat/test-to_document/document.Rmd ✔ #> tests/testthat/test-to_document/docx.qmd ✔ #> tests/testthat/test-to_document/extra-spaces.Rmd ✔ #> tests/testthat/test-to_document/minimal-document.Rmd ✔ #> tests/testthat/test-to_document/minimal-docx.qmd ✔ #> tests/testthat/test-to_document/minimal.qmd ✔ #> tests/testthat/test-to_document/minimal.Rmd ✔ #> tests/testthat/test-to_document/multiple.Rmd ✔ #> tests/testthat/test-to_document/no-format.qmd ✔ #> tests/testthat/test-to_document/no-front-matter.Rmd ✔ #> tests/testthat/test-to_document/no-output.Rmd ✔ #> tests/testthat/test-to_document/no-yaml.qmd ✔ #> tests/testthat/test-to_document/no-yaml.Rmd ✔ #> tests/testthat/test-to_document/valid.qmd ✔ #> tests/testthat/test-to_document/valid.Rmd ✔ #> tests/testthat/test-to_document/with-code.Rmd ✔ #> vignettes/analysis-package-layout.Rmd ✔ #> vignettes/rdev.Rmd ✔ #> vignettes/style-guide.Rmd ✔ #> ─────────────────────────────────────────────────────── #> Status Count Legend #> ✔ 67 File unchanged. #> ℹ 0 File changed. #> ✖ 0 Styling threw an error. #> ─────────────────────────────────────────────────────── #> #> lint_all() #> #> devtools::document() #> ℹ Updating rdev documentation #> ℹ Loading rdev #> #> desc::desc_normalize() #> #> extra_deps() #> Finding R package dependencies ... Done! #> desc::desc_get_deps() not found by renv: #> # A tibble: 3 × 3 #> type package version #> #> 1 Suggests covr * #> 2 Suggests diffviewer * #> 3 Suggests DT * #> #> url_check() #> # A tibble: 1 × 9 #> URL From Status Message New CRAN Spaces R root #> #> 1 https://code.visualstudio… 500 Intern… \"\" \"\" \"\" \"\" /Use… #> html_url_check() #> # A tibble: 3 × 9 #> URL From Status Message New CRAN Spaces R root #> #> 1 http://covr.r-lib.org/ref… 200 OK \"htt… \"\" \"\" \"\" /Use… #> 2 http://r-lib.github.io/rc… 200 OK \"htt… \"\" \"\" \"\" /Use… #> 3 https://code.visualstudio… 500 Intern… \"\" \"\" \"\" \"\" /Use… #> #> Setting env vars: NOT_CRAN=\"true\", CI=\"true\" #> rcmdcheck::rcmdcheck(args = \"--no-manual\", error_on = \"warning\") #> ── R CMD build ───────────────────────────────────────────────────────────────── #> * checking for file ‘.../DESCRIPTION’ ... OK #> * preparing ‘rdev’: #> * checking DESCRIPTION meta-information ... OK #> * installing the package to build vignettes #> * creating vignettes ... OK #> * checking for LF line-endings in source and make files and shell scripts #> * checking for empty or unneeded directories #> * building ‘rdev_1.11.4.tar.gz’ #> #> ── R CMD check ───────────────────────────────────────────────────────────────── #> * using log directory ‘/private/var/folders/vn/cw5f9gws42v9m8mdsds_zbl00000gp/T/Rtmp4kM93U/file108c45e03214f/rdev.Rcheck’ #> * using R version 4.4.1 (2024-06-14) #> * using platform: aarch64-apple-darwin20 #> * R was compiled by #> Apple clang version 14.0.0 (clang-1400.0.29.202) #> GNU Fortran (GCC) 12.2.0 #> * running under: macOS Sonoma 14.6.1 #> * using session charset: UTF-8 #> * using option ‘--no-manual’ #> * checking for file ‘rdev/DESCRIPTION’ ... OK #> * this is package ‘rdev’ version ‘1.11.4’ #> * package encoding: UTF-8 #> * checking package namespace information ... OK #> * checking package dependencies ... OK #> * checking if this is a source package ... OK #> * checking if there is a namespace ... OK #> * checking for executable files ... OK #> * checking for hidden files and directories ... OK #> * checking for portable file names ... OK #> * checking for sufficient/correct file permissions ... OK #> * checking whether package ‘rdev’ can be installed ... OK #> * checking installed package size ... OK #> * checking package directory ... OK #> * checking ‘build’ directory ... OK #> * checking DESCRIPTION meta-information ... OK #> * checking top-level files ... OK #> * checking for left-over files ... OK #> * checking index information ... OK #> * checking package subdirectories ... OK #> * checking code files for non-ASCII characters ... OK #> * checking R files for syntax errors ... OK #> * checking whether the package can be loaded ... OK #> * checking whether the package can be loaded with stated dependencies ... OK #> * checking whether the package can be unloaded cleanly ... OK #> * checking whether the namespace can be loaded with stated dependencies ... OK #> * checking whether the namespace can be unloaded cleanly ... OK #> * checking loading without being on the library search path ... OK #> * checking dependencies in R code ... OK #> * checking S3 generic/method consistency ... OK #> * checking replacement functions ... OK #> * checking foreign function calls ... OK #> * checking R code for possible problems ... OK #> * checking Rd files ... OK #> * checking Rd metadata ... OK #> * checking Rd cross-references ... OK #> * checking for missing documentation entries ... OK #> * checking for code/documentation mismatches ... OK #> * checking Rd \\usage sections ... OK #> * checking Rd contents ... OK #> * checking for unstated dependencies in examples ... OK #> * checking installed files from ‘inst/doc’ ... OK #> * checking files in ‘vignettes’ ... OK #> * checking examples ... OK #> * checking for unstated dependencies in ‘tests’ ... OK #> * checking tests ... #> Running ‘spelling.R’ #> Comparing ‘spelling.Rout’ to ‘spelling.Rout.save’ ... OK #> Running ‘testthat.R’ #> OK #> * checking for unstated dependencies in vignettes ... OK #> * checking package vignettes ... OK #> * checking re-building of vignette outputs ... OK #> * DONE #> #> Status: OK #> ── R CMD check results ──────────────────────────────────────── rdev 1.11.4 ──── #> Duration: 34s #> #> 0 errors ✔ | 0 warnings ✔ | 0 notes ✔"},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":null,"dir":"Reference","previous_headings":"","what":"Build Analysis Site — build_analysis_site","title":"Build Analysis Site — build_analysis_site","text":"build_analysis_site() wrapper pkgdown::build_site_github_pages() adds 'Analysis' menu containing rendered versions .Rmd files analysis/.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build Analysis Site — build_analysis_site","text":"","code":"build_analysis_site(pkg = \".\", ...)"},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build Analysis Site — build_analysis_site","text":"pkg Path package. Currently, pkg = \".\" supported. ... additional arguments passed pkgdown::build_site_github_pages() (implemented)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Build Analysis Site — build_analysis_site","text":"rmarkdown _site.yml yaml, invisibly","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Build Analysis Site — build_analysis_site","text":"run, build_analysis_site(): Reads base pkgdown settings pkgdown/_base.yml Writes base settings _pkgdown.yml Creates template using pkgdown::template_navbar() inserts analysis menu links html versions .Rmd file analysis/ Writes template _pkgdown.yml Updates README.md running devtools::build_readme() (README.Rmd exists) update list notebooks Runs pkgdown::build_site_github_pages() install = TRUE new_process = TRUE Creates _site.yml file based final _pkgdown.yml clones pkgdown navbar temporary build directory Copies following analysis/ build directory: *.Rmd, assets/, data/, import/, rendered/ Changes *.Rmd html_notebook html_document using to_document() Builds site using rmarkdown::render_site() using modified html_document output settings render files look feel html_notebook Moves rendered files docs/: *.html, assets/, rendered/, without overwriting build_analysis_site() fail error files analysis/*.Rmd, pkgdown/_base.yml exist.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"continuous-integration","dir":"Reference","previous_headings":"","what":"Continuous Integration","title":"Build Analysis Site — build_analysis_site","text":"build_rdev_site() build_analysis_site() meant used part CI/CD workflow, temporarily set environment variable CI == \"TRUE\" build fail non-internal topics included reference index page per pkgdown::build_reference().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"supported-file-types","dir":"Reference","previous_headings":"","what":"Supported File Types","title":"Build Analysis Site — build_analysis_site","text":"build_quarto_site() supports R Markdown (.Rmd) Quarto (.qmd) notebooks analysis directory interchangeably, build_analysis_site() supports .Rmd files .","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":null,"dir":"Reference","previous_headings":"","what":"Build Quarto Site — build_quarto_site","title":"Build Quarto Site — build_quarto_site","text":"build_quarto_site() wrapper quarto::quarto_render() also updates README.md optionally deletes Quarto _freeze directory fully re-render site.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build Quarto Site — build_quarto_site","text":"","code":"build_quarto_site(input = NULL, as_job = FALSE, unfreeze = FALSE, ...)"},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build Quarto Site — build_quarto_site","text":"input input file project directory rendered (defaults rendering project current working directory). as_job Render RStudio background job. Default \"auto\", render individual documents normally projects background jobs. Use quarto.render_as_job R option control default globally. unfreeze TRUE, delete Quarto _freeze directory fully re-render site. ... Arguments passed quarto::quarto_render().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Build Quarto Site — build_quarto_site","text":"run, build_quarto_site() calls: devtools::build_readme() unfreeze() (unfreeze = TRUE) quarto::quarto_render()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":"supported-file-types","dir":"Reference","previous_headings":"","what":"Supported File Types","title":"Build Quarto Site — build_quarto_site","text":"build_quarto_site() supports R Markdown (.Rmd) Quarto (.qmd) notebooks analysis directory interchangeably, build_analysis_site() supports .Rmd files .","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":null,"dir":"Reference","previous_headings":"","what":"Build rdev Site — build_rdev_site","title":"Build rdev Site — build_rdev_site","text":"build_rdev_site() wrapper pkgdown::build_site_github_pages() optimized rdev workflow updates README.md performs clean GitHub pages build using pkgdown.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build rdev Site — build_rdev_site","text":"","code":"build_rdev_site(pkg = \".\", ...)"},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build rdev Site — build_rdev_site","text":"pkg Path package. Currently, pkg = \".\" supported. ... additional arguments passed pkgdown::build_site_github_pages() (implemented)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Build rdev Site — build_rdev_site","text":"run, build_rdev_site() calls: devtools::build_readme() pkgdown::build_site_github_pages() install = TRUE new_process = TRUE","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":"continuous-integration","dir":"Reference","previous_headings":"","what":"Continuous Integration","title":"Build rdev Site — build_rdev_site","text":"build_rdev_site() build_analysis_site() meant used part CI/CD workflow, temporarily set environment variable CI == \"TRUE\" build fail non-internal topics included reference index page per pkgdown::build_reference().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/check_renv.html","id":null,"dir":"Reference","previous_headings":"","what":"Check renv — check_renv","title":"Check renv — check_renv","text":"Runs renv status(dev = TRUE), clean(), optionally update()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/check_renv.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check renv — check_renv","text":"","code":"check_renv(update = rlang::is_interactive())"},{"path":"https://jabenninghoff.github.io/rdev/reference/check_renv.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check renv — check_renv","text":"update run renv::update()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/check_renv.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check renv — check_renv","text":"","code":"if (FALSE) { # \\dontrun{ check_renv() check_renv(update = FALSE) } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":null,"dir":"Reference","previous_headings":"","what":"Local CI — ci","title":"Local CI — ci","text":"Run continuous integration tests locally.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Local CI — ci","text":"","code":"ci( renv = TRUE, missing = TRUE, pkgdown = TRUE, styler = NULL, lintr = TRUE, document = TRUE, normalize = TRUE, extra = TRUE, urls = TRUE, rcmdcheck = TRUE )"},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Local CI — ci","text":"renv check renv::status(dev = TRUE) missing run missing_deps() pkgdown check pkgdown::check_pkgdown() _pkgdown.yml exists styler style files using style_all(), see details lintr lint files using lint_all() document run devtools::document() normalize run desc::desc_normalize() extra run extra_deps() urls validate URLs url_check() html_url_check() rcmdcheck run R CMD check using: rcmdcheck::rcmdcheck(args = \"–-manual\", error_on = \"warning\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Local CI — ci","text":"renv::status(dev = TRUE) synchronized, ci() stop. missing_deps() returns missing dependencies, ci() stop. pkgdown::check_pkgdown() halt ci() error _pkgdown.yml invalid. styler set NULL (default), style_all() run uncommitted changes git. Setting value TRUE FALSE overrides check. lint_all() finds lints, ci() stop open RStudio markers pane. Output missing, extra, urls printed tibble improved readability console.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Local CI — ci","text":"","code":"if (FALSE) { # \\dontrun{ ci() ci(styler = TRUE) ci(styler = FALSE, rcmdcheck = FALSE) } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":null,"dir":"Reference","previous_headings":"","what":"Create rdev GitHub repository — create_github_repo","title":"Create rdev GitHub repository — create_github_repo","text":"Create, configure, clone, open new GitHub R package repository following rdev conventions.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create rdev GitHub repository — create_github_repo","text":"","code":"create_github_repo( repo_name, repo_desc = \"\", private = FALSE, org = NULL, host = getOption(\"rdev.host\") )"},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create rdev GitHub repository — create_github_repo","text":"repo_name name GitHub repository create repo_desc description GitHub repository create private TRUE, creates private repository. org organization create repository . NULL, create repository active user's account. host GitHub host target, passed .api_url argument gh::gh(). unspecified, gh defaults \"https://api.github.com\", although gh's default can customised setting GITHUB_API_URL environment variable. hypothetical GitHub Enterprise instance, either \"https://github.acme.com/api/v3\" \"https://github.acme.com\" acceptable.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create rdev GitHub repository — create_github_repo","text":"return value gh::gh() creating repository, invisibly","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create rdev GitHub repository — create_github_repo","text":"run, create_github_repo(): Creates new GitHub repository using gh::gh() license template get_license() Activates Dependabot alerts per getOption(\"rdev.dependabot\", default = TRUE) Activates Dependabot security updates per getOption(\"rdev.dependabot\", default = TRUE) Adds branch protection default branch (private FALSE) Clones repository locally usethis::create_from_github() Creates basic package using usethis::create_package() running interactively macOS, repository automatically opened RStudio, GitHub Desktop, default browser","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"github-actions","dir":"Reference","previous_headings":"","what":"GitHub Actions","title":"Create rdev GitHub repository — create_github_repo","text":"GitHub Actions can disabled setting rdev.github.actions FALSE: options(rdev.github.actions = FALSE)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"host","dir":"Reference","previous_headings":"","what":"Host","title":"Create rdev GitHub repository — create_github_repo","text":"Set rdev.host option using GitHub Enterprise server: options(rdev.host = \"https://github.example.com/api/v3\")","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":null,"dir":"Reference","previous_headings":"","what":"Check dependencies — missing_deps","title":"Check dependencies — missing_deps","text":"Check dependencies DESCRIPTION.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check dependencies — missing_deps","text":"","code":"missing_deps(exclude_base = TRUE) extra_deps()"},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check dependencies — missing_deps","text":"exclude_base exclude packages installed R missing dependencies","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check dependencies — missing_deps","text":"data.frame either renv::dependencies() desc::desc_get_deps().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Check dependencies — missing_deps","text":"missing_deps() reports renv::dependencies() DESCRIPTION. extra_deps() reports desc::desc_get_deps() found renv. current package (pkgload::pkg_name(\".\")) renv (renv.lock ) automatically removed renv::dependencies(), along 'base' R packages exclude_base TRUE (base, compiler, datasets, grDevices, graphics, grid, methods, parallel, splines, stats, stats4, tcltk, tools, utils).","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_license.html","id":null,"dir":"Reference","previous_headings":"","what":"Get license option — get_license","title":"Get license option — get_license","text":"Retrieve validate rdev.license option.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_license.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get license option — get_license","text":"","code":"get_license()"},{"path":"https://jabenninghoff.github.io/rdev/reference/get_license.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get license option — get_license","text":"license string, one c(\"mit\", \"gpl\", \"lgpl\", \"proprietary\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_license.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get license option — get_license","text":"rdev.license must one c(\"mit\", \"gpl\", \"lgpl\", \"proprietary\"), defaults \"mit\". rdev.license \"proprietary\", rdev.license.copyright (name copyright holder) must also set.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":null,"dir":"Reference","previous_headings":"","what":"Get release details — get_release","title":"Get release details — get_release","text":"Extract release version release notes NEWS.md.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get release details — get_release","text":"","code":"get_release(pkg = \".\", filename = \"NEWS.md\")"},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get release details — get_release","text":"pkg path package. Currently, pkg = \".\" supported. filename name file containing release notes, defaults NEWS.md.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get release details — get_release","text":"list containing package, version release notes first release contained NEWS.md","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get release details — get_release","text":"get_release() assumes NEWS.md contains markdown release notes, release header format: \"# \" followed release notes, expects first line NEWS.md release header.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/html_url_check.html","id":null,"dir":"Reference","previous_headings":"","what":"Check URLs in HTML files — html_url_check","title":"Check URLs in HTML files — html_url_check","text":"Runs urlchecker::url_check() database created using url_db_from_HTML_files function tools package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/html_url_check.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check URLs in HTML files — html_url_check","text":"","code":"html_url_check( path = \"docs\", parallel = TRUE, pool = curl::new_pool(), progress = TRUE )"},{"path":"https://jabenninghoff.github.io/rdev/reference/html_url_check.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check URLs in HTML files — html_url_check","text":"path Path directory HTML files parallel TRUE, check URLs parallel pool multi handle created curl::new_pool(). NULL use global pool. progress Whether show progress bar parallel checks","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/html_url_check.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check URLs in HTML files — html_url_check","text":"url_checker_db object (invisibly). check_url_db object added class custom print method.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/init.html","id":null,"dir":"Reference","previous_headings":"","what":"Initialize rdev package — init","title":"Initialize rdev package — init","text":"Initialize rdev package within newly created create_github_repo() project creating new git branch, committing changes, running use_rdev_package().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/init.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Initialize rdev package — init","text":"","code":"init()"},{"path":"https://jabenninghoff.github.io/rdev/reference/init.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Initialize rdev package — init","text":"init() stop rlang::is_interactive() FALSE. running init(), update Title Description fields DESCRIPTION file without committing run either setup_analysis() setup_rdev() per quickstart.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":null,"dir":"Reference","previous_headings":"","what":"Lint all files — lint_all","title":"Lint all files — lint_all","text":"Lint files project. Implemented wrapper lintr::lint_dir().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Lint all files — lint_all","text":"","code":"lint_all( pattern = \"(?i)[.](r|rmd|qmd|rnw|rhtml|rpres|rrst|rtex|rtxt)$\", exclusions = list(\"renv\", \"packrat\", \"R/RcppExports.R\"), ... )"},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Lint all files — lint_all","text":"pattern regex pattern files, default take files extensions .R, .Rmd, .qmd, .Rnw, .Rhtml, .Rpres, .Rrst, .Rtex, .Rtxt, ignoring case. exclusions exclusions exclude(), relative package path. ... Arguments passed lintr::lint_dir parse_settings Logical, default TRUE. Whether try parse settings; otherwise, default_settings() used. path base directory project (lint_dir()) package (lint_package()). relative_path TRUE, file paths printed using path relative base directory. FALSE, use full absolute path. show_progress Logical controlling whether show linting progress simple text progress bar via utils::txtProgressBar(). default behavior show progress interactive() sessions running testthat suite.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Lint all files — lint_all","text":"list lint objects.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Lint all files — lint_all","text":"","code":"if (FALSE) { # \\dontrun{ lint_all() lint_all(\"analysis\") } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":null,"dir":"Reference","previous_headings":"","what":"Temporary package — local_temppkg","title":"Temporary package — local_temppkg","text":"Temporarily create rdev R analysis package, automatically removed afterwards.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Temporary package — local_temppkg","text":"","code":"local_temppkg(dir = fs::file_temp(), type = \"usethis\", env = parent.frame())"},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Temporary package — local_temppkg","text":"dir Path package directory, created necessary, defaults fs::file_temp(). type type package create, one \"usethis\" - usethis::create_package(), \"rdev\" - use_rdev_package(), \"analysis\" - use_analysis_package(use_quarto = FALSE), \"quarto\" - use_analysis_package(use_quarto = TRUE). env Environment passed withr::defer(), defaults parent.frame().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Temporary package — local_temppkg","text":"Path temporary package directory.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Temporary package — local_temppkg","text":"Used internally testing rdev automation. Based usethis case study testthat.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Temporary package — local_temppkg","text":"","code":"if (FALSE) { # \\dontrun{ test_that(\"local_temppkg creates a directory\", { dir <- usethis::ui_silence(local_temppkg()) expect_true(fs::dir_exists(dir)) }) } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":null,"dir":"Reference","previous_headings":"","what":"Merge staged GitHub release — merge_release","title":"Merge staged GitHub release — merge_release","text":"Merge pull request staged stage_release() create new release GitHub.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Merge staged GitHub release — merge_release","text":"","code":"merge_release(pkg = \".\", filename = \"NEWS.md\", host = getOption(\"rdev.host\"))"},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Merge staged GitHub release — merge_release","text":"pkg path package. Currently, pkg = \".\" supported. filename name file containing release notes, defaults NEWS.md. host GitHub host target, passed .api_url argument gh::gh(). unspecified, gh defaults \"https://api.github.com\", although gh's default can customised setting GITHUB_API_URL environment variable. hypothetical GitHub Enterprise instance, either \"https://github.acme.com/api/v3\" \"https://github.acme.com\" acceptable.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Merge staged GitHub release — merge_release","text":"list containing results pull request merge GitHub release, invisibly","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Merge staged GitHub release — merge_release","text":"Manually verify status checks completed running, merge_release() currently validate status checks successful. run, merge_release(): Determines staged release title NEWS.md using get_release() Selects GitHub pull request matches staged release title, stops less one matching PR using gh::gh() Verifies staged pull request ready merged checking locked, draft, mergeable, rebaseable flags Merges pull request default branch using \"Rebase merge\" using gh::gh() Deletes pull request branch remotely locally using gh::gh() gert::git_branch_delete() Updates default branch gert::git_pull() Adds version tag DESCRIPTION commit message \"GitHub release \" gert::git_tag_create() pushes using gert::git_tag_push() Create GitHub release newly created tag, name \"\" release notes body, using gh::gh()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"host","dir":"Reference","previous_headings":"","what":"Host","title":"Merge staged GitHub release — merge_release","text":"Set rdev.host option using GitHub Enterprise server: options(rdev.host = \"https://github.example.com/api/v3\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/new_branch.html","id":null,"dir":"Reference","previous_headings":"","what":"Start a new branch — new_branch","title":"Start a new branch — new_branch","text":"Create new \"feature\" branch current default branch project git repository using gert::git_branch_create() bump 'dev' version 9000 desc::desc_bump_version().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/new_branch.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Start a new branch — new_branch","text":"","code":"new_branch(name, bump_ver = TRUE, current = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/new_branch.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Start a new branch — new_branch","text":"name name new branch. bump_ver TRUE, bump 'dev' version 9000, see details. current create new branch currently active branch (TRUE) default branch (FALSE), see details.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/new_branch.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Start a new branch — new_branch","text":"new branch created checked exist local remote. version DESCRIPTION 3 components (release version) bump_ver TRUE (default), fourth component, 'dev' bumped 9000 checked new branch. version already 4 components, changed. current = FALSE (default), new branch created default branch determined usethis::git_default_branch().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":null,"dir":"Reference","previous_headings":"","what":"Open rdev files — open_files","title":"Open rdev files — open_files","text":"Open standard set files editing RStudio.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Open rdev files — open_files","text":"","code":"open_files(files = c(\"TODO.md\", \"NEWS.md\", \"README.Rmd\", \"DESCRIPTION\"))"},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Open rdev files — open_files","text":"files vector files open.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Open rdev files — open_files","text":"named character vector files opened.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Open rdev files — open_files","text":"default, open_files() opens four documents RStudio: TODO.md, NEWS.md, README.Rmd, DESCRIPTION. open_files() stop error RStudio running.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize package downloads — package_downloads","title":"Summarize package downloads — package_downloads","text":"wrapper cranlogs::cran_downloads() summarizes number package downloads RStudio CRAN mirror.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize package downloads — package_downloads","text":"","code":"package_downloads(packages, when = \"last-month\")"},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize package downloads — package_downloads","text":"packages character vector packages query. period summarize, one last-day, last-week last-month (default).","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize package downloads — package_downloads","text":"data frame containing total number downloads package specified period, sorted popularity.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Summarize package downloads — package_downloads","text":"default, summary last month.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/quickstart.html","id":null,"dir":"Reference","previous_headings":"","what":"rdev Quick Start — quickstart","title":"rdev Quick Start — quickstart","text":"Quick start guide creating new rdev analysis package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/quickstart.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rdev Quick Start — quickstart","text":"quickly create configure new rdev analysis package, use following commands: project open, run create_github_repo() initialize GitHub R repository Without committing git, run init() newly created project Manually update Title Description fields DESCRIPTION file without committing Run setup_analysis() setup_rdev() configure package analysis package rdev package respectively. Manually update .gitignore: remove docs/ exclusion add line breaks , package configuration complete ready development.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rdev-package.html","id":null,"dir":"Reference","previous_headings":"","what":"rdev: R Development Tools — rdev-package","title":"rdev: R Development Tools — rdev-package","text":"opinionated collection development tools, packages, utilities.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/rdev-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"rdev: R Development Tools — rdev-package","text":"Maintainer: John Benninghoff jbenninghoff@mac.com (ORCID)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":null,"dir":"Reference","previous_headings":"","what":"Get analysis notebook metadata — rmd_metadata","title":"Get analysis notebook metadata — rmd_metadata","text":"Extract YAML front matter 'description' line analysis notebook, construct URL notebook's location GitHub pages.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get analysis notebook metadata — rmd_metadata","text":"","code":"rmd_metadata(file_path)"},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get analysis notebook metadata — rmd_metadata","text":"file_path Path analysis notebook","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get analysis notebook metadata — rmd_metadata","text":"Named list containing analysis notebook title, URL, date, description","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get analysis notebook metadata — rmd_metadata","text":"'description' line first non-blank line body R notebook serves brief description work. _quarto.yml present, rmd_metadata() extract YAML front matter description Quarto format (.qmd) notebooks.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_analysis.html","id":null,"dir":"Reference","previous_headings":"","what":"Set up analysis package — setup_analysis","title":"Set up analysis package — setup_analysis","text":"Set analysis package within rdev package newly initialized init(), updating Title Description DESCRIPTION, committing changes running use_analysis_package(), use_spelling(), ci().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_analysis.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set up analysis package — setup_analysis","text":"","code":"setup_analysis(use_quarto = TRUE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_analysis.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set up analysis package — setup_analysis","text":"use_quarto TRUE (default), use Quarto publishing (build_quarto_site()), otherwise use build_analysis_site().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_analysis.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set up analysis package — setup_analysis","text":"setup_analysis() stop rlang::is_interactive() FALSE, run open_files() running RStudio.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_rdev.html","id":null,"dir":"Reference","previous_headings":"","what":"Set up rdev package — setup_rdev","title":"Set up rdev package — setup_rdev","text":"Set rdev package traditional package development running init() updating Title Description DESCRIPTION, committing changes running use_rdev_pkgdown(), use_spelling(), use_codecov(), ci().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_rdev.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set up rdev package — setup_rdev","text":"","code":"setup_rdev()"},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_rdev.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set up rdev package — setup_rdev","text":"setup_rdev() stop rlang::is_interactive() FALSE, run open_files() running RStudio.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_file.html","id":null,"dir":"Reference","previous_headings":"","what":"Sort file — sort_file","title":"Sort file — sort_file","text":"Sorts file using R sort().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_file.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sort file — sort_file","text":"","code":"sort_file(filename)"},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_file.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sort file — sort_file","text":"filename file sorted","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_file.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Sort file — sort_file","text":"","code":"if (FALSE) { # \\dontrun{ sort_file(\".Rbuildignore\") } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_rbuildignore.html","id":null,"dir":"Reference","previous_headings":"","what":"Sort .Rbuildignore file — sort_rbuildignore","title":"Sort .Rbuildignore file — sort_rbuildignore","text":"Sorts .Rbuildignore file using sort_file().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_rbuildignore.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sort .Rbuildignore file — sort_rbuildignore","text":"","code":"sort_rbuildignore()"},{"path":"https://jabenninghoff.github.io/rdev/reference/spell_check_notebooks.html","id":null,"dir":"Reference","previous_headings":"","what":"Spell Check Notebooks — spell_check_notebooks","title":"Spell Check Notebooks — spell_check_notebooks","text":"Perform spell check notebooks spelling::spell_check_files().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/spell_check_notebooks.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spell Check Notebooks — spell_check_notebooks","text":"","code":"spell_check_notebooks( path = \"analysis\", regexp = \"[.][Rq]md$\", use_wordlist = TRUE, lang = NULL )"},{"path":"https://jabenninghoff.github.io/rdev/reference/spell_check_notebooks.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spell Check Notebooks — spell_check_notebooks","text":"path character vector one paths. regexp regular expression (e.g. [.]csv$) passed grep() filter paths. use_wordlist ignore words package WORDLIST file. lang set Language field DESCRIPTION e.g. \"en-US\" \"en-GB\". supporting languages, see hunspell vignette.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/spell_check_notebooks.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Spell Check Notebooks — spell_check_notebooks","text":"lang NULL (default), get language DESCRIPTION using desc::desc_get_field().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":null,"dir":"Reference","previous_headings":"","what":"Stage a GitHub release — stage_release","title":"Stage a GitHub release — stage_release","text":"Open GitHub pull request new release NEWS.md. Approve, merge, create release using merge_release().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Stage a GitHub release — stage_release","text":"","code":"stage_release( pkg = \".\", filename = \"NEWS.md\", unfreeze = FALSE, host = getOption(\"rdev.host\") )"},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Stage a GitHub release — stage_release","text":"pkg path package. Currently, pkg = \".\" supported. filename name file containing release notes, defaults NEWS.md. unfreeze TRUE, delete Quarto _freeze directory fully re-render site. host GitHub host target, passed .api_url argument gh::gh(). unspecified, gh defaults \"https://api.github.com\", although gh's default can customised setting GITHUB_API_URL environment variable. hypothetical GitHub Enterprise instance, either \"https://github.acme.com/api/v3\" \"https://github.acme.com\" acceptable.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Stage a GitHub release — stage_release","text":"results GitHub pull request, invisibly","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Stage a GitHub release — stage_release","text":"run, stage_release(): Extracts release version release notes NEWS.md using get_release() Validates version conforms rdev conventions (#.#.#) release notes empty Verifies version tag already exist using gert::git_tag_list() Checks uncommitted changes stops exist using gert::git_status() Creates new branch default branch (gert::git_branch() == usethis::git_default_branch()) using gert::git_branch_create() Updates Version DESCRIPTION desc::desc_set_version(), commits push git message \"GitHub release \" using gert::git_add(), gert::git_commit() gert::git_push() Runs build_quarto_site() (_quarto.yml exists), build_analysis_site() (pkgdown/_base.yml exists) build_rdev_site() (_pkgdown.yml exists), commits pushes changes () git message: \" release \" Opens pull request title \" \" release notes body using gh::gh()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"host","dir":"Reference","previous_headings":"","what":"Host","title":"Stage a GitHub release — stage_release","text":"Set rdev.host option using GitHub Enterprise server: options(rdev.host = \"https://github.example.com/api/v3\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/style_all.html","id":null,"dir":"Reference","previous_headings":"","what":"Style all files — style_all","title":"Style all files — style_all","text":"Style files project. Implemented wrapper styler::style_dir() defaults styling .R, .Rprofile, .Rmd, .Rmarkdown, .Rnw, .qmd files, excluding files packrat, renv, R/RcppExports.R.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/style_all.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Style all files — style_all","text":"","code":"style_all( path = \".\", filetype = c(\"R\", \"Rprofile\", \"Rmd\", \"Rmarkdown\", \"Rnw\", \"Qmd\"), exclude_dirs = c(\"packrat\", \"renv\"), exclude_files = \"R/RcppExports.R\", ... )"},{"path":"https://jabenninghoff.github.io/rdev/reference/style_all.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Style all files — style_all","text":"path Path directory files transform. filetype Vector file extensions indicating file types styled. Case ignored, . optional, e.g. c(\".R\",\".Rmd\"), c(\"r\", \"rmd\"). Supported values (standardization) : \"qmd\", \"r\", \"rmd\", \"rmarkdown\", \"rnw\", \"rprofile\". Rmarkdown treated Rmd. exclude_dirs Character vector directories exclude (recursively). exclude_files Character vector regular expressions files excluded styling. ... Arguments passed styler::style_dir style function creates style guide use, default tidyverse_style. used except construct argument transformers. See style_guides() details. transformers set transformer functions. argument conveniently constructed via style argument .... See 'Examples'. recursive logical value indicating whether files sub directories path styled well. include_roxygen_examples Whether style code roxygen examples. base_indention Integer scalar indicating many spaces whole output text indented. Note splitting line add base_indention spaces code case multi-line strings present. See 'Examples'. dry indicate whether styler run dry mode, .e. refrain writing back files .\"\" \"fail\" write back, latter returns error input code identical result styling. \"\", default, writes back input output styling identical.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/style_all.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Style all files — style_all","text":"","code":"if (FALSE) { # \\dontrun{ style_all() style_all(\"analysis\", filetype = \"Rmd\") } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert R Notebook to html_document — to_document","title":"Convert R Notebook to html_document — to_document","text":"Copies file using fs::file_copy() changes output type yaml front matter html_notebook html_document, removing output types.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert R Notebook to html_document — to_document","text":"","code":"to_document(file_path, new_path, overwrite = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert R Notebook to html_document — to_document","text":"file_path Path source file new_path Path copy converted file using fs::file_copy() overwrite Overwrite file exists, passed fs::file_copy()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert R Notebook to html_document — to_document","text":"Path new file","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert R Notebook to html_document — to_document","text":"","code":"if (FALSE) { # \\dontrun{ to_document(\"notebook.Rmd\", \"document.Rmd\") to_document(\"notebooks_dir/notebook.Rmd\", \"documents_dir\") } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/unfreeze.html","id":null,"dir":"Reference","previous_headings":"","what":"Unfreeze Quarto site — unfreeze","title":"Unfreeze Quarto site — unfreeze","text":"Delete Quarto _freeze directory fully re-render site quarto::quarto_render() called.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/unfreeze.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Unfreeze Quarto site — unfreeze","text":"","code":"unfreeze()"},{"path":"https://jabenninghoff.github.io/rdev/reference/update_wordlist_notebooks.html","id":null,"dir":"Reference","previous_headings":"","what":"Update WORDLIST from notebooks — update_wordlist_notebooks","title":"Update WORDLIST from notebooks — update_wordlist_notebooks","text":"Update package inst/WORDLIST words spell_check_notebooks().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/update_wordlist_notebooks.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Update WORDLIST from notebooks — update_wordlist_notebooks","text":"","code":"update_wordlist_notebooks( pkg = \".\", vignettes = TRUE, path = \"analysis\", regexp = \"[.][Rq]md$\", confirm = TRUE )"},{"path":"https://jabenninghoff.github.io/rdev/reference/update_wordlist_notebooks.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Update WORDLIST from notebooks — update_wordlist_notebooks","text":"pkg path package root directory containing DESCRIPTION file vignettes check rmd rnw files pkg root directory (e.g. readme.md) package vignettes folder. path character vector one paths. regexp regular expression (e.g. [.]csv$) passed grep() filter paths. confirm show changes ask confirmation adding new words list","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/update_wordlist_notebooks.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Update WORDLIST from notebooks — update_wordlist_notebooks","text":"update_wordlist_notebooks customized version spelling::update_wordlist() using code wordlist.R.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/urlchecker-reexports.html","id":null,"dir":"Reference","previous_headings":"","what":"Functions re-exported from the urlchecker package — urlchecker-reexports","title":"Functions re-exported from the urlchecker package — urlchecker-reexports","text":"functions re-exported urlchecker package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/urlchecker-reexports.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Functions re-exported from the urlchecker package — urlchecker-reexports","text":"","code":"url_check( path = \".\", db = NULL, parallel = TRUE, pool = curl::new_pool(), progress = TRUE ) url_update(path = \".\", results = url_check(path))"},{"path":"https://jabenninghoff.github.io/rdev/reference/urlchecker-reexports.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Functions re-exported from the urlchecker package — urlchecker-reexports","text":"path Path package db url database parallel TRUE, check URLs parallel pool multi handle created curl::new_pool(). NULL use global pool. progress Whether show progress bar parallel checks results results url_check.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/urlchecker-reexports.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Functions re-exported from the urlchecker package — urlchecker-reexports","text":"Follow links see urlchecker documentation. urlchecker::url_check() urlchecker::url_update()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":null,"dir":"Reference","previous_headings":"","what":"Use Analysis Package Layout — use_analysis_package","title":"Use Analysis Package Layout — use_analysis_package","text":"Add Analysis Package Layout current package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use Analysis Package Layout — use_analysis_package","text":"","code":"use_analysis_package(use_quarto = TRUE, prompt = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use Analysis Package Layout — use_analysis_package","text":"use_quarto TRUE (default), use Quarto publishing (build_quarto_site()), otherwise use build_analysis_site(). prompt TRUE, prompt writing renv.lock, passed renv::snapshot().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Use Analysis Package Layout — use_analysis_package","text":"List containing dirs created, rbuildignore lines added .Rbuildignore, gitignore exclusions added .gitignore.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use Analysis Package Layout — use_analysis_package","text":"run, use_analysis_package(): Creates analysis package directories Adds exclusions .gitignore .Rbuildignore Adds extra.css analysis/assets pkgdown (use_quarto FALSE) fix rendering GitHub-style task lists Adds .nojekyll, _quarto.yml, changelog.qmd, index.qmd analysis/_metadata.yml templates creates _base.yml pkgdown first URL DESCRIPTION Installs README.Rmd template analysis packages, dplyr package needed README.Rmd template","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev code coverage — use_codecov","title":"Use rdev code coverage — use_codecov","text":"Install code coverage usethis::use_coverage(type = \"codecov\"), DT package covr::report(), rdev GitHub action test-coverage.yaml.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev code coverage — use_codecov","text":"","code":"use_codecov(prompt = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev code coverage — use_codecov","text":"prompt TRUE, prompt writing renv.lock, passed renv::snapshot().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use rdev code coverage — use_codecov","text":"use_rdev_package(), use_analysis_package() use_codecov() modify README.Rmd, use_codecov() must run last changes overwritten. use_codecov() run use_rdev_package(). Set option rdev.codecov FALSE skip installation codecov.io test-coverage.yaml: options(rdev.codecov = FALSE)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":"github-actions","dir":"Reference","previous_headings":"","what":"GitHub Actions","title":"Use rdev code coverage — use_codecov","text":"GitHub Actions can disabled setting rdev.github.actions FALSE: options(rdev.github.actions = FALSE)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_lintr.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev .lintr — use_lintr","title":"Use rdev .lintr — use_lintr","text":"Install rdev .lintr template using usethis::use_template()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_lintr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev .lintr — use_lintr","text":"","code":"use_lintr(open = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_lintr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev .lintr — use_lintr","text":"open Open newly created file editing? Happens RStudio, applicable, via utils::file.edit() otherwise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_package_r.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev package.R — use_package_r","title":"Use rdev package.R — use_package_r","text":"Install rdev package.R template using usethis::use_template()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_package_r.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev package.R — use_package_r","text":"","code":"use_package_r(open = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_package_r.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev package.R — use_package_r","text":"open Open newly created file editing? Happens RStudio, applicable, via utils::file.edit() otherwise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_package_r.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use rdev package.R — use_package_r","text":"package.R saved \"R/package.R\".","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev package conventions — use_rdev_package","title":"Use rdev package conventions — use_rdev_package","text":"Add rdev templates settings within active package. Normally invoked first setting package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev package conventions — use_rdev_package","text":"","code":"use_rdev_package(quiet = TRUE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev package conventions — use_rdev_package","text":"quiet TRUE, disable user prompts setting rlang::local_interactive() FALSE.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":"github-pages","dir":"Reference","previous_headings":"","what":"GitHub Pages","title":"Use rdev package conventions — use_rdev_package","text":"GitHub Pages enabled default public repositories, can disabled setting rdev.github.pages FALSE: options(rdev.github.pages = FALSE). GitHub Pages disabled default private repositories (supported free plan), can enabled setting rdev.github.pages TRUE.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":"github-actions","dir":"Reference","previous_headings":"","what":"GitHub Actions","title":"Use rdev package conventions — use_rdev_package","text":"GitHub Actions can disabled setting rdev.github.actions FALSE: options(rdev.github.actions = FALSE)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_pkgdown.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev pkgdown — use_rdev_pkgdown","title":"Use rdev pkgdown — use_rdev_pkgdown","text":"Add pkgdown rdev customizations. Implemented wrapper usethis::use_pkgdown().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_pkgdown.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev pkgdown — use_rdev_pkgdown","text":"","code":"use_rdev_pkgdown(config_file = \"_pkgdown.yml\", destdir = \"docs\")"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_pkgdown.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev pkgdown — use_rdev_pkgdown","text":"config_file Path pkgdown yaml config file, relative project. destdir Target directory pkgdown docs.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_pkgdown.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use rdev pkgdown — use_rdev_pkgdown","text":"addition running usethis::use_pkgdown(), use_rdev_pkgdown adds extra.css pkgdown fix rendering GitHub-style task lists, adds GitHub Pages URL, enables template.light-switch.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rprofile.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev .Rprofile — use_rprofile","title":"Use rdev .Rprofile — use_rprofile","text":"Install rdev .Rprofile template using usethis::use_template()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rprofile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev .Rprofile — use_rprofile","text":"","code":"use_rprofile(open = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rprofile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev .Rprofile — use_rprofile","text":"open Open newly created file editing? Happens RStudio, applicable, via utils::file.edit() otherwise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_spelling.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev spelling — use_spelling","title":"Use rdev spelling — use_spelling","text":"Install spelling rdev conventions.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_spelling.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev spelling — use_spelling","text":"","code":"use_spelling(lang = \"en-US\", prompt = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_spelling.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev spelling — use_spelling","text":"lang Preferred spelling language. Usually either \"en-US\" \"en-GB\". prompt TRUE, prompt writing renv.lock, passed renv::snapshot().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_spelling.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use rdev spelling — use_spelling","text":"Since spelling::spell_check_setup() requires user interaction, use_spelling() run use_rdev_package().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_todo.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev TODO.md — use_todo","title":"Use rdev TODO.md — use_todo","text":"Install rdev TODO.md template using usethis::use_template()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_todo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev TODO.md — use_todo","text":"","code":"use_todo(open = rlang::is_interactive())"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_todo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev TODO.md — use_todo","text":"open Open newly created file editing? Happens RStudio, applicable, via utils::file.edit() otherwise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1114","dir":"Changelog","previous_headings":"","what":"rdev 1.11.4","title":"rdev 1.11.4","text":"Updated “Introduction rdev” vignette, vignette(\"rdev\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1113","dir":"Changelog","previous_headings":"","what":"rdev 1.11.3","title":"rdev 1.11.3","text":"Added support Visual Studio Code (languageserver package) default","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1112","dir":"Changelog","previous_headings":"","what":"rdev 1.11.2","title":"rdev 1.11.2","text":"Minor updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1111","dir":"Changelog","previous_headings":"","what":"rdev 1.11.1","title":"rdev 1.11.1","text":"Enabled pkgdown “light switch” default packages using use_rdev_pkgdown()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1110","dir":"Changelog","previous_headings":"","what":"rdev 1.11.0","title":"rdev 1.11.0","text":"Added function package_downloads(): wrapper cranlogs::cran_downloads() summarizes number package downloads RStudio CRAN mirror","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-11011","dir":"Changelog","previous_headings":"","what":"rdev 1.10.11","title":"rdev 1.10.11","text":"Minor updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-11010","dir":"Changelog","previous_headings":"","what":"rdev 1.10.10","title":"rdev 1.10.10","text":"Bug fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1109","dir":"Changelog","previous_headings":"","what":"rdev 1.10.9","title":"rdev 1.10.9","text":"Add support single URL DESCRIPTION","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1108","dir":"Changelog","previous_headings":"","what":"rdev 1.10.8","title":"rdev 1.10.8","text":"Added support private repositories use_rdev_package()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1107","dir":"Changelog","previous_headings":"","what":"rdev 1.10.7","title":"rdev 1.10.7","text":"Added support creating private repositories create_github_repo()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1106","dir":"Changelog","previous_headings":"","what":"rdev 1.10.6","title":"rdev 1.10.6","text":"Updated R 4.4.0","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1105","dir":"Changelog","previous_headings":"","what":"rdev 1.10.5","title":"rdev 1.10.5","text":"Updated pkgdown templates (update: use_rdev_pkgdown() use_analysis_package(use_quarto = FALSE))","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1104","dir":"Changelog","previous_headings":"","what":"rdev 1.10.4","title":"rdev 1.10.4","text":"Updated GitHub Actions work better renv (update https://github.com/jabenninghoff/rdev/tree/main/.github/workflows)","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1103","dir":"Changelog","previous_headings":"","what":"rdev 1.10.3","title":"rdev 1.10.3","text":"Updated R-CMD-check.yaml GitHub Action (update: use_rdev_package())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1102","dir":"Changelog","previous_headings":"","what":"rdev 1.10.2","title":"rdev 1.10.2","text":"rdev now supports Quarto Documents (.qmd) analysis notebooks: rmd_metadata() extract YAML front matter description Quarto format (.qmd) notebooks _quarto.yml present build_quarto_site() now supports use Rmd /qmd notebooks analysis spell_check_notebooks() update_wordlist_notebooks() now check Rmd qmd files analysis directory Updated README.Rmd template list .Rmd .qmd notebooks analysis Added reference Quarto Document analysis template inst/templates/analysis.qmd (RStudio currently doesn’t support .qmd files document templates) Updated vignettes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1101","dir":"Changelog","previous_headings":"","what":"rdev 1.10.1","title":"rdev 1.10.1","text":"Added unfreeze parameter stage_release(), passed build_quarto_site()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1911","dir":"Changelog","previous_headings":"","what":"rdev 1.9.11","title":"rdev 1.9.11","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1910","dir":"Changelog","previous_headings":"","what":"rdev 1.9.10","title":"rdev 1.9.10","text":"Updated build_rdev_site() build_analysis_site() use pkgdown::build_site_github_pages() instead pkgdown::build_site(), disables Jekyll rendering adds CNAME needed","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-199","dir":"Changelog","previous_headings":"","what":"rdev 1.9.9","title":"rdev 1.9.9","text":"Updated quarto configuration (update: use_analysis_package())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-198","dir":"Changelog","previous_headings":"","what":"rdev 1.9.8","title":"rdev 1.9.8","text":"Added quarto themes (flatly, darkly) (update: use_analysis_package()) Updated analysis template","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-197","dir":"Changelog","previous_headings":"","what":"rdev 1.9.7","title":"rdev 1.9.7","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-196","dir":"Changelog","previous_headings":"","what":"rdev 1.9.6","title":"rdev 1.9.6","text":"Add new rdev hex sticker logo stickers man/figures/logo.png per roxygen2 README.Rmd per pkgdown Fixed bugs quickstart functions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-195","dir":"Changelog","previous_headings":"","what":"rdev 1.9.5","title":"rdev 1.9.5","text":"Updated TODO","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-194","dir":"Changelog","previous_headings":"","what":"rdev 1.9.4","title":"rdev 1.9.4","text":"Updated lintr.yaml GitHub Action match lint_all() (update: run use_rdev_package())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-193","dir":"Changelog","previous_headings":"","what":"rdev 1.9.3","title":"rdev 1.9.3","text":"lint_all() style_all() now (properly) exclude R/RcppExports.R","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-192","dir":"Changelog","previous_headings":"","what":"rdev 1.9.2","title":"rdev 1.9.2","text":"Updated manual tests Bug fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-191","dir":"Changelog","previous_headings":"","what":"rdev 1.9.1","title":"rdev 1.9.1","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-190","dir":"Changelog","previous_headings":"","what":"rdev 1.9.0","title":"rdev 1.9.0","text":"Adjusted Quarto margins _quarto.yml Added ?quickstart rdev Quick Start guide creating new rdev analysis package updated related functions (create_github_repo(), init(), setup_analysis()) README Added function setup_rdev(): set rdev package traditional package development Added function open_files(): open standard set files editing RStudio setup_analysis() setup_rdev() now call open_files() running RStudio","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-186","dir":"Changelog","previous_headings":"","what":"rdev 1.8.6","title":"rdev 1.8.6","text":"Check function arguments checkmate","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-185","dir":"Changelog","previous_headings":"","what":"rdev 1.8.5","title":"rdev 1.8.5","text":"Changed use_analysis_package() store _freeze directory git per Quarto guide","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-184","dir":"Changelog","previous_headings":"","what":"rdev 1.8.4","title":"rdev 1.8.4","text":"Also set GitHub Pages URL use_rdev_pkgdown()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-183","dir":"Changelog","previous_headings":"","what":"rdev 1.8.3","title":"rdev 1.8.3","text":"Check pandoc PATH launch (update: use_rprofile())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-182","dir":"Changelog","previous_headings":"","what":"rdev 1.8.2","title":"rdev 1.8.2","text":"Added rendering fixes use_analysis_package() (update: re-run use_analysis_package() update notebooks Analysis Notebook template) Added function use_rdev_pkgdown(): add pkgdown rdev customizations","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-181","dir":"Changelog","previous_headings":"","what":"rdev 1.8.1","title":"rdev 1.8.1","text":"Added support Visual Studio Code setup-r Quarto bug fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-180","dir":"Changelog","previous_headings":"","what":"rdev 1.8.0","title":"rdev 1.8.0","text":"Added support Quarto, including: New function build_quarto_site(): wrapper quarto::quarto_render() also updates README.md optionally deletes Quarto _freeze directory fully re-render site New function unfreeze(): delete Quarto _freeze directory fully re-render site quarto::quarto_render() called Updated stage_release() run build_quarto_site() using Quarto Updated use_analysis_package() use Quarto publishing default Added “quarto” package type local_temppkg() Additional changes: Updated vignettes Added “Introduction rdev” getting started vignette Added pkgdown::check_pkgdown() check ci()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-172","dir":"Changelog","previous_headings":"","what":"rdev 1.7.2","title":"rdev 1.7.2","text":"Updated .lintr lintr 3.1.1 (update use_lintr())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-171","dir":"Changelog","previous_headings":"","what":"rdev 1.7.1","title":"rdev 1.7.1","text":"Updated installation instructions README templates use remotes instead devtools","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-170","dir":"Changelog","previous_headings":"","what":"rdev 1.7.0","title":"rdev 1.7.0","text":"Updated check_renv() ci() use renv::status(dev = TRUE), added renv 1.0.3","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-169","dir":"Changelog","previous_headings":"","what":"rdev 1.6.9","title":"rdev 1.6.9","text":"Disabled use Posit package manager R-CMD-check.yaml (update use_rdev_package())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-168","dir":"Changelog","previous_headings":"","what":"rdev 1.6.8","title":"rdev 1.6.8","text":"Updated setup-r use rig installing managing R versions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-167","dir":"Changelog","previous_headings":"","what":"rdev 1.6.7","title":"rdev 1.6.7","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-166","dir":"Changelog","previous_headings":"","what":"rdev 1.6.6","title":"rdev 1.6.6","text":"Replaced check-standard.yaml R-CMD-check.yaml (update use_rdev_package()) Updated .lintr lintr 3.1.0 (update use_lintr()) Updated spelling tests (update use_spelling())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-165","dir":"Changelog","previous_headings":"","what":"rdev 1.6.5","title":"rdev 1.6.5","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-164","dir":"Changelog","previous_headings":"","what":"rdev 1.6.4","title":"rdev 1.6.4","text":"Added check install pre-commit git hook missing (update use_rprofile())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-163","dir":"Changelog","previous_headings":"","what":"rdev 1.6.3","title":"rdev 1.6.3","text":"extra_deps() longer reports R extra package","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-162","dir":"Changelog","previous_headings":"","what":"rdev 1.6.2","title":"rdev 1.6.2","text":"missing_deps() now excludes base R packages default Added new checks ci(): missing_deps(), desc::desc_normalize(), extra_deps(), url_check(), html_url_check(); ci() stop missing_deps() returns one rows Added missing-deps.yaml GitHub Action","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-161","dir":"Changelog","previous_headings":"","what":"rdev 1.6.1","title":"rdev 1.6.1","text":"new_branch() now stashes restores changes, Bump version commit just changes version number DESCRIPTION","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-160","dir":"Changelog","previous_headings":"","what":"rdev 1.6.0","title":"rdev 1.6.0","text":"missing_deps() extra_deps() now automatically remove current package renv (renv.lock) list renv::dependencies()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-159","dir":"Changelog","previous_headings":"","what":"rdev 1.5.9","title":"rdev 1.5.9","text":"Update build_analysis_site() ‘Analysis Notebook’ R markdown template use Bootstrap 5 using bslib Update rdev pkgdown site use Bootstrap 5","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-158","dir":"Changelog","previous_headings":"","what":"rdev 1.5.8","title":"rdev 1.5.8","text":"Update options enable warnings partial matches","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-157","dir":"Changelog","previous_headings":"","what":"rdev 1.5.7","title":"rdev 1.5.7","text":"Add option warn partial $ matches","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-156","dir":"Changelog","previous_headings":"","what":"rdev 1.5.6","title":"rdev 1.5.6","text":"Update lint_all() also check .Rpres files","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-155","dir":"Changelog","previous_headings":"","what":"rdev 1.5.5","title":"rdev 1.5.5","text":"Add option disable GitHub Pages use_rdev_package() options(rdev.github.pages = FALSE) Use proper GitHub Pages URL trailing “/”","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-154","dir":"Changelog","previous_headings":"","what":"rdev 1.5.4","title":"rdev 1.5.4","text":"Minor maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-153","dir":"Changelog","previous_headings":"","what":"rdev 1.5.3","title":"rdev 1.5.3","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-152","dir":"Changelog","previous_headings":"","what":"rdev 1.5.2","title":"rdev 1.5.2","text":"Minor updates Style Guide","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-151","dir":"Changelog","previous_headings":"","what":"rdev 1.5.1","title":"rdev 1.5.1","text":"Replace development lintr CRAN release 3.0.0 Add Style Guide vignette, describing rdev coding style, styler lintr configuration","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-150","dir":"Changelog","previous_headings":"","what":"rdev 1.5.0","title":"rdev 1.5.0","text":"Added styler cache options .Rprofile template Imported urlchecker::url_check(), urlchecker::url_update(), added new function, html_url_check(), check URLs docs/ (replaces proof-docs script) Replaced scripts tools/ automating package setup init(): run create_github_repo(), setup_analysis(): run init() Moved setup-r inst/bin Increased test coverage","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-149","dir":"Changelog","previous_headings":"","what":"rdev 1.4.9","title":"rdev 1.4.9","text":"Clean tests, standardize error messages","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-148","dir":"Changelog","previous_headings":"","what":"rdev 1.4.8","title":"rdev 1.4.8","text":"Make rdev data.table aware","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-147","dir":"Changelog","previous_headings":"","what":"rdev 1.4.7","title":"rdev 1.4.7","text":"Added scripts tools/ automate package setup","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-146","dir":"Changelog","previous_headings":"","what":"rdev 1.4.6","title":"rdev 1.4.6","text":"Updated lint workflow","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-145","dir":"Changelog","previous_headings":"","what":"rdev 1.4.5","title":"rdev 1.4.5","text":"Updated new linters","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-144","dir":"Changelog","previous_headings":"","what":"rdev 1.4.4","title":"rdev 1.4.4","text":"Enable linters inst/templates/lintr","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-143","dir":"Changelog","previous_headings":"","what":"rdev 1.4.3","title":"rdev 1.4.3","text":"Normalize DESCRIPTION file","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-142","dir":"Changelog","previous_headings":"","what":"rdev 1.4.2","title":"rdev 1.4.2","text":"Remove workaround resolved upstream issue","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-141","dir":"Changelog","previous_headings":"","what":"rdev 1.4.1","title":"rdev 1.4.1","text":"Added missing Suggests dependencies setup functions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-140","dir":"Changelog","previous_headings":"","what":"rdev 1.4.0","title":"rdev 1.4.0","text":"Added functions check dependencies: missing_deps() reports renv::dependencies() DESCRIPTION, extra_deps() reports desc::desc_get_deps() found renv Added renv check ci(): renv::status() synchronized, ci() stop","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-138","dir":"Changelog","previous_headings":"","what":"rdev 1.3.8","title":"rdev 1.3.8","text":"Fix bugs tests, use_analysis_package()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-137","dir":"Changelog","previous_headings":"","what":"rdev 1.3.7","title":"rdev 1.3.7","text":"Fixed bug lint workflow","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-136","dir":"Changelog","previous_headings":"","what":"rdev 1.3.6","title":"rdev 1.3.6","text":"Updated .Rprofile load current package start Updated R version 4.2.0 (2022-04-22) – “Vigorous Calisthenics”","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-135","dir":"Changelog","previous_headings":"","what":"rdev 1.3.5","title":"rdev 1.3.5","text":"Updated GitHub workflows","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-134","dir":"Changelog","previous_headings":"","what":"rdev 1.3.4","title":"rdev 1.3.4","text":"Added new test scripts new package setup","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-133","dir":"Changelog","previous_headings":"","what":"rdev 1.3.3","title":"rdev 1.3.3","text":"Fixed ci() stage_release() correctly use gert::git_status() determine uncommitted changes exist (instead gert::git_diff_patch())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-132","dir":"Changelog","previous_headings":"","what":"rdev 1.3.2","title":"rdev 1.3.2","text":"Fixed update_wordlist_notebooks(): removed duplicate words Update use_spelling() install test-spelling.R testthat template","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-131","dir":"Changelog","previous_headings":"","what":"rdev 1.3.1","title":"rdev 1.3.1","text":"Added update_wordlist_notebooks(): Update package inst/WORDLIST words spell_check_notebooks() Updated spell_check_notebooks() use Language field DESCRIPTION default","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-130","dir":"Changelog","previous_headings":"","what":"rdev 1.3.0","title":"rdev 1.3.0","text":"Added new options features support GitHub Enterprise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"new-options-1-3-0","dir":"Changelog","previous_headings":"","what":"New Options","title":"rdev 1.3.0","text":"Added settings, configured using options() rdev.host: set default server create_github_repo(), stage_release(), merge_release() (support GitHub Enterprise) rdev.codecov: disable codecov.io support use_codecov() rdev.dependabot: disable support Dependabot create_github_repo() rdev.license rdev.license.copyright: specify licenses create_github_repo(), use_rdev_package() rdev.github.actions: disable support GitHub Actions create_github_repo(), use_codecov(), use_rdev_package()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"new-features-1-3-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"rdev 1.3.0","text":"create_github_repo() now supports creating repositories within organizations Updated setup-r script include pkgdown","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-126","dir":"Changelog","previous_headings":"","what":"rdev 1.2.6","title":"rdev 1.2.6","text":"Updated stage_release() run build_rdev_site() _pkgdown.yml exists","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-125","dir":"Changelog","previous_headings":"","what":"rdev 1.2.5","title":"rdev 1.2.5","text":"Updated ci() run spell check tests","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-124","dir":"Changelog","previous_headings":"","what":"rdev 1.2.4","title":"rdev 1.2.4","text":"Fix bug workaround closed usethis issue #1568","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-123","dir":"Changelog","previous_headings":"","what":"rdev 1.2.3","title":"rdev 1.2.3","text":"Updated use_codecov() use sort_rbuildignore()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-122","dir":"Changelog","previous_headings":"","what":"rdev 1.2.2","title":"rdev 1.2.2","text":"Implement workaround closed usethis issue #1568 use_analysis_package() now installs dplyr, used README.Rmd template Documentation updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-121","dir":"Changelog","previous_headings":"","what":"rdev 1.2.1","title":"rdev 1.2.1","text":"create_github_repo() now adds branch protection default branch","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-120","dir":"Changelog","previous_headings":"","what":"rdev 1.2.0","title":"rdev 1.2.0","text":"Added spell_check_notebooks(): Perform spell check notebooks spelling::spell_check_files().","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-111","dir":"Changelog","previous_headings":"","what":"rdev 1.1.1","title":"rdev 1.1.1","text":"Fix R-CMD-check Windows check_renv() now defaults running update interactive","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-110","dir":"Changelog","previous_headings":"","what":"rdev 1.1.0","title":"rdev 1.1.0","text":"style_all() now runs automatically uncommitted changes lint_all() now runs default opens RStudio markers pane lints found","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-101","dir":"Changelog","previous_headings":"","what":"rdev 1.0.1","title":"rdev 1.0.1","text":"Minor updates analysis README.Rmd template","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-100","dir":"Changelog","previous_headings":"","what":"rdev 1.0.0","title":"rdev 1.0.0","text":"rdev now stable enough 1.0.0 release!","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"major-features-1-0-0","dir":"Changelog","previous_headings":"","what":"Major features","title":"rdev 1.0.0","text":"rdev provides functions templates : Release automation: Stage create GitHub releases, including GitHub pages Continuous Integration: Local continuous integration checks dependency management Package Setup: Package setup tasks, typically performed ","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"recent-changes-1-0-0","dir":"Changelog","previous_headings":"","what":"Recent changes","title":"rdev 1.0.0","text":"Changes since release 0.8.9: Add use_spelling() use_codecov() Added local_temppkg() test helper function Minor enhancements use_rdev_package(), use_analysis_package(), build_analysis_site(), README.Rmd templates Updated documentation Added manual test script new package setup, increased test coverage","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"todo-1-0-0","dir":"Changelog","previous_headings":"","what":"TODO","title":"rdev 1.0.0","text":"ci(): styler set automatically run uncommitted changes lintr stop execution open RStudio markers lints found ci() run styler lintr default","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-089","dir":"Changelog","previous_headings":"","what":"rdev 0.8.9","title":"rdev 0.8.9","text":"Bug fixes use_rdev_package(), proof-docs","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-088","dir":"Changelog","previous_headings":"","what":"rdev 0.8.8","title":"rdev 0.8.8","text":"Added proof-docs script tools, checks docs directory using htmlproofer","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-087","dir":"Changelog","previous_headings":"","what":"rdev 0.8.7","title":"rdev 0.8.7","text":"Moved rmd_metadata() README-analysis.Rmd rdev package Increased test coverage, reorganized files","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-086","dir":"Changelog","previous_headings":"","what":"rdev 0.8.6","title":"rdev 0.8.6","text":"Added code coverage using codecov.io, new tests existing code Refactored sort_file()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-085","dir":"Changelog","previous_headings":"","what":"rdev 0.8.5","title":"rdev 0.8.5","text":"Critical bug fix to_document()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-084","dir":"Changelog","previous_headings":"","what":"rdev 0.8.4","title":"rdev 0.8.4","text":"Updated to_document() parse yaml front matter confirm source file valid R Notebook","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-083","dir":"Changelog","previous_headings":"","what":"rdev 0.8.3","title":"rdev 0.8.3","text":"Updated use_rdev_package() better conform rdev conventions (README.Rmd, .git/hooks/pre-commit), support committing error-free ci() immediately run","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-082","dir":"Changelog","previous_headings":"","what":"rdev 0.8.2","title":"rdev 0.8.2","text":"Updated build_rdev_site() build_analysis_site() abort missing topics pkgdown reference section","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-081","dir":"Changelog","previous_headings":"","what":"rdev 0.8.1","title":"rdev 0.8.1","text":"Added new_branch(): Create new feature branch, (optionally) bump version DESCRIPTION","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-080","dir":"Changelog","previous_headings":"","what":"rdev 0.8.0","title":"rdev 0.8.0","text":"Major update adding automation GitHub releases.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"release-automation-0-8-0","dir":"Changelog","previous_headings":"","what":"Release Automation","title":"rdev 0.8.0","text":"Added functions automate workflow staging creating releases GitHub: stage_release(): Open GitHub pull request new release NEWS.md get_release(): Extract release version release notes NEWS.md. Called stage_release() merge_release(). merge_release(): Merge staged pull request create new GitHub release","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"other-changes-0-8-0","dir":"Changelog","previous_headings":"","what":"Other Changes","title":"rdev 0.8.0","text":"Updated reorganized pkgdown reference page","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-073","dir":"Changelog","previous_headings":"","what":"rdev 0.7.3","title":"rdev 0.7.3","text":"Updated build_analysis_site() run devtools::build_readme() regenerate dynamic list notebooks (case new notebooks added) Important update renv 0.15.0 0.15.1","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-072","dir":"Changelog","previous_headings":"","what":"rdev 0.7.2","title":"rdev 0.7.2","text":"Added info dynamic notebook list notebook template Analysis Package Layout vignette","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-071","dir":"Changelog","previous_headings":"","what":"rdev 0.7.1","title":"rdev 0.7.1","text":"Updated use_analysis_package(): add dynamic notebook list README.Rmd template","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-070","dir":"Changelog","previous_headings":"","what":"rdev 0.7.0","title":"rdev 0.7.0","text":"Major update adding automation creating rdev R analysis packages.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"create-package-automation-0-7-0","dir":"Changelog","previous_headings":"","what":"‘Create Package’ Automation","title":"rdev 0.7.0","text":"Added functions automate steps creating new packages following rdev optionally analysis package conventions: create_github_repo(): Create new GitHub repository following rdev conventions active user’s account create basic package use_rdev_package(): Add rdev templates settings within active package. Normally invoked first setting package. Install templates using usethis::use_template(): use_rprofile(), use_lintr(), use_todo(), use_package_r() Add functionality use_analysis_package(): also install analysis package README.Rmd template Changed use_analysis_package() build_analysis_site() write _pkgdown.yml project root store GitHub make projects discoverable pkgdown. Updated setup-r install rdev dependencies site_library","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"other-changes-0-7-0","dir":"Changelog","previous_headings":"","what":"Other Changes","title":"rdev 0.7.0","text":"Added build_rdev_site(), wrapper pkgdown::build_site() optimized rdev workflow updates README.md performs clean build using pkgdown Added ‘Analysis Notebook’ R markdown template RStudio (File > New File > Rmarkdown > Template) Migrated ggplot2 themes/styles (theme_quo(), viridis_quo()) new package, jabenninghoff/jbplot","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-062","dir":"Changelog","previous_headings":"","what":"rdev 0.6.2","title":"rdev 0.6.2","text":"Add functionality use_analysis_package(): Create _base.yml pkgdown first URL package DESCRIPTION file.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-061","dir":"Changelog","previous_headings":"","what":"rdev 0.6.1","title":"rdev 0.6.1","text":"Critical bugfix use_analysis_package()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-060","dir":"Changelog","previous_headings":"","what":"rdev 0.6.0","title":"rdev 0.6.0","text":"Added use_analysis_package(): Add Analysis Package Layout current package","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-053","dir":"Changelog","previous_headings":"","what":"rdev 0.5.3","title":"rdev 0.5.3","text":"Add options theme_quo() disable panel.grid.major panel.grid.minor x y","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-052","dir":"Changelog","previous_headings":"","what":"rdev 0.5.2","title":"rdev 0.5.2","text":"Disable lintr default ci(), since normal workflow style_all(), lint_all(), ci() Documentation fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-051","dir":"Changelog","previous_headings":"","what":"rdev 0.5.1","title":"rdev 0.5.1","text":"Updated theme_quo(): set base theme ggplot2::theme_minimal() add parameters disabling grid lines","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-050","dir":"Changelog","previous_headings":"","what":"rdev 0.5.0","title":"rdev 0.5.0","text":"Added theme_quo(): ggplot2 theme based ggplot2::theme_bw() font Lato Added viridis_quo(): Sets default theme theme_quo() default color scales viridis maintenance","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-045","dir":"Changelog","previous_headings":"","what":"rdev 0.4.5","title":"rdev 0.4.5","text":"maintenance release, update GitHub Actions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-044","dir":"Changelog","previous_headings":"","what":"rdev 0.4.4","title":"rdev 0.4.4","text":"Update build_analysis_site() work pkgdown version 2","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-043","dir":"Changelog","previous_headings":"","what":"rdev 0.4.3","title":"rdev 0.4.3","text":"maintenance, update TODO steps manually setting Analysis Package","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-042","dir":"Changelog","previous_headings":"","what":"rdev 0.4.2","title":"rdev 0.4.2","text":"maintenance release, update README GitHub Actions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-041","dir":"Changelog","previous_headings":"","what":"rdev 0.4.1","title":"rdev 0.4.1","text":"bug fixes, maintenance","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-040","dir":"Changelog","previous_headings":"","what":"rdev 0.4.0","title":"rdev 0.4.0","text":"Add devtools::document() option ci(), turned default Add R Analysis Package layout definition, migrated rtraining Update ci() use style_all() lint_all() consistency Add import directory build_analysis_site() minor updates, improved tests, maintenance","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-031","dir":"Changelog","previous_headings":"","what":"rdev 0.3.1","title":"rdev 0.3.1","text":"maintenance release, updated R 4.1.0","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-030","dir":"Changelog","previous_headings":"","what":"rdev 0.3.0","title":"rdev 0.3.0","text":"build_analysis_site(), new function migrated rtraining: wrapper pkgdown::build_site() adds ‘Analysis’ menu containing rendered versions .Rmd files analysis/. still considered Experimental, due lack test coverage features implemented, work projects limited pkgdown customization. update also includes function convert notebooks html_document, to_document().","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-022","dir":"Changelog","previous_headings":"","what":"rdev 0.2.2","title":"rdev 0.2.2","text":"minor updates, maintenance","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-021","dir":"Changelog","previous_headings":"","what":"rdev 0.2.1","title":"rdev 0.2.1","text":"bug fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-020","dir":"Changelog","previous_headings":"","what":"rdev 0.2.0","title":"rdev 0.2.0","text":"installing rdev now automatically install preferred development tools ‘meta-package’ (like tidyverse), including: styler, lintr, rcmdcheck, renv, miniUI (RStudio Addin support), devtools, rmarkdown","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-012","dir":"Changelog","previous_headings":"","what":"rdev 0.1.2","title":"rdev 0.1.2","text":"minor updates package site (https://jabenninghoff.github.io/rdev/)","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-011","dir":"Changelog","previous_headings":"","what":"rdev 0.1.1","title":"rdev 0.1.1","text":"maintenance release","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"updates-0-1-1","dir":"Changelog","previous_headings":"","what":"Updates","title":"rdev 0.1.1","text":"ci(): updated match preferred GitHub workflow: use_github_action_check_standard() ---cran removed documentation updates functions (style, links)","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-010","dir":"Changelog","previous_headings":"","what":"rdev 0.1.0","title":"rdev 0.1.0","text":"Initial GitHub release","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"new-features-0-1-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"rdev 0.1.0","text":"./tools/setup-r: shell script install development packages site repository macOS + Homebrew check_renv(): convenience function runs renv status(), clean(), optionally update() (default). style_all(): style .R .Rmd files project using styler lint_all(): lint .R .Rmd files project using lintr sort_file(): sort file using R sort(), similar unix sort command sort_rbuildignore(): sort .Rbuildignore file using sort_file(), unsorted annoying ci(): run continuous integration tests locally: lint, R CMD check, style (default).","code":""}]
+[{"path":"https://jabenninghoff.github.io/rdev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2024 John Benninghoff 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":[]},{"path":"https://jabenninghoff.github.io/rdev/TODO.html","id":"content","dir":"","previous_headings":"","what":"Content","title":"TODO","text":"Add README.Rmd Update DESCRIPTION use description data README.Rmd Add ORCID Update ORCID details","code":""},{"path":"https://jabenninghoff.github.io/rdev/TODO.html","id":"package","dir":"","previous_headings":"","what":"Package","title":"TODO","text":"Write utility function sort .Rbuildignore Implement pkgdown Add links / update Rd formatting function documentation. Add dummy imports silence R CMD check note per tidyverse Migrate build_analysis_site() rdev Switch development version styler (1.3.2.9000) new release becomes available Validate lint_all works expected within ci Add ‘create package’ workflow example README, remove TODO section “Analysis package creation process” Move _pkgdown.yml repository root make projects discoverable pgkdown GitHub query Update README.Rmd template dynamically generate list notebooks analysis Automate release process Automate creation feature branches, including ‘Bump version’ using desc::desc_bump_version(\"dev\") Add check stage_release() look missing topics _pkgdown.yml reference section Update use_rdev_package() Handle .Rmd files already html_document section Move rmd_metadata() README-analysis.Rmd rdev package Add tests per comments R/ reading package book, documentation Update Roxygen comments reading package book, documentation, review merge duplicate Roxygen docs Write manual regression test script (notes R commands) vignette validate ‘Creating Packages’ ‘GitHub Releases’ Add messages, warnings build_analysis_site() report progress Add function spell check notebooks Automate branch protection Address issue https://github.com/r-lib/usethis/issues/1568, closed Add dplyr running use_analysis_package() Consider switching getOption(\"pkgType\") source per R options per R macOS FAQ, “CRAN build guaranteed compatible package binaries CRAN (Bioconductor).” Support creating repos organizations Consider incorporating GitHub description DESCRIPTION Create wrapper spelling includes notebooks package spell checking, WORDLIST Add spell_check_test_notebooks() function CI spellchecks notebooks Convert manual tests (Setup.Rmd) R Script can run within package created create_github_repo() Add function add missing (notebook) dependencies DESCRIPTION, see renv::dependencies() desc::desc_get_deps() Add check_renv() ci() stop renv::status() date Replace proof-docs urlchecker, support checking GitHub Pages docs directory using url_db_from_HTML_files (ask PR accepted) Move scripts tools inst/bin similar, per Stack Overflow R Packages Switch development versions styler (1.3.2.9000) lintr (2.0.1.9000) new release becomes available - needed address bugs current release versions, 1.3.2 2.0.1. Add trailing slash GitHub Pages URL Update lint_all() lint types, including .Rpres Add custom CSS files _site.yml analysis notebook templates control font size, described article, possibly using bs_theme(), since pkgdown customizes default using build_bslib() (issue exists unsupported Safari 14 Safari 15) Remove pkgdown/extra.css https://github.com/r-lib/pkgdown/issues/2377 accepted Establish default knitr options, including knitr::opts_chunk$set(fig.align = \"center\"), add analysis template, also review settings Advanced R Use Project Templates like vertical? Add CSS R Markdown Template instead assets/extra.css? Move shift-heading-level-: 1 _quarto.yml analysis/_metadata.yml, TODO.md renders properly Remove preset: bootstrap workaround pkgdown 2.0.8+ released (per https://github.com/r-lib/pkgdown/issues/2376) Replace dev = TRUE logic https://github.com/rstudio/renv/issues/1695 accepted Update errors messages reading Advanced R Conditions re-reading Tidyverse Style Guide Reduce number Imports, per R CMD check:","code":"> devtools::check() ... > checking package dependencies ... NOTE Imports includes 30 non-default packages. Importing from so many packages makes the package vulnerable to any of them becoming unavailable. Move as many as possible to Suggests and use conditionally."},{"path":"https://jabenninghoff.github.io/rdev/TODO.html","id":"github","dir":"","previous_headings":"","what":"GitHub","title":"TODO","text":"Use standard R CMD check Use lintr Faster CI checks Switch full R CMD check ? Update GitHub Actions r-lib examples Run test coverage Skip CI checks changes docs/ directory Add GitHub Action html/link checking using something like htmlproofer Autobuild docs/ like pkgdown ?","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"overview","dir":"Articles","previous_headings":"","what":"Overview","title":"Introduction to rdev","text":"rdev supports personal workflow, including creation traditional R packages R Analysis Packages (vignette(\"analysis-package-layout\")), enforcing consistency across packages, providing Continuous Integration/Continuous Delivery (CI/CD) automation. use tools rdev improve code quality, speed development R code, publish results analyses R Quarto Notebooks HTML make accessible non-R users.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"installation","dir":"Articles","previous_headings":"","what":"Installation","title":"Introduction to rdev","text":"current R development environment uses Homebrew, rig, RStudio, GitHub, collection R packages including rdev, Visual Studio Code, Vim.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"homebrew","dir":"Articles","previous_headings":"Installation","what":"Homebrew","title":"Introduction to rdev","text":"use Homebrew Bundle install software systems; basic macOS working environment published GitHub macos-env.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"installing-r","dir":"Articles","previous_headings":"Installation","what":"Installing R","title":"Introduction to rdev","text":"rig supports installation multiple versions official R binaries, use reproducibility. install R using rig, first install rig: install desired versions R. following installs R 3.6 4.4 ARM based macs (2024-09-03): Note : don’t use pak, rig installs default, yet fully supported renv. oldest version R install 3.6, since RStudio now requires R 3.6 newer (version 2024.04.00) Since ARM binary release R 3.6 (oldrel/5) R 4.0 (oldrel/4), install Intel binaries run Rosetta 2.","code":"brew tap r-lib/rig brew install --cask rig rig install oldrel/5 --without-pak --arch x86_64 rig install oldrel/4 --without-pak --arch x86_64 rig install oldrel/3 --without-pak rig install oldrel/2 --without-pak rig install oldrel/1 --without-pak rig install oldrel --without-pak rig install release --without-pak rig default release"},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"development-tools","dir":"Articles","previous_headings":"Installation","what":"Development Tools","title":"Introduction to rdev","text":"Well, obviously, use RStudio. RStudio leading IDE R development integrates many R packages, although sometimes falls short; use GitHub command line Git, occasionally Visual Studio Code (better support markdown) Vim (faster types edits). Posit developing next-generation IDE based Visual Studio Code, Positron. ’ve tried using Positron, ’ve found ’s still new replace RStudio development. RStudio, GitHub desktop client, Visual Studio Code easily installed using Homebrew: recommended change default settings .RData RStudio (Options > General > Basic > Workspace): Uncheck “Restore .Data workspace startup” Set “Save workspace .Data exit” “Never” Vim installed default macOS Unix-like systems.","code":"brew install --cask rstudio brew install --cask github brew install --cask visual-studio-code"},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"packages","dir":"Articles","previous_headings":"Installation","what":"Packages","title":"Introduction to rdev","text":"Managing packages environments challenge modern languages. Thankfully R doesn’t level challenge python, even ruby, managing packages available within project best practice. use renv purpose, use renv install manage packages projects. setup-r script rdev installs base set packages needed run rdev R User Library. streamlined version script included . chown command needed allow updating base packages using RStudio Packages “Update” function. generally update packages RStudio projects open starting development, update packages projects using renv::update(). ’re installing (development) versions packages GitHub, recommended set personal access token using usethis::create_github_token() adding .Renviron GITHUB_PAT= using usethis::edit_r_environ().","code":"# fix rig permissions sudo chown -R \"$(whoami)\":admin /Library/Frameworks/R.framework/Versions/*/Resources/library RVERSION=\"$(Rscript -e 'cat(as.character(getRversion()[1,1:2]))')\" USERLIB=\"$HOME/Library/R/$(uname -m)/${RVERSION}/library\" DEVPKG='c(\"renv\", \"styler\", \"lintr\", \"miniUI\", \"languageserver\", \"rmarkdown\", \"devtools\", \"available\")' GITPKG='c(\"jabenninghoff/rdev\")' if [ ! -d \"${USERLIB}\" ] then mkdir -p \"${USERLIB}\" fi echo \"install.packages(${DEVPKG}, repos=\\\"https://cloud.r-project.org\\\", lib=\\\"${USERLIB}\\\")\" | R --no-save echo \"remotes::install_github(${GITPKG}, lib=\\\"${USERLIB}\\\")\" | R --no-save"},{"path":"https://jabenninghoff.github.io/rdev/articles/rdev.html","id":"further-reading","dir":"Articles","previous_headings":"Installation","what":"Further Reading","title":"Introduction to rdev","text":"workflow heavily influenced DevOps movement research DevOps Research Assessment (DORA) team Google started Dr. Nicole Forsgren. research shows technical non-technical capabilities improve outcomes. functions included rdev support many technical capabilities, including: Code maintainability Continuous delivery Continuous integration Deployment automation Shifting left security Test automation Trunk-based development Version control outline SIRAcon 2022 talk, “Making R Work (Automation)” available GitHub siracon2022.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"rdev-conventions","dir":"Articles","previous_headings":"","what":"rdev conventions","title":"Style Guide","text":"rdev uses mix Google tidyverse conventions.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"naming-conventions","dir":"Articles","previous_headings":"rdev conventions","what":"Naming conventions","title":"Style Guide","text":"rdev follows tidyverse naming convention snake_case.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"right-hand-assignment","dir":"Articles","previous_headings":"rdev conventions","what":"Right-hand assignment","title":"Style Guide","text":"rdev follows Google’s style guide, use right-hand assignment.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"returns","dir":"Articles","previous_headings":"rdev conventions","what":"Returns","title":"Style Guide","text":"rdev typically uses implicit returns unless needed flow control construct specific return structure.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"qualifying-namespaces","dir":"Articles","previous_headings":"rdev conventions","what":"Qualifying namespaces","title":"Style Guide","text":"Use @import @importFrom discouraged, instead using :: functions defined R/. exception infix functions (%name%), always imported, using roxygen @importFrom. Within R Quarto Notebooks, use library() encouraged readability.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"package-level-documentation","dir":"Articles","previous_headings":"rdev conventions","what":"Package-level documentation","title":"Style Guide","text":"rdev package documentation lives R/package.R. Additionally, use base R encouraged within functions defined R/ (control dependencies), tidyverse R encouraged within notebooks readability. R Markdown documents generally wrap width code, exceptions R Notebook ‘description line’ (first non-blank line body), long hyperlinks.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"styler","dir":"Articles","previous_headings":"","what":"styler","title":"Style Guide","text":"rdev package implements styler using styler defaults, permanent caching enabled (options(styler.cache_root = \"styler-perm\")). style_all() function applies tidyverse style R Quarto files (R, Rprofile, Rmd, Rnw, qmd) package directory structure.","code":""},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"lintr","dir":"Articles","previous_headings":"","what":"lintr","title":"Style Guide","text":"lint_all() function lints R Quarto files (R, Rmd, qmd, Rnw, Rhtml, Rpres, Rrst, Rtex, Rtxt) lintr using opinionated configuration (.lintr): settings deliberately chosen meet specific goals:","code":"linters: linters_with_tags( tags = NULL, extraction_operator_linter = NULL, implicit_integer_linter = NULL, line_length_linter(100), missing_package_linter = NULL, namespace_linter = NULL, nonportable_path_linter = NULL, paste_linter(allow_file_path = \"always\"), todo_comment_linter = NULL, undesirable_function_linter( within(all_undesirable_functions, rm(ifelse, library, require, structure)) ), undesirable_operator_linter(all_undesirable_operators), unnecessary_concatenation_linter(allow_single_expression = FALSE), unused_import_linter( except_packages = c(\"bit64\", \"data.table\", \"tidyverse\", pkgload::pkg_name(\".\")) ) )"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"use-all-linters","dir":"Articles","previous_headings":"lintr","what":"Use all linters","title":"Style Guide","text":"selects linters, including new Google linters. selecting linters, just defaults, forces evaluation new linters added lintr. Specific linters disabled configured per rdev style.","code":"linters: linters_with_tags( tags = NULL,"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"allow-extraction-operator","dir":"Articles","previous_headings":"lintr","what":"Allow $ extraction operator","title":"Style Guide","text":"extraction operator linter enforces use [[ $. Since $ intended interactive use supports partial mapping, safer use [[. However, use $ common practice, including within lintr code, leads readable code.","code":"extraction_operator_linter = NULL,"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"allow-implicit-integers","dir":"Articles","previous_headings":"lintr","what":"Allow implicit integers","title":"Style Guide","text":"implicit integer linter checks integers explicitly typed using form 1L. , safer, implicit integers common practice, including output dput():","code":"implicit_integer_linter = NULL, dput(character(0L)) #> character(0)"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"set-line-length","dir":"Articles","previous_headings":"lintr","what":"Set line length","title":"Style Guide","text":"line length 100 reasonable width working RStudio IDE laptop.","code":"line_length_linter(100),"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"use-renv-for-missing-packages","dir":"Articles","previous_headings":"lintr","what":"Use renv for missing packages","title":"Style Guide","text":"missing package linter namespace linter check packages referenced code installed. rdev uses renv manage packages, better job detecting missing packages, including complaining current package (\".\") installed.","code":"missing_package_linter = NULL, namespace_linter = NULL,"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"allow-non-portable-paths","dir":"Articles","previous_headings":"lintr","what":"Allow non-portable paths","title":"Style Guide","text":"non-portable path linter generates many false positives, including calls fs, essentially makes UNIX-style paths portable across operating systems. Similarly, allow_file_path default option \"double_slash\" generates false positives used fs.","code":"nonportable_path_linter = NULL, paste_linter(allow_file_path = \"always\"),"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"allow-todo-comments","dir":"Articles","previous_headings":"lintr","what":"Allow TODO comments","title":"Style Guide","text":"rdev conventions encourage use # TODO: comments convenient way identifying needed planned updates inline.","code":"todo_comment_linter = NULL,"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"disallow-almost-all-undesirable-functions-and-operators","dir":"Articles","previous_headings":"lintr","what":"Disallow almost all undesirable functions and operators","title":"Style Guide","text":"Enable undesirable functions operators, just defaults, except ifelse() succinct /else block, library(), require(), structure(). Use require() within .Rprofile library() within R Markdown documents appropriate common practice, although neither used within package code. structure() useful comparing test results values generated dput().","code":"undesirable_function_linter( within(all_undesirable_functions, rm(ifelse, library, require, structure)) ), undesirable_operator_linter(all_undesirable_operators),"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"enforce-strict-unnecessary-concatenation","dir":"Articles","previous_headings":"lintr","what":"Enforce strict unnecessary concatenation","title":"Style Guide","text":"Enforce stricter version unnecessary concatenation linter.","code":"unnecessary_concatenation_linter(allow_single_expression = FALSE),"},{"path":"https://jabenninghoff.github.io/rdev/articles/style-guide.html","id":"verify-imported-packages-are-used","dir":"Articles","previous_headings":"lintr","what":"Verify imported packages are used","title":"Style Guide","text":"Verify imported packages used, except packages attached side effects, current package (support package development).","code":"unused_import_linter( except_packages = c(\"bit64\", \"data.table\", \"tidyverse\", pkgload::pkg_name(\".\")) ) )"},{"path":"https://jabenninghoff.github.io/rdev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"John Benninghoff. Author, maintainer.","code":""},{"path":"https://jabenninghoff.github.io/rdev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Benninghoff J (2024). rdev: R Development Tools. R package version 1.11.5, https://github.com/jabenninghoff/rdev, https://jabenninghoff.github.io/rdev/.","code":"@Manual{, title = {rdev: R Development Tools}, author = {John Benninghoff}, year = {2024}, note = {R package version 1.11.5, https://github.com/jabenninghoff/rdev}, url = {https://jabenninghoff.github.io/rdev/}, }"},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"overview","dir":"","previous_headings":"","what":"Overview","title":"R Development Tools","text":"R Development Tools: opinionated collection development tools, packages, utilities. Feel free use /fork project!","code":""},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"R Development Tools","text":"can install development version rdev GitHub : using renv:","code":"# install.packages(\"remotes\") remotes::install_github(\"jabenninghoff/rdev\") # install.packages(\"renv\") renv::install(\"jabenninghoff/rdev\")"},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"development","dir":"","previous_headings":"","what":"Development","title":"R Development Tools","text":"Changelog: See “Changelog” NEWS.md. Planned: TODO","code":""},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"creating-packages","dir":"","previous_headings":"","what":"Creating Packages","title":"R Development Tools","text":"rdev supports creation new R packages following rdev conventions well new R Analysis packages. typical setup workflow (per ?quickstart) : Use available::available() check package name project open, run create_github_repo() initialize GitHub R repository Without committing git, run init() newly created project Manually update Title Description fields DESCRIPTION file without committing Run setup_analysis() setup_rdev() configure package analysis package rdev package respectively. Update TODO.md, NEWS.md, README.Rmd, DESCRIPTION needed Re-run check_renv(), ci() validate package Commit git begin development","code":""},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"github-releases","dir":"","previous_headings":"","what":"GitHub Releases","title":"R Development Tools","text":"rdev automates workflow creating GitHub releases along updating GitHub pages either standard R packages R analysis packages, using release notes format NEWS.md. typical development workflow : Bump version create new feature branch new_branch() Write things Update release notes new version NEWS.md, following conventions described get_release() Finalize release merge changes git Run stage_release() create new pull request GitHub using details derived NEWS.md, including updating README GitHub pages pull request reviewed passes required status checks, accept staged release merge_release(), merges pull request, cleans branches, publishes new GitHub release Feature branches can merged without starting new release; stage_release() just requires everything committed, including new release notes NEWS.md running. ready release, stage_release() use existing branch feature branch, create new release branch default.","code":""},{"path":"https://jabenninghoff.github.io/rdev/index.html","id":"workflow","dir":"","previous_headings":"","what":"Workflow","title":"R Development Tools","text":"workflow, typically check renv start: also ci() function run continuous integration tests locally:","code":"library(rdev) check_renv() #> renv::status(dev = TRUE) #> No issues found -- the project is in a consistent state. #> #> renv::clean() #> - No stale package locks were found. #> - No temporary directories were found in the project library. #> - The project has been cleaned. ci() #> renv::status(dev = TRUE) #> No issues found -- the project is in a consistent state. #> #> missing_deps() #> Finding R package dependencies ... Done! #> renv::dependencies() not in DESCRIPTION: #> #> pkgdown::check_pkgdown() #> ✔ No problems found. #> #> style_all() #> Styling 67 files: #> .Rprofile ✔ #> README.Rmd ✔ #> inst/rmarkdown/templates/analysis/skeleton/skeleton.Rmd ✔ #> inst/templates/analysis.qmd ✔ #> inst/templates/changelog.qmd ✔ #> inst/templates/index.qmd ✔ #> inst/templates/package.R ✔ #> inst/templates/README-analysis.Rmd ✔ #> inst/templates/README-rdev.Rmd ✔ #> inst/templates/spelling.R ✔ #> inst/templates/test-spelling.R ✔ #> R/build.R ✔ #> R/ci.R ✔ #> R/helpers.R ✔ #> R/init.R ✔ #> R/package.R ✔ #> R/release.R ✔ #> R/setup.R ✔ #> R/to_document.R ✔ #> R/urlchecker.R ✔ #> R/utils.R ✔ #> tests/spelling.R ✔ #> tests/testthat.R ✔ #> tests/manual/setup.Rmd ✔ #> tests/manual/test-new-repo-1.R ✔ #> tests/manual/test-new-repo-2.R ✔ #> tests/manual/test-new-repo-3-analysis.R ✔ #> tests/manual/test-new-repo-3-package.R ✔ #> tests/testthat/test-build.R ✔ #> tests/testthat/test-ci.R ✔ #> tests/testthat/test-helpers.R ✔ #> tests/testthat/test-init.R ✔ #> tests/testthat/test-inst.R ✔ #> tests/testthat/test-release.R ✔ #> tests/testthat/test-setup.R ✔ #> tests/testthat/test-spelling.R ✔ #> tests/testthat/test-to_document.R ✔ #> tests/testthat/test-utils.R ✔ #> tests/testthat/test-ci/test-revealjs.qmd ✔ #> tests/testthat/test-ci/test.Rprofile ✔ #> tests/testthat/test-ci/testcode_1.R ✔ #> tests/testthat/test-ci/testcode_2.R ✔ #> tests/testthat/test-ci/testcode.qmd ✔ #> tests/testthat/test-ci/testcode.Rmd ✔ #> tests/testthat/test-ci/testcode.Rnw ✔ #> tests/testthat/test-ci/packrat/test.R ✔ #> tests/testthat/test-ci/R/RcppExports.R ✔ #> tests/testthat/test-ci/renv/test.R ✔ #> tests/testthat/test-to_document/document.Rmd ✔ #> tests/testthat/test-to_document/docx.qmd ✔ #> tests/testthat/test-to_document/extra-spaces.Rmd ✔ #> tests/testthat/test-to_document/minimal-document.Rmd ✔ #> tests/testthat/test-to_document/minimal-docx.qmd ✔ #> tests/testthat/test-to_document/minimal.qmd ✔ #> tests/testthat/test-to_document/minimal.Rmd ✔ #> tests/testthat/test-to_document/multiple.Rmd ✔ #> tests/testthat/test-to_document/no-format.qmd ✔ #> tests/testthat/test-to_document/no-front-matter.Rmd ✔ #> tests/testthat/test-to_document/no-output.Rmd ✔ #> tests/testthat/test-to_document/no-yaml.qmd ✔ #> tests/testthat/test-to_document/no-yaml.Rmd ✔ #> tests/testthat/test-to_document/valid.qmd ✔ #> tests/testthat/test-to_document/valid.Rmd ✔ #> tests/testthat/test-to_document/with-code.Rmd ✔ #> vignettes/analysis-package-layout.Rmd ✔ #> vignettes/rdev.Rmd ✔ #> vignettes/style-guide.Rmd ✔ #> ─────────────────────────────────────────────────────── #> Status Count Legend #> ✔ 67 File unchanged. #> ℹ 0 File changed. #> ✖ 0 Styling threw an error. #> ─────────────────────────────────────────────────────── #> #> lint_all() #> #> devtools::document() #> ℹ Updating rdev documentation #> ℹ Loading rdev #> #> desc::desc_normalize() #> #> extra_deps() #> Finding R package dependencies ... Done! #> desc::desc_get_deps() not found by renv: #> # A tibble: 3 × 3 #> type package version #> #> 1 Suggests covr * #> 2 Suggests diffviewer * #> 3 Suggests DT * #> #> url_check() #> # A tibble: 1 × 9 #> URL From Status Message New CRAN Spaces R root #> #> 1 https://code.visualstudio… 500 Intern… \"\" \"\" \"\" \"\" /Use… #> html_url_check() #> # A tibble: 3 × 9 #> URL From Status Message New CRAN Spaces R root #> #> 1 http://covr.r-lib.org/ref… 200 OK \"htt… \"\" \"\" \"\" /Use… #> 2 http://r-lib.github.io/rc… 200 OK \"htt… \"\" \"\" \"\" /Use… #> 3 https://code.visualstudio… 500 Intern… \"\" \"\" \"\" \"\" /Use… #> #> Setting env vars: NOT_CRAN=\"true\", CI=\"true\" #> rcmdcheck::rcmdcheck(args = \"--no-manual\", error_on = \"warning\") #> ── R CMD build ───────────────────────────────────────────────────────────────── #> * checking for file ‘.../DESCRIPTION’ ... OK #> * preparing ‘rdev’: #> * checking DESCRIPTION meta-information ... OK #> * installing the package to build vignettes #> * creating vignettes ... OK #> * checking for LF line-endings in source and make files and shell scripts #> * checking for empty or unneeded directories #> * building ‘rdev_1.11.5.tar.gz’ #> #> ── R CMD check ───────────────────────────────────────────────────────────────── #> * using log directory ‘/private/var/folders/vn/cw5f9gws42v9m8mdsds_zbl00000gp/T/RtmpvN7fYo/file780b4c4de0b/rdev.Rcheck’ #> * using R version 4.4.1 (2024-06-14) #> * using platform: aarch64-apple-darwin20 #> * R was compiled by #> Apple clang version 14.0.0 (clang-1400.0.29.202) #> GNU Fortran (GCC) 12.2.0 #> * running under: macOS Sonoma 14.7 #> * using session charset: UTF-8 #> * using option ‘--no-manual’ #> * checking for file ‘rdev/DESCRIPTION’ ... OK #> * this is package ‘rdev’ version ‘1.11.5’ #> * package encoding: UTF-8 #> * checking package namespace information ... OK #> * checking package dependencies ... OK #> * checking if this is a source package ... OK #> * checking if there is a namespace ... OK #> * checking for executable files ... OK #> * checking for hidden files and directories ... OK #> * checking for portable file names ... OK #> * checking for sufficient/correct file permissions ... OK #> * checking whether package ‘rdev’ can be installed ... OK #> * checking installed package size ... OK #> * checking package directory ... OK #> * checking ‘build’ directory ... OK #> * checking DESCRIPTION meta-information ... OK #> * checking top-level files ... OK #> * checking for left-over files ... OK #> * checking index information ... OK #> * checking package subdirectories ... OK #> * checking code files for non-ASCII characters ... OK #> * checking R files for syntax errors ... OK #> * checking whether the package can be loaded ... OK #> * checking whether the package can be loaded with stated dependencies ... OK #> * checking whether the package can be unloaded cleanly ... OK #> * checking whether the namespace can be loaded with stated dependencies ... OK #> * checking whether the namespace can be unloaded cleanly ... OK #> * checking loading without being on the library search path ... OK #> * checking dependencies in R code ... OK #> * checking S3 generic/method consistency ... OK #> * checking replacement functions ... OK #> * checking foreign function calls ... OK #> * checking R code for possible problems ... OK #> * checking Rd files ... OK #> * checking Rd metadata ... OK #> * checking Rd cross-references ... OK #> * checking for missing documentation entries ... OK #> * checking for code/documentation mismatches ... OK #> * checking Rd \\usage sections ... OK #> * checking Rd contents ... OK #> * checking for unstated dependencies in examples ... OK #> * checking installed files from ‘inst/doc’ ... OK #> * checking files in ‘vignettes’ ... OK #> * checking examples ... OK #> * checking for unstated dependencies in ‘tests’ ... OK #> * checking tests ... #> Running ‘spelling.R’ #> Comparing ‘spelling.Rout’ to ‘spelling.Rout.save’ ... OK #> Running ‘testthat.R’ #> OK #> * checking for unstated dependencies in vignettes ... OK #> * checking package vignettes ... OK #> * checking re-building of vignette outputs ... OK #> * DONE #> Status: OK #> ── R CMD check results ──────────────────────────────────────── rdev 1.11.5 ──── #> Duration: 34.3s #> #> 0 errors ✔ | 0 warnings ✔ | 0 notes ✔"},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":null,"dir":"Reference","previous_headings":"","what":"Build Analysis Site — build_analysis_site","title":"Build Analysis Site — build_analysis_site","text":"build_analysis_site() wrapper pkgdown::build_site_github_pages() adds 'Analysis' menu containing rendered versions .Rmd files analysis/.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build Analysis Site — build_analysis_site","text":"","code":"build_analysis_site(pkg = \".\", ...)"},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build Analysis Site — build_analysis_site","text":"pkg Path package. Currently, pkg = \".\" supported. ... additional arguments passed pkgdown::build_site_github_pages() (implemented)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Build Analysis Site — build_analysis_site","text":"rmarkdown _site.yml yaml, invisibly","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Build Analysis Site — build_analysis_site","text":"run, build_analysis_site(): Reads base pkgdown settings pkgdown/_base.yml Writes base settings _pkgdown.yml Creates template using pkgdown::template_navbar() inserts analysis menu links html versions .Rmd file analysis/ Writes template _pkgdown.yml Updates README.md running devtools::build_readme() (README.Rmd exists) update list notebooks Runs pkgdown::build_site_github_pages() install = TRUE new_process = TRUE Creates _site.yml file based final _pkgdown.yml clones pkgdown navbar temporary build directory Copies following analysis/ build directory: *.Rmd, assets/, data/, import/, rendered/ Changes *.Rmd html_notebook html_document using to_document() Builds site using rmarkdown::render_site() using modified html_document output settings render files look feel html_notebook Moves rendered files docs/: *.html, assets/, rendered/, without overwriting build_analysis_site() fail error files analysis/*.Rmd, pkgdown/_base.yml exist.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"continuous-integration","dir":"Reference","previous_headings":"","what":"Continuous Integration","title":"Build Analysis Site — build_analysis_site","text":"build_rdev_site() build_analysis_site() meant used part CI/CD workflow, temporarily set environment variable CI == \"TRUE\" build fail non-internal topics included reference index page per pkgdown::build_reference().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_analysis_site.html","id":"supported-file-types","dir":"Reference","previous_headings":"","what":"Supported File Types","title":"Build Analysis Site — build_analysis_site","text":"build_quarto_site() supports R Markdown (.Rmd) Quarto (.qmd) notebooks analysis directory interchangeably, build_analysis_site() supports .Rmd files .","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":null,"dir":"Reference","previous_headings":"","what":"Build Quarto Site — build_quarto_site","title":"Build Quarto Site — build_quarto_site","text":"build_quarto_site() wrapper quarto::quarto_render() also updates README.md optionally deletes Quarto _freeze directory fully re-render site.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build Quarto Site — build_quarto_site","text":"","code":"build_quarto_site(input = NULL, as_job = FALSE, unfreeze = FALSE, ...)"},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build Quarto Site — build_quarto_site","text":"input input file project directory rendered (defaults rendering project current working directory). as_job Render RStudio background job. Default \"auto\", render individual documents normally projects background jobs. Use quarto.render_as_job R option control default globally. unfreeze TRUE, delete Quarto _freeze directory fully re-render site. ... Arguments passed quarto::quarto_render().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Build Quarto Site — build_quarto_site","text":"run, build_quarto_site() calls: devtools::build_readme() unfreeze() (unfreeze = TRUE) quarto::quarto_render()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_quarto_site.html","id":"supported-file-types","dir":"Reference","previous_headings":"","what":"Supported File Types","title":"Build Quarto Site — build_quarto_site","text":"build_quarto_site() supports R Markdown (.Rmd) Quarto (.qmd) notebooks analysis directory interchangeably, build_analysis_site() supports .Rmd files .","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":null,"dir":"Reference","previous_headings":"","what":"Build rdev Site — build_rdev_site","title":"Build rdev Site — build_rdev_site","text":"build_rdev_site() wrapper pkgdown::build_site_github_pages() optimized rdev workflow updates README.md performs clean GitHub pages build using pkgdown.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Build rdev Site — build_rdev_site","text":"","code":"build_rdev_site(pkg = \".\", ...)"},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Build rdev Site — build_rdev_site","text":"pkg Path package. Currently, pkg = \".\" supported. ... additional arguments passed pkgdown::build_site_github_pages() (implemented)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Build rdev Site — build_rdev_site","text":"run, build_rdev_site() calls: devtools::build_readme() pkgdown::build_site_github_pages() install = TRUE new_process = TRUE","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/build_rdev_site.html","id":"continuous-integration","dir":"Reference","previous_headings":"","what":"Continuous Integration","title":"Build rdev Site — build_rdev_site","text":"build_rdev_site() build_analysis_site() meant used part CI/CD workflow, temporarily set environment variable CI == \"TRUE\" build fail non-internal topics included reference index page per pkgdown::build_reference().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/check_renv.html","id":null,"dir":"Reference","previous_headings":"","what":"Check renv — check_renv","title":"Check renv — check_renv","text":"Runs renv status(dev = TRUE), clean(), optionally update()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/check_renv.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check renv — check_renv","text":"","code":"check_renv(update = rlang::is_interactive())"},{"path":"https://jabenninghoff.github.io/rdev/reference/check_renv.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check renv — check_renv","text":"update run renv::update()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/check_renv.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check renv — check_renv","text":"","code":"if (FALSE) { # \\dontrun{ check_renv() check_renv(update = FALSE) } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":null,"dir":"Reference","previous_headings":"","what":"Local CI — ci","title":"Local CI — ci","text":"Run continuous integration tests locally.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Local CI — ci","text":"","code":"ci( renv = TRUE, missing = TRUE, pkgdown = TRUE, styler = NULL, lintr = TRUE, document = TRUE, normalize = TRUE, extra = TRUE, urls = TRUE, rcmdcheck = TRUE )"},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Local CI — ci","text":"renv check renv::status(dev = TRUE) missing run missing_deps() pkgdown check pkgdown::check_pkgdown() _pkgdown.yml exists styler style files using style_all(), see details lintr lint files using lint_all() document run devtools::document() normalize run desc::desc_normalize() extra run extra_deps() urls validate URLs url_check() html_url_check() rcmdcheck run R CMD check using: rcmdcheck::rcmdcheck(args = \"–-manual\", error_on = \"warning\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Local CI — ci","text":"renv::status(dev = TRUE) synchronized, ci() stop. missing_deps() returns missing dependencies, ci() stop. pkgdown::check_pkgdown() halt ci() error _pkgdown.yml invalid. styler set NULL (default), style_all() run uncommitted changes git. Setting value TRUE FALSE overrides check. lint_all() finds lints, ci() stop open RStudio markers pane. Output missing, extra, urls printed tibble improved readability console.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/ci.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Local CI — ci","text":"","code":"if (FALSE) { # \\dontrun{ ci() ci(styler = TRUE) ci(styler = FALSE, rcmdcheck = FALSE) } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":null,"dir":"Reference","previous_headings":"","what":"Create rdev GitHub repository — create_github_repo","title":"Create rdev GitHub repository — create_github_repo","text":"Create, configure, clone, open new GitHub R package repository following rdev conventions.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create rdev GitHub repository — create_github_repo","text":"","code":"create_github_repo( repo_name, repo_desc = \"\", private = FALSE, org = NULL, host = getOption(\"rdev.host\") )"},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create rdev GitHub repository — create_github_repo","text":"repo_name name GitHub repository create repo_desc description GitHub repository create private TRUE, creates private repository. org organization create repository . NULL, create repository active user's account. host GitHub host target, passed .api_url argument gh::gh(). unspecified, gh defaults \"https://api.github.com\", although gh's default can customised setting GITHUB_API_URL environment variable. hypothetical GitHub Enterprise instance, either \"https://github.acme.com/api/v3\" \"https://github.acme.com\" acceptable.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create rdev GitHub repository — create_github_repo","text":"return value gh::gh() creating repository, invisibly","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create rdev GitHub repository — create_github_repo","text":"run, create_github_repo(): Creates new GitHub repository using gh::gh() license template get_license() Activates Dependabot alerts per getOption(\"rdev.dependabot\", default = TRUE) Activates Dependabot security updates per getOption(\"rdev.dependabot\", default = TRUE) Adds branch protection default branch (private FALSE) Clones repository locally usethis::create_from_github() Creates basic package using usethis::create_package() running interactively macOS, repository automatically opened RStudio, GitHub Desktop, default browser","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"github-actions","dir":"Reference","previous_headings":"","what":"GitHub Actions","title":"Create rdev GitHub repository — create_github_repo","text":"GitHub Actions can disabled setting rdev.github.actions FALSE: options(rdev.github.actions = FALSE)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/create_github_repo.html","id":"host","dir":"Reference","previous_headings":"","what":"Host","title":"Create rdev GitHub repository — create_github_repo","text":"Set rdev.host option using GitHub Enterprise server: options(rdev.host = \"https://github.example.com/api/v3\")","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":null,"dir":"Reference","previous_headings":"","what":"Check dependencies — missing_deps","title":"Check dependencies — missing_deps","text":"Check dependencies DESCRIPTION.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check dependencies — missing_deps","text":"","code":"missing_deps(exclude_base = TRUE) extra_deps()"},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check dependencies — missing_deps","text":"exclude_base exclude packages installed R missing dependencies","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check dependencies — missing_deps","text":"data.frame either renv::dependencies() desc::desc_get_deps().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/deps_check.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Check dependencies — missing_deps","text":"missing_deps() reports renv::dependencies() DESCRIPTION. extra_deps() reports desc::desc_get_deps() found renv. current package (pkgload::pkg_name(\".\")) renv (renv.lock ) automatically removed renv::dependencies(), along 'base' R packages exclude_base TRUE (base, compiler, datasets, grDevices, graphics, grid, methods, parallel, splines, stats, stats4, tcltk, tools, utils).","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_license.html","id":null,"dir":"Reference","previous_headings":"","what":"Get license option — get_license","title":"Get license option — get_license","text":"Retrieve validate rdev.license option.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_license.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get license option — get_license","text":"","code":"get_license()"},{"path":"https://jabenninghoff.github.io/rdev/reference/get_license.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get license option — get_license","text":"license string, one c(\"mit\", \"gpl\", \"lgpl\", \"proprietary\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_license.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get license option — get_license","text":"rdev.license must one c(\"mit\", \"gpl\", \"lgpl\", \"proprietary\"), defaults \"mit\". rdev.license \"proprietary\", rdev.license.copyright (name copyright holder) must also set.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":null,"dir":"Reference","previous_headings":"","what":"Get release details — get_release","title":"Get release details — get_release","text":"Extract release version release notes NEWS.md.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get release details — get_release","text":"","code":"get_release(pkg = \".\", filename = \"NEWS.md\")"},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get release details — get_release","text":"pkg path package. Currently, pkg = \".\" supported. filename name file containing release notes, defaults NEWS.md.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get release details — get_release","text":"list containing package, version release notes first release contained NEWS.md","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/get_release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get release details — get_release","text":"get_release() assumes NEWS.md contains markdown release notes, release header format: \"# \" followed release notes, expects first line NEWS.md release header.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/html_url_check.html","id":null,"dir":"Reference","previous_headings":"","what":"Check URLs in HTML files — html_url_check","title":"Check URLs in HTML files — html_url_check","text":"Runs urlchecker::url_check() database created using url_db_from_HTML_files function tools package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/html_url_check.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check URLs in HTML files — html_url_check","text":"","code":"html_url_check( path = \"docs\", parallel = TRUE, pool = curl::new_pool(), progress = TRUE )"},{"path":"https://jabenninghoff.github.io/rdev/reference/html_url_check.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check URLs in HTML files — html_url_check","text":"path Path directory HTML files parallel TRUE, check URLs parallel pool multi handle created curl::new_pool(). NULL use global pool. progress Whether show progress bar parallel checks","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/html_url_check.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check URLs in HTML files — html_url_check","text":"url_checker_db object (invisibly). check_url_db object added class custom print method.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/init.html","id":null,"dir":"Reference","previous_headings":"","what":"Initialize rdev package — init","title":"Initialize rdev package — init","text":"Initialize rdev package within newly created create_github_repo() project creating new git branch, committing changes, running use_rdev_package().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/init.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Initialize rdev package — init","text":"","code":"init()"},{"path":"https://jabenninghoff.github.io/rdev/reference/init.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Initialize rdev package — init","text":"init() stop rlang::is_interactive() FALSE. running init(), update Title Description fields DESCRIPTION file without committing run either setup_analysis() setup_rdev() per quickstart.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":null,"dir":"Reference","previous_headings":"","what":"Lint all files — lint_all","title":"Lint all files — lint_all","text":"Lint files project. Implemented wrapper lintr::lint_dir().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Lint all files — lint_all","text":"","code":"lint_all( pattern = \"(?i)[.](r|rmd|qmd|rnw|rhtml|rpres|rrst|rtex|rtxt)$\", exclusions = list(\"renv\", \"packrat\", \"R/RcppExports.R\"), ... )"},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Lint all files — lint_all","text":"pattern regex pattern files, default take files extensions .R, .Rmd, .qmd, .Rnw, .Rhtml, .Rpres, .Rrst, .Rtex, .Rtxt, ignoring case. exclusions exclusions exclude(), relative package path. ... Arguments passed lintr::lint_dir parse_settings Logical, default TRUE. Whether try parse settings; otherwise, default_settings() used. path base directory project (lint_dir()) package (lint_package()). relative_path TRUE, file paths printed using path relative base directory. FALSE, use full absolute path. show_progress Logical controlling whether show linting progress simple text progress bar via utils::txtProgressBar(). default behavior show progress interactive() sessions running testthat suite.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Lint all files — lint_all","text":"list lint objects.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/lint_all.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Lint all files — lint_all","text":"","code":"if (FALSE) { # \\dontrun{ lint_all() lint_all(\"analysis\") } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":null,"dir":"Reference","previous_headings":"","what":"Temporary package — local_temppkg","title":"Temporary package — local_temppkg","text":"Temporarily create rdev R analysis package, automatically removed afterwards.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Temporary package — local_temppkg","text":"","code":"local_temppkg(dir = fs::file_temp(), type = \"usethis\", env = parent.frame())"},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Temporary package — local_temppkg","text":"dir Path package directory, created necessary, defaults fs::file_temp(). type type package create, one \"usethis\" - usethis::create_package(), \"rdev\" - use_rdev_package(), \"analysis\" - use_analysis_package(use_quarto = FALSE), \"quarto\" - use_analysis_package(use_quarto = TRUE). env Environment passed withr::defer(), defaults parent.frame().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Temporary package — local_temppkg","text":"Path temporary package directory.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Temporary package — local_temppkg","text":"Used internally testing rdev automation. Based usethis case study testthat.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/local_temppkg.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Temporary package — local_temppkg","text":"","code":"if (FALSE) { # \\dontrun{ test_that(\"local_temppkg creates a directory\", { dir <- usethis::ui_silence(local_temppkg()) expect_true(fs::dir_exists(dir)) }) } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":null,"dir":"Reference","previous_headings":"","what":"Merge staged GitHub release — merge_release","title":"Merge staged GitHub release — merge_release","text":"Merge pull request staged stage_release() create new release GitHub.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Merge staged GitHub release — merge_release","text":"","code":"merge_release(pkg = \".\", filename = \"NEWS.md\", host = getOption(\"rdev.host\"))"},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Merge staged GitHub release — merge_release","text":"pkg path package. Currently, pkg = \".\" supported. filename name file containing release notes, defaults NEWS.md. host GitHub host target, passed .api_url argument gh::gh(). unspecified, gh defaults \"https://api.github.com\", although gh's default can customised setting GITHUB_API_URL environment variable. hypothetical GitHub Enterprise instance, either \"https://github.acme.com/api/v3\" \"https://github.acme.com\" acceptable.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Merge staged GitHub release — merge_release","text":"list containing results pull request merge GitHub release, invisibly","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Merge staged GitHub release — merge_release","text":"Manually verify status checks completed running, merge_release() currently validate status checks successful. run, merge_release(): Determines staged release title NEWS.md using get_release() Selects GitHub pull request matches staged release title, stops less one matching PR using gh::gh() Verifies staged pull request ready merged checking locked, draft, mergeable, rebaseable flags Merges pull request default branch using \"Rebase merge\" using gh::gh() Deletes pull request branch remotely locally using gh::gh() gert::git_branch_delete() Updates default branch gert::git_pull() Adds version tag DESCRIPTION commit message \"GitHub release \" gert::git_tag_create() pushes using gert::git_tag_push() Create GitHub release newly created tag, name \"\" release notes body, using gh::gh()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/merge_release.html","id":"host","dir":"Reference","previous_headings":"","what":"Host","title":"Merge staged GitHub release — merge_release","text":"Set rdev.host option using GitHub Enterprise server: options(rdev.host = \"https://github.example.com/api/v3\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/new_branch.html","id":null,"dir":"Reference","previous_headings":"","what":"Start a new branch — new_branch","title":"Start a new branch — new_branch","text":"Create new \"feature\" branch current default branch project git repository using gert::git_branch_create() bump 'dev' version 9000 desc::desc_bump_version().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/new_branch.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Start a new branch — new_branch","text":"","code":"new_branch(name, bump_ver = TRUE, current = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/new_branch.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Start a new branch — new_branch","text":"name name new branch. bump_ver TRUE, bump 'dev' version 9000, see details. current create new branch currently active branch (TRUE) default branch (FALSE), see details.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/new_branch.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Start a new branch — new_branch","text":"new branch created checked exist local remote. version DESCRIPTION 3 components (release version) bump_ver TRUE (default), fourth component, 'dev' bumped 9000 checked new branch. version already 4 components, changed. current = FALSE (default), new branch created default branch determined usethis::git_default_branch().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":null,"dir":"Reference","previous_headings":"","what":"Open rdev files — open_files","title":"Open rdev files — open_files","text":"Open standard set files editing RStudio.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Open rdev files — open_files","text":"","code":"open_files(files = c(\"TODO.md\", \"NEWS.md\", \"README.Rmd\", \"DESCRIPTION\"))"},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Open rdev files — open_files","text":"files vector files open.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Open rdev files — open_files","text":"named character vector files opened.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/open_files.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Open rdev files — open_files","text":"default, open_files() opens four documents RStudio: TODO.md, NEWS.md, README.Rmd, DESCRIPTION. open_files() stop error RStudio running.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize package downloads — package_downloads","title":"Summarize package downloads — package_downloads","text":"wrapper cranlogs::cran_downloads() summarizes number package downloads RStudio CRAN mirror.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize package downloads — package_downloads","text":"","code":"package_downloads(packages, when = \"last-month\")"},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize package downloads — package_downloads","text":"packages character vector packages query. period summarize, one last-day, last-week last-month (default).","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize package downloads — package_downloads","text":"data frame containing total number downloads package specified period, sorted popularity.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/package_downloads.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Summarize package downloads — package_downloads","text":"default, summary last month.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/quickstart.html","id":null,"dir":"Reference","previous_headings":"","what":"rdev Quick Start — quickstart","title":"rdev Quick Start — quickstart","text":"Quick start guide creating new rdev analysis package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/quickstart.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rdev Quick Start — quickstart","text":"quickly create configure new rdev analysis package, use following commands: project open, run create_github_repo() initialize GitHub R repository Without committing git, run init() newly created project Manually update Title Description fields DESCRIPTION file without committing Run setup_analysis() setup_rdev() configure package analysis package rdev package respectively. Manually update .gitignore: remove docs/ exclusion add line breaks , package configuration complete ready development.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rdev-package.html","id":null,"dir":"Reference","previous_headings":"","what":"rdev: R Development Tools — rdev-package","title":"rdev: R Development Tools — rdev-package","text":"opinionated collection development tools, packages, utilities.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/rdev-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"rdev: R Development Tools — rdev-package","text":"Maintainer: John Benninghoff jbenninghoff@mac.com (ORCID)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":null,"dir":"Reference","previous_headings":"","what":"Get analysis notebook metadata — rmd_metadata","title":"Get analysis notebook metadata — rmd_metadata","text":"Extract YAML front matter 'description' line analysis notebook, construct URL notebook's location GitHub pages.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get analysis notebook metadata — rmd_metadata","text":"","code":"rmd_metadata(file_path)"},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get analysis notebook metadata — rmd_metadata","text":"file_path Path analysis notebook","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get analysis notebook metadata — rmd_metadata","text":"Named list containing analysis notebook title, URL, date, description","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/rmd_metadata.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get analysis notebook metadata — rmd_metadata","text":"'description' line first non-blank line body R notebook serves brief description work. _quarto.yml present, rmd_metadata() extract YAML front matter description Quarto format (.qmd) notebooks.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_analysis.html","id":null,"dir":"Reference","previous_headings":"","what":"Set up analysis package — setup_analysis","title":"Set up analysis package — setup_analysis","text":"Set analysis package within rdev package newly initialized init(), updating Title Description DESCRIPTION, committing changes running use_analysis_package(), use_spelling(), ci().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_analysis.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set up analysis package — setup_analysis","text":"","code":"setup_analysis(use_quarto = TRUE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_analysis.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set up analysis package — setup_analysis","text":"use_quarto TRUE (default), use Quarto publishing (build_quarto_site()), otherwise use build_analysis_site().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_analysis.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set up analysis package — setup_analysis","text":"setup_analysis() stop rlang::is_interactive() FALSE, run open_files() running RStudio.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_rdev.html","id":null,"dir":"Reference","previous_headings":"","what":"Set up rdev package — setup_rdev","title":"Set up rdev package — setup_rdev","text":"Set rdev package traditional package development running init() updating Title Description DESCRIPTION, committing changes running use_rdev_pkgdown(), use_spelling(), use_codecov(), ci().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_rdev.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set up rdev package — setup_rdev","text":"","code":"setup_rdev()"},{"path":"https://jabenninghoff.github.io/rdev/reference/setup_rdev.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set up rdev package — setup_rdev","text":"setup_rdev() stop rlang::is_interactive() FALSE, run open_files() running RStudio.","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_file.html","id":null,"dir":"Reference","previous_headings":"","what":"Sort file — sort_file","title":"Sort file — sort_file","text":"Sorts file using R sort().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_file.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sort file — sort_file","text":"","code":"sort_file(filename)"},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_file.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sort file — sort_file","text":"filename file sorted","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_file.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Sort file — sort_file","text":"","code":"if (FALSE) { # \\dontrun{ sort_file(\".Rbuildignore\") } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_rbuildignore.html","id":null,"dir":"Reference","previous_headings":"","what":"Sort .Rbuildignore file — sort_rbuildignore","title":"Sort .Rbuildignore file — sort_rbuildignore","text":"Sorts .Rbuildignore file using sort_file().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/sort_rbuildignore.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sort .Rbuildignore file — sort_rbuildignore","text":"","code":"sort_rbuildignore()"},{"path":"https://jabenninghoff.github.io/rdev/reference/spell_check_notebooks.html","id":null,"dir":"Reference","previous_headings":"","what":"Spell Check Notebooks — spell_check_notebooks","title":"Spell Check Notebooks — spell_check_notebooks","text":"Perform spell check notebooks spelling::spell_check_files().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/spell_check_notebooks.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spell Check Notebooks — spell_check_notebooks","text":"","code":"spell_check_notebooks( path = \"analysis\", regexp = \"[.][Rq]md$\", use_wordlist = TRUE, lang = NULL )"},{"path":"https://jabenninghoff.github.io/rdev/reference/spell_check_notebooks.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spell Check Notebooks — spell_check_notebooks","text":"path character vector one paths. regexp regular expression (e.g. [.]csv$) passed grep() filter paths. use_wordlist ignore words package WORDLIST file. lang set Language field DESCRIPTION e.g. \"en-US\" \"en-GB\". supporting languages, see hunspell vignette.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/spell_check_notebooks.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Spell Check Notebooks — spell_check_notebooks","text":"lang NULL (default), get language DESCRIPTION using desc::desc_get_field().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":null,"dir":"Reference","previous_headings":"","what":"Stage a GitHub release — stage_release","title":"Stage a GitHub release — stage_release","text":"Open GitHub pull request new release NEWS.md. Approve, merge, create release using merge_release().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Stage a GitHub release — stage_release","text":"","code":"stage_release( pkg = \".\", filename = \"NEWS.md\", unfreeze = FALSE, host = getOption(\"rdev.host\") )"},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Stage a GitHub release — stage_release","text":"pkg path package. Currently, pkg = \".\" supported. filename name file containing release notes, defaults NEWS.md. unfreeze TRUE, delete Quarto _freeze directory fully re-render site. host GitHub host target, passed .api_url argument gh::gh(). unspecified, gh defaults \"https://api.github.com\", although gh's default can customised setting GITHUB_API_URL environment variable. hypothetical GitHub Enterprise instance, either \"https://github.acme.com/api/v3\" \"https://github.acme.com\" acceptable.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Stage a GitHub release — stage_release","text":"results GitHub pull request, invisibly","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Stage a GitHub release — stage_release","text":"run, stage_release(): Extracts release version release notes NEWS.md using get_release() Validates version conforms rdev conventions (#.#.#) release notes empty Verifies version tag already exist using gert::git_tag_list() Checks uncommitted changes stops exist using gert::git_status() Creates new branch default branch (gert::git_branch() == usethis::git_default_branch()) using gert::git_branch_create() Updates Version DESCRIPTION desc::desc_set_version(), commits push git message \"GitHub release \" using gert::git_add(), gert::git_commit() gert::git_push() Runs build_quarto_site() (_quarto.yml exists), build_analysis_site() (pkgdown/_base.yml exists) build_rdev_site() (_pkgdown.yml exists), commits pushes changes () git message: \" release \" Opens pull request title \" \" release notes body using gh::gh()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/stage_release.html","id":"host","dir":"Reference","previous_headings":"","what":"Host","title":"Stage a GitHub release — stage_release","text":"Set rdev.host option using GitHub Enterprise server: options(rdev.host = \"https://github.example.com/api/v3\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/style_all.html","id":null,"dir":"Reference","previous_headings":"","what":"Style all files — style_all","title":"Style all files — style_all","text":"Style files project. Implemented wrapper styler::style_dir() defaults styling .R, .Rprofile, .Rmd, .Rmarkdown, .Rnw, .qmd files, excluding files packrat, renv, R/RcppExports.R.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/style_all.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Style all files — style_all","text":"","code":"style_all( path = \".\", filetype = c(\"R\", \"Rprofile\", \"Rmd\", \"Rmarkdown\", \"Rnw\", \"Qmd\"), exclude_dirs = c(\"packrat\", \"renv\"), exclude_files = \"R/RcppExports.R\", ... )"},{"path":"https://jabenninghoff.github.io/rdev/reference/style_all.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Style all files — style_all","text":"path Path directory files transform. filetype Vector file extensions indicating file types styled. Case ignored, . optional, e.g. c(\".R\",\".Rmd\"), c(\"r\", \"rmd\"). Supported values (standardization) : \"qmd\", \"r\", \"rmd\", \"rmarkdown\", \"rnw\", \"rprofile\". Rmarkdown treated Rmd. exclude_dirs Character vector directories exclude (recursively). exclude_files Character vector regular expressions files excluded styling. ... Arguments passed styler::style_dir style function creates style guide use, default tidyverse_style. used except construct argument transformers. See style_guides() details. transformers set transformer functions. argument conveniently constructed via style argument .... See 'Examples'. recursive logical value indicating whether files sub directories path styled well. include_roxygen_examples Whether style code roxygen examples. base_indention Integer scalar indicating many spaces whole output text indented. Note splitting line add base_indention spaces code case multi-line strings present. See 'Examples'. dry indicate whether styler run dry mode, .e. refrain writing back files .\"\" \"fail\" write back, latter returns error input code identical result styling. \"\", default, writes back input output styling identical.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/style_all.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Style all files — style_all","text":"","code":"if (FALSE) { # \\dontrun{ style_all() style_all(\"analysis\", filetype = \"Rmd\") } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert R Notebook to html_document — to_document","title":"Convert R Notebook to html_document — to_document","text":"Copies file using fs::file_copy() changes output type yaml front matter html_notebook html_document, removing output types.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert R Notebook to html_document — to_document","text":"","code":"to_document(file_path, new_path, overwrite = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert R Notebook to html_document — to_document","text":"file_path Path source file new_path Path copy converted file using fs::file_copy() overwrite Overwrite file exists, passed fs::file_copy()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert R Notebook to html_document — to_document","text":"Path new file","code":""},{"path":[]},{"path":"https://jabenninghoff.github.io/rdev/reference/to_document.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert R Notebook to html_document — to_document","text":"","code":"if (FALSE) { # \\dontrun{ to_document(\"notebook.Rmd\", \"document.Rmd\") to_document(\"notebooks_dir/notebook.Rmd\", \"documents_dir\") } # }"},{"path":"https://jabenninghoff.github.io/rdev/reference/unfreeze.html","id":null,"dir":"Reference","previous_headings":"","what":"Unfreeze Quarto site — unfreeze","title":"Unfreeze Quarto site — unfreeze","text":"Delete Quarto _freeze directory fully re-render site quarto::quarto_render() called.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/unfreeze.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Unfreeze Quarto site — unfreeze","text":"","code":"unfreeze()"},{"path":"https://jabenninghoff.github.io/rdev/reference/update_wordlist_notebooks.html","id":null,"dir":"Reference","previous_headings":"","what":"Update WORDLIST from notebooks — update_wordlist_notebooks","title":"Update WORDLIST from notebooks — update_wordlist_notebooks","text":"Update package inst/WORDLIST words spell_check_notebooks().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/update_wordlist_notebooks.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Update WORDLIST from notebooks — update_wordlist_notebooks","text":"","code":"update_wordlist_notebooks( pkg = \".\", vignettes = TRUE, path = \"analysis\", regexp = \"[.][Rq]md$\", confirm = TRUE )"},{"path":"https://jabenninghoff.github.io/rdev/reference/update_wordlist_notebooks.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Update WORDLIST from notebooks — update_wordlist_notebooks","text":"pkg path package root directory containing DESCRIPTION file vignettes check rmd rnw files pkg root directory (e.g. readme.md) package vignettes folder. path character vector one paths. regexp regular expression (e.g. [.]csv$) passed grep() filter paths. confirm show changes ask confirmation adding new words list","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/update_wordlist_notebooks.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Update WORDLIST from notebooks — update_wordlist_notebooks","text":"update_wordlist_notebooks customized version spelling::update_wordlist() using code wordlist.R.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/urlchecker-reexports.html","id":null,"dir":"Reference","previous_headings":"","what":"Functions re-exported from the urlchecker package — urlchecker-reexports","title":"Functions re-exported from the urlchecker package — urlchecker-reexports","text":"functions re-exported urlchecker package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/urlchecker-reexports.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Functions re-exported from the urlchecker package — urlchecker-reexports","text":"","code":"url_check( path = \".\", db = NULL, parallel = TRUE, pool = curl::new_pool(), progress = TRUE ) url_update(path = \".\", results = url_check(path))"},{"path":"https://jabenninghoff.github.io/rdev/reference/urlchecker-reexports.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Functions re-exported from the urlchecker package — urlchecker-reexports","text":"path Path package db url database parallel TRUE, check URLs parallel pool multi handle created curl::new_pool(). NULL use global pool. progress Whether show progress bar parallel checks results results url_check.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/urlchecker-reexports.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Functions re-exported from the urlchecker package — urlchecker-reexports","text":"Follow links see urlchecker documentation. urlchecker::url_check() urlchecker::url_update()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":null,"dir":"Reference","previous_headings":"","what":"Use Analysis Package Layout — use_analysis_package","title":"Use Analysis Package Layout — use_analysis_package","text":"Add Analysis Package Layout current package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use Analysis Package Layout — use_analysis_package","text":"","code":"use_analysis_package(use_quarto = TRUE, prompt = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use Analysis Package Layout — use_analysis_package","text":"use_quarto TRUE (default), use Quarto publishing (build_quarto_site()), otherwise use build_analysis_site(). prompt TRUE, prompt writing renv.lock, passed renv::snapshot().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Use Analysis Package Layout — use_analysis_package","text":"List containing dirs created, rbuildignore lines added .Rbuildignore, gitignore exclusions added .gitignore.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_analysis_package.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use Analysis Package Layout — use_analysis_package","text":"run, use_analysis_package(): Creates analysis package directories Adds exclusions .gitignore .Rbuildignore Adds extra.css analysis/assets pkgdown (use_quarto FALSE) fix rendering GitHub-style task lists Adds .nojekyll, _quarto.yml, changelog.qmd, index.qmd analysis/_metadata.yml templates creates _base.yml pkgdown first URL DESCRIPTION Installs README.Rmd template analysis packages, dplyr package needed README.Rmd template","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev code coverage — use_codecov","title":"Use rdev code coverage — use_codecov","text":"Install code coverage usethis::use_coverage(type = \"codecov\"), DT package covr::report(), rdev GitHub action test-coverage.yaml.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev code coverage — use_codecov","text":"","code":"use_codecov(prompt = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev code coverage — use_codecov","text":"prompt TRUE, prompt writing renv.lock, passed renv::snapshot().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use rdev code coverage — use_codecov","text":"use_rdev_package(), use_analysis_package() use_codecov() modify README.Rmd, use_codecov() must run last changes overwritten. use_codecov() run use_rdev_package(). Set option rdev.codecov FALSE skip installation codecov.io test-coverage.yaml: options(rdev.codecov = FALSE)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_codecov.html","id":"github-actions","dir":"Reference","previous_headings":"","what":"GitHub Actions","title":"Use rdev code coverage — use_codecov","text":"GitHub Actions can disabled setting rdev.github.actions FALSE: options(rdev.github.actions = FALSE)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_lintr.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev .lintr — use_lintr","title":"Use rdev .lintr — use_lintr","text":"Install rdev .lintr template using usethis::use_template()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_lintr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev .lintr — use_lintr","text":"","code":"use_lintr(open = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_lintr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev .lintr — use_lintr","text":"open Open newly created file editing? Happens RStudio, applicable, via utils::file.edit() otherwise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_package_r.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev package.R — use_package_r","title":"Use rdev package.R — use_package_r","text":"Install rdev package.R template using usethis::use_template()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_package_r.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev package.R — use_package_r","text":"","code":"use_package_r(open = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_package_r.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev package.R — use_package_r","text":"open Open newly created file editing? Happens RStudio, applicable, via utils::file.edit() otherwise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_package_r.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use rdev package.R — use_package_r","text":"package.R saved \"R/package.R\".","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev package conventions — use_rdev_package","title":"Use rdev package conventions — use_rdev_package","text":"Add rdev templates settings within active package. Normally invoked first setting package.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev package conventions — use_rdev_package","text":"","code":"use_rdev_package(quiet = TRUE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev package conventions — use_rdev_package","text":"quiet TRUE, disable user prompts setting rlang::local_interactive() FALSE.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":"github-pages","dir":"Reference","previous_headings":"","what":"GitHub Pages","title":"Use rdev package conventions — use_rdev_package","text":"GitHub Pages enabled default public repositories, can disabled setting rdev.github.pages FALSE: options(rdev.github.pages = FALSE). GitHub Pages disabled default private repositories (supported free plan), can enabled setting rdev.github.pages TRUE.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_package.html","id":"github-actions","dir":"Reference","previous_headings":"","what":"GitHub Actions","title":"Use rdev package conventions — use_rdev_package","text":"GitHub Actions can disabled setting rdev.github.actions FALSE: options(rdev.github.actions = FALSE)","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_pkgdown.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev pkgdown — use_rdev_pkgdown","title":"Use rdev pkgdown — use_rdev_pkgdown","text":"Add pkgdown rdev customizations. Implemented wrapper usethis::use_pkgdown().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_pkgdown.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev pkgdown — use_rdev_pkgdown","text":"","code":"use_rdev_pkgdown(config_file = \"_pkgdown.yml\", destdir = \"docs\")"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_pkgdown.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev pkgdown — use_rdev_pkgdown","text":"config_file Path pkgdown yaml config file, relative project. destdir Target directory pkgdown docs.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rdev_pkgdown.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use rdev pkgdown — use_rdev_pkgdown","text":"addition running usethis::use_pkgdown(), use_rdev_pkgdown adds extra.css pkgdown fix rendering GitHub-style task lists, adds GitHub Pages URL, enables template.light-switch.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rprofile.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev .Rprofile — use_rprofile","title":"Use rdev .Rprofile — use_rprofile","text":"Install rdev .Rprofile template using usethis::use_template()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rprofile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev .Rprofile — use_rprofile","text":"","code":"use_rprofile(open = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_rprofile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev .Rprofile — use_rprofile","text":"open Open newly created file editing? Happens RStudio, applicable, via utils::file.edit() otherwise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_spelling.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev spelling — use_spelling","title":"Use rdev spelling — use_spelling","text":"Install spelling rdev conventions.","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_spelling.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev spelling — use_spelling","text":"","code":"use_spelling(lang = \"en-US\", prompt = FALSE)"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_spelling.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev spelling — use_spelling","text":"lang Preferred spelling language. Usually either \"en-US\" \"en-GB\". prompt TRUE, prompt writing renv.lock, passed renv::snapshot().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_spelling.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Use rdev spelling — use_spelling","text":"Since spelling::spell_check_setup() requires user interaction, use_spelling() run use_rdev_package().","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_todo.html","id":null,"dir":"Reference","previous_headings":"","what":"Use rdev TODO.md — use_todo","title":"Use rdev TODO.md — use_todo","text":"Install rdev TODO.md template using usethis::use_template()","code":""},{"path":"https://jabenninghoff.github.io/rdev/reference/use_todo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use rdev TODO.md — use_todo","text":"","code":"use_todo(open = rlang::is_interactive())"},{"path":"https://jabenninghoff.github.io/rdev/reference/use_todo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use rdev TODO.md — use_todo","text":"open Open newly created file editing? Happens RStudio, applicable, via utils::file.edit() otherwise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1115","dir":"Changelog","previous_headings":"","what":"rdev 1.11.5","title":"rdev 1.11.5","text":"rdev now depends R >= 4.0.0 use_analysis_package() now records dependency R native pipes (R >= 4.1.0)","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1114","dir":"Changelog","previous_headings":"","what":"rdev 1.11.4","title":"rdev 1.11.4","text":"Updated “Introduction rdev” vignette, vignette(\"rdev\")","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1113","dir":"Changelog","previous_headings":"","what":"rdev 1.11.3","title":"rdev 1.11.3","text":"Added support Visual Studio Code (languageserver package) default","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1112","dir":"Changelog","previous_headings":"","what":"rdev 1.11.2","title":"rdev 1.11.2","text":"Minor updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1111","dir":"Changelog","previous_headings":"","what":"rdev 1.11.1","title":"rdev 1.11.1","text":"Enabled pkgdown “light switch” default packages using use_rdev_pkgdown()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1110","dir":"Changelog","previous_headings":"","what":"rdev 1.11.0","title":"rdev 1.11.0","text":"Added function package_downloads(): wrapper cranlogs::cran_downloads() summarizes number package downloads RStudio CRAN mirror","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-11011","dir":"Changelog","previous_headings":"","what":"rdev 1.10.11","title":"rdev 1.10.11","text":"Minor updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-11010","dir":"Changelog","previous_headings":"","what":"rdev 1.10.10","title":"rdev 1.10.10","text":"Bug fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1109","dir":"Changelog","previous_headings":"","what":"rdev 1.10.9","title":"rdev 1.10.9","text":"Add support single URL DESCRIPTION","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1108","dir":"Changelog","previous_headings":"","what":"rdev 1.10.8","title":"rdev 1.10.8","text":"Added support private repositories use_rdev_package()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1107","dir":"Changelog","previous_headings":"","what":"rdev 1.10.7","title":"rdev 1.10.7","text":"Added support creating private repositories create_github_repo()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1106","dir":"Changelog","previous_headings":"","what":"rdev 1.10.6","title":"rdev 1.10.6","text":"Updated R 4.4.0","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1105","dir":"Changelog","previous_headings":"","what":"rdev 1.10.5","title":"rdev 1.10.5","text":"Updated pkgdown templates (update: use_rdev_pkgdown() use_analysis_package(use_quarto = FALSE))","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1104","dir":"Changelog","previous_headings":"","what":"rdev 1.10.4","title":"rdev 1.10.4","text":"Updated GitHub Actions work better renv (update https://github.com/jabenninghoff/rdev/tree/main/.github/workflows)","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1103","dir":"Changelog","previous_headings":"","what":"rdev 1.10.3","title":"rdev 1.10.3","text":"Updated R-CMD-check.yaml GitHub Action (update: use_rdev_package())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1102","dir":"Changelog","previous_headings":"","what":"rdev 1.10.2","title":"rdev 1.10.2","text":"rdev now supports Quarto Documents (.qmd) analysis notebooks: rmd_metadata() extract YAML front matter description Quarto format (.qmd) notebooks _quarto.yml present build_quarto_site() now supports use Rmd /qmd notebooks analysis spell_check_notebooks() update_wordlist_notebooks() now check Rmd qmd files analysis directory Updated README.Rmd template list .Rmd .qmd notebooks analysis Added reference Quarto Document analysis template inst/templates/analysis.qmd (RStudio currently doesn’t support .qmd files document templates) Updated vignettes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1101","dir":"Changelog","previous_headings":"","what":"rdev 1.10.1","title":"rdev 1.10.1","text":"Added unfreeze parameter stage_release(), passed build_quarto_site()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1911","dir":"Changelog","previous_headings":"","what":"rdev 1.9.11","title":"rdev 1.9.11","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-1910","dir":"Changelog","previous_headings":"","what":"rdev 1.9.10","title":"rdev 1.9.10","text":"Updated build_rdev_site() build_analysis_site() use pkgdown::build_site_github_pages() instead pkgdown::build_site(), disables Jekyll rendering adds CNAME needed","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-199","dir":"Changelog","previous_headings":"","what":"rdev 1.9.9","title":"rdev 1.9.9","text":"Updated quarto configuration (update: use_analysis_package())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-198","dir":"Changelog","previous_headings":"","what":"rdev 1.9.8","title":"rdev 1.9.8","text":"Added quarto themes (flatly, darkly) (update: use_analysis_package()) Updated analysis template","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-197","dir":"Changelog","previous_headings":"","what":"rdev 1.9.7","title":"rdev 1.9.7","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-196","dir":"Changelog","previous_headings":"","what":"rdev 1.9.6","title":"rdev 1.9.6","text":"Add new rdev hex sticker logo stickers man/figures/logo.png per roxygen2 README.Rmd per pkgdown Fixed bugs quickstart functions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-195","dir":"Changelog","previous_headings":"","what":"rdev 1.9.5","title":"rdev 1.9.5","text":"Updated TODO","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-194","dir":"Changelog","previous_headings":"","what":"rdev 1.9.4","title":"rdev 1.9.4","text":"Updated lintr.yaml GitHub Action match lint_all() (update: run use_rdev_package())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-193","dir":"Changelog","previous_headings":"","what":"rdev 1.9.3","title":"rdev 1.9.3","text":"lint_all() style_all() now (properly) exclude R/RcppExports.R","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-192","dir":"Changelog","previous_headings":"","what":"rdev 1.9.2","title":"rdev 1.9.2","text":"Updated manual tests Bug fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-191","dir":"Changelog","previous_headings":"","what":"rdev 1.9.1","title":"rdev 1.9.1","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-190","dir":"Changelog","previous_headings":"","what":"rdev 1.9.0","title":"rdev 1.9.0","text":"Adjusted Quarto margins _quarto.yml Added ?quickstart rdev Quick Start guide creating new rdev analysis package updated related functions (create_github_repo(), init(), setup_analysis()) README Added function setup_rdev(): set rdev package traditional package development Added function open_files(): open standard set files editing RStudio setup_analysis() setup_rdev() now call open_files() running RStudio","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-186","dir":"Changelog","previous_headings":"","what":"rdev 1.8.6","title":"rdev 1.8.6","text":"Check function arguments checkmate","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-185","dir":"Changelog","previous_headings":"","what":"rdev 1.8.5","title":"rdev 1.8.5","text":"Changed use_analysis_package() store _freeze directory git per Quarto guide","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-184","dir":"Changelog","previous_headings":"","what":"rdev 1.8.4","title":"rdev 1.8.4","text":"Also set GitHub Pages URL use_rdev_pkgdown()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-183","dir":"Changelog","previous_headings":"","what":"rdev 1.8.3","title":"rdev 1.8.3","text":"Check pandoc PATH launch (update: use_rprofile())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-182","dir":"Changelog","previous_headings":"","what":"rdev 1.8.2","title":"rdev 1.8.2","text":"Added rendering fixes use_analysis_package() (update: re-run use_analysis_package() update notebooks Analysis Notebook template) Added function use_rdev_pkgdown(): add pkgdown rdev customizations","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-181","dir":"Changelog","previous_headings":"","what":"rdev 1.8.1","title":"rdev 1.8.1","text":"Added support Visual Studio Code setup-r Quarto bug fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-180","dir":"Changelog","previous_headings":"","what":"rdev 1.8.0","title":"rdev 1.8.0","text":"Added support Quarto, including: New function build_quarto_site(): wrapper quarto::quarto_render() also updates README.md optionally deletes Quarto _freeze directory fully re-render site New function unfreeze(): delete Quarto _freeze directory fully re-render site quarto::quarto_render() called Updated stage_release() run build_quarto_site() using Quarto Updated use_analysis_package() use Quarto publishing default Added “quarto” package type local_temppkg() Additional changes: Updated vignettes Added “Introduction rdev” getting started vignette Added pkgdown::check_pkgdown() check ci()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-172","dir":"Changelog","previous_headings":"","what":"rdev 1.7.2","title":"rdev 1.7.2","text":"Updated .lintr lintr 3.1.1 (update use_lintr())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-171","dir":"Changelog","previous_headings":"","what":"rdev 1.7.1","title":"rdev 1.7.1","text":"Updated installation instructions README templates use remotes instead devtools","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-170","dir":"Changelog","previous_headings":"","what":"rdev 1.7.0","title":"rdev 1.7.0","text":"Updated check_renv() ci() use renv::status(dev = TRUE), added renv 1.0.3","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-169","dir":"Changelog","previous_headings":"","what":"rdev 1.6.9","title":"rdev 1.6.9","text":"Disabled use Posit package manager R-CMD-check.yaml (update use_rdev_package())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-168","dir":"Changelog","previous_headings":"","what":"rdev 1.6.8","title":"rdev 1.6.8","text":"Updated setup-r use rig installing managing R versions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-167","dir":"Changelog","previous_headings":"","what":"rdev 1.6.7","title":"rdev 1.6.7","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-166","dir":"Changelog","previous_headings":"","what":"rdev 1.6.6","title":"rdev 1.6.6","text":"Replaced check-standard.yaml R-CMD-check.yaml (update use_rdev_package()) Updated .lintr lintr 3.1.0 (update use_lintr()) Updated spelling tests (update use_spelling())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-165","dir":"Changelog","previous_headings":"","what":"rdev 1.6.5","title":"rdev 1.6.5","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-164","dir":"Changelog","previous_headings":"","what":"rdev 1.6.4","title":"rdev 1.6.4","text":"Added check install pre-commit git hook missing (update use_rprofile())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-163","dir":"Changelog","previous_headings":"","what":"rdev 1.6.3","title":"rdev 1.6.3","text":"extra_deps() longer reports R extra package","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-162","dir":"Changelog","previous_headings":"","what":"rdev 1.6.2","title":"rdev 1.6.2","text":"missing_deps() now excludes base R packages default Added new checks ci(): missing_deps(), desc::desc_normalize(), extra_deps(), url_check(), html_url_check(); ci() stop missing_deps() returns one rows Added missing-deps.yaml GitHub Action","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-161","dir":"Changelog","previous_headings":"","what":"rdev 1.6.1","title":"rdev 1.6.1","text":"new_branch() now stashes restores changes, Bump version commit just changes version number DESCRIPTION","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-160","dir":"Changelog","previous_headings":"","what":"rdev 1.6.0","title":"rdev 1.6.0","text":"missing_deps() extra_deps() now automatically remove current package renv (renv.lock) list renv::dependencies()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-159","dir":"Changelog","previous_headings":"","what":"rdev 1.5.9","title":"rdev 1.5.9","text":"Update build_analysis_site() ‘Analysis Notebook’ R markdown template use Bootstrap 5 using bslib Update rdev pkgdown site use Bootstrap 5","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-158","dir":"Changelog","previous_headings":"","what":"rdev 1.5.8","title":"rdev 1.5.8","text":"Update options enable warnings partial matches","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-157","dir":"Changelog","previous_headings":"","what":"rdev 1.5.7","title":"rdev 1.5.7","text":"Add option warn partial $ matches","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-156","dir":"Changelog","previous_headings":"","what":"rdev 1.5.6","title":"rdev 1.5.6","text":"Update lint_all() also check .Rpres files","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-155","dir":"Changelog","previous_headings":"","what":"rdev 1.5.5","title":"rdev 1.5.5","text":"Add option disable GitHub Pages use_rdev_package() options(rdev.github.pages = FALSE) Use proper GitHub Pages URL trailing “/”","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-154","dir":"Changelog","previous_headings":"","what":"rdev 1.5.4","title":"rdev 1.5.4","text":"Minor maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-153","dir":"Changelog","previous_headings":"","what":"rdev 1.5.3","title":"rdev 1.5.3","text":"Maintenance updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-152","dir":"Changelog","previous_headings":"","what":"rdev 1.5.2","title":"rdev 1.5.2","text":"Minor updates Style Guide","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-151","dir":"Changelog","previous_headings":"","what":"rdev 1.5.1","title":"rdev 1.5.1","text":"Replace development lintr CRAN release 3.0.0 Add Style Guide vignette, describing rdev coding style, styler lintr configuration","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-150","dir":"Changelog","previous_headings":"","what":"rdev 1.5.0","title":"rdev 1.5.0","text":"Added styler cache options .Rprofile template Imported urlchecker::url_check(), urlchecker::url_update(), added new function, html_url_check(), check URLs docs/ (replaces proof-docs script) Replaced scripts tools/ automating package setup init(): run create_github_repo(), setup_analysis(): run init() Moved setup-r inst/bin Increased test coverage","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-149","dir":"Changelog","previous_headings":"","what":"rdev 1.4.9","title":"rdev 1.4.9","text":"Clean tests, standardize error messages","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-148","dir":"Changelog","previous_headings":"","what":"rdev 1.4.8","title":"rdev 1.4.8","text":"Make rdev data.table aware","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-147","dir":"Changelog","previous_headings":"","what":"rdev 1.4.7","title":"rdev 1.4.7","text":"Added scripts tools/ automate package setup","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-146","dir":"Changelog","previous_headings":"","what":"rdev 1.4.6","title":"rdev 1.4.6","text":"Updated lint workflow","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-145","dir":"Changelog","previous_headings":"","what":"rdev 1.4.5","title":"rdev 1.4.5","text":"Updated new linters","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-144","dir":"Changelog","previous_headings":"","what":"rdev 1.4.4","title":"rdev 1.4.4","text":"Enable linters inst/templates/lintr","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-143","dir":"Changelog","previous_headings":"","what":"rdev 1.4.3","title":"rdev 1.4.3","text":"Normalize DESCRIPTION file","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-142","dir":"Changelog","previous_headings":"","what":"rdev 1.4.2","title":"rdev 1.4.2","text":"Remove workaround resolved upstream issue","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-141","dir":"Changelog","previous_headings":"","what":"rdev 1.4.1","title":"rdev 1.4.1","text":"Added missing Suggests dependencies setup functions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-140","dir":"Changelog","previous_headings":"","what":"rdev 1.4.0","title":"rdev 1.4.0","text":"Added functions check dependencies: missing_deps() reports renv::dependencies() DESCRIPTION, extra_deps() reports desc::desc_get_deps() found renv Added renv check ci(): renv::status() synchronized, ci() stop","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-138","dir":"Changelog","previous_headings":"","what":"rdev 1.3.8","title":"rdev 1.3.8","text":"Fix bugs tests, use_analysis_package()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-137","dir":"Changelog","previous_headings":"","what":"rdev 1.3.7","title":"rdev 1.3.7","text":"Fixed bug lint workflow","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-136","dir":"Changelog","previous_headings":"","what":"rdev 1.3.6","title":"rdev 1.3.6","text":"Updated .Rprofile load current package start Updated R version 4.2.0 (2022-04-22) – “Vigorous Calisthenics”","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-135","dir":"Changelog","previous_headings":"","what":"rdev 1.3.5","title":"rdev 1.3.5","text":"Updated GitHub workflows","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-134","dir":"Changelog","previous_headings":"","what":"rdev 1.3.4","title":"rdev 1.3.4","text":"Added new test scripts new package setup","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-133","dir":"Changelog","previous_headings":"","what":"rdev 1.3.3","title":"rdev 1.3.3","text":"Fixed ci() stage_release() correctly use gert::git_status() determine uncommitted changes exist (instead gert::git_diff_patch())","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-132","dir":"Changelog","previous_headings":"","what":"rdev 1.3.2","title":"rdev 1.3.2","text":"Fixed update_wordlist_notebooks(): removed duplicate words Update use_spelling() install test-spelling.R testthat template","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-131","dir":"Changelog","previous_headings":"","what":"rdev 1.3.1","title":"rdev 1.3.1","text":"Added update_wordlist_notebooks(): Update package inst/WORDLIST words spell_check_notebooks() Updated spell_check_notebooks() use Language field DESCRIPTION default","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-130","dir":"Changelog","previous_headings":"","what":"rdev 1.3.0","title":"rdev 1.3.0","text":"Added new options features support GitHub Enterprise.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"new-options-1-3-0","dir":"Changelog","previous_headings":"","what":"New Options","title":"rdev 1.3.0","text":"Added settings, configured using options() rdev.host: set default server create_github_repo(), stage_release(), merge_release() (support GitHub Enterprise) rdev.codecov: disable codecov.io support use_codecov() rdev.dependabot: disable support Dependabot create_github_repo() rdev.license rdev.license.copyright: specify licenses create_github_repo(), use_rdev_package() rdev.github.actions: disable support GitHub Actions create_github_repo(), use_codecov(), use_rdev_package()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"new-features-1-3-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"rdev 1.3.0","text":"create_github_repo() now supports creating repositories within organizations Updated setup-r script include pkgdown","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-126","dir":"Changelog","previous_headings":"","what":"rdev 1.2.6","title":"rdev 1.2.6","text":"Updated stage_release() run build_rdev_site() _pkgdown.yml exists","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-125","dir":"Changelog","previous_headings":"","what":"rdev 1.2.5","title":"rdev 1.2.5","text":"Updated ci() run spell check tests","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-124","dir":"Changelog","previous_headings":"","what":"rdev 1.2.4","title":"rdev 1.2.4","text":"Fix bug workaround closed usethis issue #1568","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-123","dir":"Changelog","previous_headings":"","what":"rdev 1.2.3","title":"rdev 1.2.3","text":"Updated use_codecov() use sort_rbuildignore()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-122","dir":"Changelog","previous_headings":"","what":"rdev 1.2.2","title":"rdev 1.2.2","text":"Implement workaround closed usethis issue #1568 use_analysis_package() now installs dplyr, used README.Rmd template Documentation updates","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-121","dir":"Changelog","previous_headings":"","what":"rdev 1.2.1","title":"rdev 1.2.1","text":"create_github_repo() now adds branch protection default branch","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-120","dir":"Changelog","previous_headings":"","what":"rdev 1.2.0","title":"rdev 1.2.0","text":"Added spell_check_notebooks(): Perform spell check notebooks spelling::spell_check_files().","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-111","dir":"Changelog","previous_headings":"","what":"rdev 1.1.1","title":"rdev 1.1.1","text":"Fix R-CMD-check Windows check_renv() now defaults running update interactive","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-110","dir":"Changelog","previous_headings":"","what":"rdev 1.1.0","title":"rdev 1.1.0","text":"style_all() now runs automatically uncommitted changes lint_all() now runs default opens RStudio markers pane lints found","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-101","dir":"Changelog","previous_headings":"","what":"rdev 1.0.1","title":"rdev 1.0.1","text":"Minor updates analysis README.Rmd template","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-100","dir":"Changelog","previous_headings":"","what":"rdev 1.0.0","title":"rdev 1.0.0","text":"rdev now stable enough 1.0.0 release!","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"major-features-1-0-0","dir":"Changelog","previous_headings":"","what":"Major features","title":"rdev 1.0.0","text":"rdev provides functions templates : Release automation: Stage create GitHub releases, including GitHub pages Continuous Integration: Local continuous integration checks dependency management Package Setup: Package setup tasks, typically performed ","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"recent-changes-1-0-0","dir":"Changelog","previous_headings":"","what":"Recent changes","title":"rdev 1.0.0","text":"Changes since release 0.8.9: Add use_spelling() use_codecov() Added local_temppkg() test helper function Minor enhancements use_rdev_package(), use_analysis_package(), build_analysis_site(), README.Rmd templates Updated documentation Added manual test script new package setup, increased test coverage","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"todo-1-0-0","dir":"Changelog","previous_headings":"","what":"TODO","title":"rdev 1.0.0","text":"ci(): styler set automatically run uncommitted changes lintr stop execution open RStudio markers lints found ci() run styler lintr default","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-089","dir":"Changelog","previous_headings":"","what":"rdev 0.8.9","title":"rdev 0.8.9","text":"Bug fixes use_rdev_package(), proof-docs","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-088","dir":"Changelog","previous_headings":"","what":"rdev 0.8.8","title":"rdev 0.8.8","text":"Added proof-docs script tools, checks docs directory using htmlproofer","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-087","dir":"Changelog","previous_headings":"","what":"rdev 0.8.7","title":"rdev 0.8.7","text":"Moved rmd_metadata() README-analysis.Rmd rdev package Increased test coverage, reorganized files","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-086","dir":"Changelog","previous_headings":"","what":"rdev 0.8.6","title":"rdev 0.8.6","text":"Added code coverage using codecov.io, new tests existing code Refactored sort_file()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-085","dir":"Changelog","previous_headings":"","what":"rdev 0.8.5","title":"rdev 0.8.5","text":"Critical bug fix to_document()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-084","dir":"Changelog","previous_headings":"","what":"rdev 0.8.4","title":"rdev 0.8.4","text":"Updated to_document() parse yaml front matter confirm source file valid R Notebook","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-083","dir":"Changelog","previous_headings":"","what":"rdev 0.8.3","title":"rdev 0.8.3","text":"Updated use_rdev_package() better conform rdev conventions (README.Rmd, .git/hooks/pre-commit), support committing error-free ci() immediately run","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-082","dir":"Changelog","previous_headings":"","what":"rdev 0.8.2","title":"rdev 0.8.2","text":"Updated build_rdev_site() build_analysis_site() abort missing topics pkgdown reference section","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-081","dir":"Changelog","previous_headings":"","what":"rdev 0.8.1","title":"rdev 0.8.1","text":"Added new_branch(): Create new feature branch, (optionally) bump version DESCRIPTION","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-080","dir":"Changelog","previous_headings":"","what":"rdev 0.8.0","title":"rdev 0.8.0","text":"Major update adding automation GitHub releases.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"release-automation-0-8-0","dir":"Changelog","previous_headings":"","what":"Release Automation","title":"rdev 0.8.0","text":"Added functions automate workflow staging creating releases GitHub: stage_release(): Open GitHub pull request new release NEWS.md get_release(): Extract release version release notes NEWS.md. Called stage_release() merge_release(). merge_release(): Merge staged pull request create new GitHub release","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"other-changes-0-8-0","dir":"Changelog","previous_headings":"","what":"Other Changes","title":"rdev 0.8.0","text":"Updated reorganized pkgdown reference page","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-073","dir":"Changelog","previous_headings":"","what":"rdev 0.7.3","title":"rdev 0.7.3","text":"Updated build_analysis_site() run devtools::build_readme() regenerate dynamic list notebooks (case new notebooks added) Important update renv 0.15.0 0.15.1","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-072","dir":"Changelog","previous_headings":"","what":"rdev 0.7.2","title":"rdev 0.7.2","text":"Added info dynamic notebook list notebook template Analysis Package Layout vignette","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-071","dir":"Changelog","previous_headings":"","what":"rdev 0.7.1","title":"rdev 0.7.1","text":"Updated use_analysis_package(): add dynamic notebook list README.Rmd template","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-070","dir":"Changelog","previous_headings":"","what":"rdev 0.7.0","title":"rdev 0.7.0","text":"Major update adding automation creating rdev R analysis packages.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"create-package-automation-0-7-0","dir":"Changelog","previous_headings":"","what":"‘Create Package’ Automation","title":"rdev 0.7.0","text":"Added functions automate steps creating new packages following rdev optionally analysis package conventions: create_github_repo(): Create new GitHub repository following rdev conventions active user’s account create basic package use_rdev_package(): Add rdev templates settings within active package. Normally invoked first setting package. Install templates using usethis::use_template(): use_rprofile(), use_lintr(), use_todo(), use_package_r() Add functionality use_analysis_package(): also install analysis package README.Rmd template Changed use_analysis_package() build_analysis_site() write _pkgdown.yml project root store GitHub make projects discoverable pkgdown. Updated setup-r install rdev dependencies site_library","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"other-changes-0-7-0","dir":"Changelog","previous_headings":"","what":"Other Changes","title":"rdev 0.7.0","text":"Added build_rdev_site(), wrapper pkgdown::build_site() optimized rdev workflow updates README.md performs clean build using pkgdown Added ‘Analysis Notebook’ R markdown template RStudio (File > New File > Rmarkdown > Template) Migrated ggplot2 themes/styles (theme_quo(), viridis_quo()) new package, jabenninghoff/jbplot","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-062","dir":"Changelog","previous_headings":"","what":"rdev 0.6.2","title":"rdev 0.6.2","text":"Add functionality use_analysis_package(): Create _base.yml pkgdown first URL package DESCRIPTION file.","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-061","dir":"Changelog","previous_headings":"","what":"rdev 0.6.1","title":"rdev 0.6.1","text":"Critical bugfix use_analysis_package()","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-060","dir":"Changelog","previous_headings":"","what":"rdev 0.6.0","title":"rdev 0.6.0","text":"Added use_analysis_package(): Add Analysis Package Layout current package","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-053","dir":"Changelog","previous_headings":"","what":"rdev 0.5.3","title":"rdev 0.5.3","text":"Add options theme_quo() disable panel.grid.major panel.grid.minor x y","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-052","dir":"Changelog","previous_headings":"","what":"rdev 0.5.2","title":"rdev 0.5.2","text":"Disable lintr default ci(), since normal workflow style_all(), lint_all(), ci() Documentation fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-051","dir":"Changelog","previous_headings":"","what":"rdev 0.5.1","title":"rdev 0.5.1","text":"Updated theme_quo(): set base theme ggplot2::theme_minimal() add parameters disabling grid lines","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-050","dir":"Changelog","previous_headings":"","what":"rdev 0.5.0","title":"rdev 0.5.0","text":"Added theme_quo(): ggplot2 theme based ggplot2::theme_bw() font Lato Added viridis_quo(): Sets default theme theme_quo() default color scales viridis maintenance","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-045","dir":"Changelog","previous_headings":"","what":"rdev 0.4.5","title":"rdev 0.4.5","text":"maintenance release, update GitHub Actions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-044","dir":"Changelog","previous_headings":"","what":"rdev 0.4.4","title":"rdev 0.4.4","text":"Update build_analysis_site() work pkgdown version 2","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-043","dir":"Changelog","previous_headings":"","what":"rdev 0.4.3","title":"rdev 0.4.3","text":"maintenance, update TODO steps manually setting Analysis Package","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-042","dir":"Changelog","previous_headings":"","what":"rdev 0.4.2","title":"rdev 0.4.2","text":"maintenance release, update README GitHub Actions","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-041","dir":"Changelog","previous_headings":"","what":"rdev 0.4.1","title":"rdev 0.4.1","text":"bug fixes, maintenance","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-040","dir":"Changelog","previous_headings":"","what":"rdev 0.4.0","title":"rdev 0.4.0","text":"Add devtools::document() option ci(), turned default Add R Analysis Package layout definition, migrated rtraining Update ci() use style_all() lint_all() consistency Add import directory build_analysis_site() minor updates, improved tests, maintenance","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-031","dir":"Changelog","previous_headings":"","what":"rdev 0.3.1","title":"rdev 0.3.1","text":"maintenance release, updated R 4.1.0","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-030","dir":"Changelog","previous_headings":"","what":"rdev 0.3.0","title":"rdev 0.3.0","text":"build_analysis_site(), new function migrated rtraining: wrapper pkgdown::build_site() adds ‘Analysis’ menu containing rendered versions .Rmd files analysis/. still considered Experimental, due lack test coverage features implemented, work projects limited pkgdown customization. update also includes function convert notebooks html_document, to_document().","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-022","dir":"Changelog","previous_headings":"","what":"rdev 0.2.2","title":"rdev 0.2.2","text":"minor updates, maintenance","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-021","dir":"Changelog","previous_headings":"","what":"rdev 0.2.1","title":"rdev 0.2.1","text":"bug fixes","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-020","dir":"Changelog","previous_headings":"","what":"rdev 0.2.0","title":"rdev 0.2.0","text":"installing rdev now automatically install preferred development tools ‘meta-package’ (like tidyverse), including: styler, lintr, rcmdcheck, renv, miniUI (RStudio Addin support), devtools, rmarkdown","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-012","dir":"Changelog","previous_headings":"","what":"rdev 0.1.2","title":"rdev 0.1.2","text":"minor updates package site (https://jabenninghoff.github.io/rdev/)","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-011","dir":"Changelog","previous_headings":"","what":"rdev 0.1.1","title":"rdev 0.1.1","text":"maintenance release","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"updates-0-1-1","dir":"Changelog","previous_headings":"","what":"Updates","title":"rdev 0.1.1","text":"ci(): updated match preferred GitHub workflow: use_github_action_check_standard() ---cran removed documentation updates functions (style, links)","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"rdev-010","dir":"Changelog","previous_headings":"","what":"rdev 0.1.0","title":"rdev 0.1.0","text":"Initial GitHub release","code":""},{"path":"https://jabenninghoff.github.io/rdev/news/index.html","id":"new-features-0-1-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"rdev 0.1.0","text":"./tools/setup-r: shell script install development packages site repository macOS + Homebrew check_renv(): convenience function runs renv status(), clean(), optionally update() (default). style_all(): style .R .Rmd files project using styler lint_all(): lint .R .Rmd files project using lintr sort_file(): sort file using R sort(), similar unix sort command sort_rbuildignore(): sort .Rbuildignore file using sort_file(), unsorted annoying ci(): run continuous integration tests locally: lint, R CMD check, style (default).","code":""}]