NEWS

---

rprojroot 2.1.1.9021

Chore

• Auto-update from GitHub Actions (#264).

rprojroot 2.1.1.9020

Chore

• Auto-update from GitHub Actions (#262).

• Update revdep report from revdep4 run (most, depth 1) (#258).

Continuous integration

• Run coverage checks after pkgdown push.

fledge

• Bump version to 2.0.4.9008 (#118).

rprojroot 2.1.1.9019

Features

• New is_targets_project() (@mitchelloharawild, #108, #146).

Continuous integration

• Explain (#149).

• Avoid failure in fledge workflow if no changes (#144).

• Correct installation of xml2 (#150).

Documentation

• Drop the demo package's roxygen2 version from the README (#253).

• Break lines at meaning boundaries (#252).

• Drop the branch from the coverage badge (#251).

• Harmonize README and pkgdown front page rendering (#245).

• Add a pak::pak() development install to the README (#244).

fledge

• Bump version to 2.0.4.9010 (#145).

• Bump version to 2.0.4.9008 (#141).

• Bump version to 2.0.4.9008 (#139).

rprojroot 2.1.1.9018

Chore

• Remove Copilot setup steps.

Continuous integration

• Correctly detect branch protection (#117).

• Trigger run (#115).

Documentation

• Use index.md (#114).

fledge

• Bump version to 2.0.4.9008 (#121).

• Bump version to 2.0.4.9008 (#120).

Uncategorized

• Fix(ci): Keep the raw name expression out of the running job's step list (cynkra/cynkratemplate#119).

rprojroot 2.1.1.9017

Features

ci

• Align the revdep2, revdep4 and revdepx subsystems with rigraph.

Continuous integration

• Survive an archived CRAN package, cache revdep compiles (@krlmlr, #242).

Documentation

• Switch to index.md (#111).

rprojroot 2.1.1.9016

Bug fixes

ci

• Backport kit fixes from rigraph, duckdb-r and dm.

rprojroot 2.1.1.9015

Continuous integration

• Wrap the commit status update into an action.

• Route ccache through one-word compiler wrappers on Unix.

• Name every step and restore the log entry setup-pandoc swallows.

rprojroot 2.1.1.9014

Features

• Align is_pkgdown_project with pkgdown > 2.0.9. (#104, #106).

• Avoid warnings on Windows network drives (#105).

Continuous integration

• Add sharded revdep2 workflow.

rprojroot 2.1.1.9013

Features

• Breaking change: The subdir argument to root_criterion() must have length one (#84, #102).

Chore

• Auto-update from GitHub Actions (#236).

Continuous integration

• Remove unused pr-commands workflow.

Documentation

• Clarify subdir argument (#103).

• Fix typo (@salim-b, #99).

Breaking changes

• Breaking change: The subdir argument to root_criterion() must have length one (#84, #102).

rprojroot 2.1.1.9012

Testing

• Replace mockr with testthat::local_mocked_bindings() (@salim-b, #97).

Uncategorized

• Ci: Link the responsible workflow run in snapshot update PRs (#96).

rprojroot 2.1.1.9011

Continuous integration

• Lock down format-suggest egress (audit → block).

rprojroot 2.1.1.9010

Bug fixes

ci

• Emit empty package matrix when there are no (rev)deps.

rprojroot 2.1.1.9009

Continuous integration

• Run on Ubuntu 26.04.

• Align workflows with template.

rprojroot 2.1.1.9008

Chore

• Auto-update from GitHub Actions (#230).

rprojroot 2.1.1.9007

Features

• Add is_renv_project criterion looking for an renv.lock file (@gadenbuie, #86).

Chore

• Auto-update from GitHub Actions (#228).

• Add ccache to .gitignore and .Rbuildignore.

Continuous integration

• Update ccache-action reference.

• Bump action version.

• Create snapshot update PR against correct branch.

• Add reference to /apply-patch workflow in commit message.

• Clarify rationale for not deploying on schedule.

• Only run fledge on pushes to main.

• Tweak fledge workflow and ccache action.

• Cosmetics.

• Bump action versions.

• Install clang-format-21.

• Align fledge workflow.

Documentation

• Add "Supported By Posit" badge to rprojroot website (@jeroenjanssens, #172).

• Compatibility with roxygen2 8.0.0.

rprojroot 2.1.1.9006

Chore

• Auto-update from GitHub Actions (#185).

rprojroot 2.1.1.9005

Continuous integration

• Fix comment (#183).

• Tweaks (#182).

• Test all R versions on branches that start with cran- (#181).

rprojroot 2.1.1.9004

Continuous integration

• Install binaries from r-universe for dev workflow (#179).

rprojroot 2.1.1.9003

Continuous integration

• Fix reviewdog and add commenting workflow (#177).

rprojroot 2.1.1.9002

Continuous integration

• Use workflows for fledge (#175).

rprojroot 2.1.1.9001

Continuous integration

• Sync (#173).

rprojroot 2.1.1.9000

Chore

• Auto-update from GitHub Actions (#170).

rprojroot 2.1.1 (2025-08-26)

Features

• is_vscode_project looks for .vscode/settings.json instead of just .vscode/ (#162, #163).

Documentation

• Use single quotes to avoid nested double quotes (#161).

rprojroot 2.1.0 (2025-07-12)

Bug fixes

• Fix example for find_root() (@salim-b, #98).

Features

• Add is_vscode_project criterion, true if a .vscode/ directory exists (#155, #157, @jennybc).

• New is_targets_project (@mitchelloharawild, #108, #146).

• Avoid warnings about invalid inputs with non-native encoding (@bastistician, #80).

• Align is_pkgdown_project with pkgdown > 2.0.9. (#104, #106).

• Avoid warnings on Windows network drives (#105).

Chore

• Rename is_root() to is_fs_root() to avoid confusion (#101).

Documentation

• Switch to index.md (#113).

• Clarify subdir argument (#103).

• Fix typo (@salim-b, #99).

Testing

• Replace mockr with testthat::local_mocked_bindings() (@salim-b, #97).

rprojroot 2.0.4 (2023-11-05)

Features

• Add is_renv_project criterion looking for an renv.lock file (@gadenbuie, #86).
• Add is_quarto_project criterion looking for a Quarto project (@olivroy, #91, #92).

Chore

• Update maintainer e-mail address.

Testing

• Wrap :: to skip if not installed in tests (#94).

rprojroot 2.0.3 (2022-04-02)

• Add is_pkgdown_project root criterion looking for a _pkgdown.yml, _pkgdown.yaml, pkgdown/_pkgdown.yml and/or inst/_pkgdown.yml file (#79, @salim-b).
• Avoid LazyData in DESCRIPTION.

rprojroot 2.0.2 (2020-11-15)

Features

• In find_root_file(), if the first path component is already an absolute path, the path is returned unchanged without referring to the root. This allows using both root-relative and absolute paths in here::here(). Mixing root-relative and absolute paths in the same call returns an error (#59).
• find_root_file() propagates NA values in path components. Using tidyverse recycling rules for path components of length different from one (#66).
• has_file() and has_file_pattern() gain fixed argument (#75).
• New is_drake_project criterion (#34).
• Add subdir argument to make_fix_file() (#33, @BarkleyBG).
• Update documentation for version control criteria (#35, @uribo).

Breaking changes

• has_file() and has_dir() now throw an error if the filepath argument is an absolute path (#74).
• has_basename() replaces has_dirname() to avoid confusion (#63).
• as_root_criterion() and is_root_criterion() replace as. and is., respectively. The latter are soft-deprecated.
• thisfile() and related functions are soft-deprecated, now available in the whereami package (#43).

Bug fixes

• The is_dirname() criterion no longer considers sibling directories (#44).

Internal

• Use testthat 3e (#70).
• The backports package is no longer imported (#68).
• Re-license as MIT (#50).
• Move checks to GitHub Actions (#52).
• Availability of suggested packages knitr and rmarkdown, and pandoc, is now checked before running the corresponding tests.

rprojroot 1.3-2 (2018-01-03)

• Availability of suggested packages knitr and rmarkdown, and pandoc, is now checked before running the corresponding tests.

rprojroot 1.3-1 (2017-12-18)

• Adapt to testthat 2.0.0.
• New thisfile(), moved from kimisc (#8).
• Add more examples to vignette (#26, @BarkleyBG).
• Detect .git directories created with git clone --separate-git-dir=... (#24, @karldw).

rprojroot 1.2 (2017-01-16)

• New root criteria

  • is_projectile_project recognize projectile projects (#21).
  • has_dir() constructs root criteria that check for existence of a directory.
  • is_git_root, is_svn_root and is_vcs_root look for a version control system root (#19).

• New function

  • get_root_desc() returns the description of the criterion that applies to a given root, useful for composite criteria created with |.

• Minor enhancements

  • Improve formatting of alternative criteria (#18).
  • If root cannot be found, the start path is shown in the error message.

• Internal

  • The $testfun member of the rprojroot S3 class is now a list of functions instead of a function.

rprojroot 1.1 (2016-10-29)

• Compatibility

  • Compatible with R >= 3.0.0 with the help of the backports package.

• New root criteria

  • is_remake_project and find_remake_root_file() look for remake project (#17).
  • is_testthat and find_testthat_root_file() that looks for tests/testthat root (#14).
  • from_wd, useful for creating accessors to a known path (#11).

• Minor enhancement

  • Criteria can be combined with the | operator (#15).

• Documentation

  • Add package documentation with a few examples (#13).
  • Clarify difference between find_file() and make_fix_file() in vignette (#9).
  • Remove unexported functions from documentation and examples (#10).
  • Use pkgdown to create website.

• Testing

  • Use Travis instead of wercker. Travis tests three R versions, and OS X.
  • Improve AppVeyor testing.

rprojroot 1.0-2 (2016-03-28)

• Fix test that fails on Windows only on CRAN.

rprojroot 1.0 (2016-03-26)

Initial CRAN release.

• S3 class root_criterion:

  • Member functions: find_file() and make_fix_file()
  • root_criterion()
  • as.root_criterion()
  • is.root_criterion()
  • has_file()
  • has_file_pattern()
  • Built-in criteria:
    • is_r_package
    • is_rstudio_project

• Getting started:

  • find_package_root_file()
  • find_rstudio_root_file()

• Use a custom notion of a project root:

  • find_root()
  • find_root_file()

• Vignette