Style all files in a project. Implemented as a wrapper for styler::style_dir()
that defaults
to styling .R
, .Rprofile
, .Rmd
, .Rmarkdown
, .Rnw
, and .qmd
files, excluding
files in packrat
, renv
, and R/RcppExports.R
.
Arguments
- path
Path to a directory with files to transform.
- filetype
Vector of file extensions indicating which file types should be styled. Case is ignored, and the
.
is optional, e.g.c(".R",".Rmd")
, orc("r", "rmd")
. Supported values (after standardization) are: "qmd", "r", "rmd", "rmarkdown", "rnw", and "rprofile". Rmarkdown is treated as Rmd.- exclude_dirs
Character vector with directories to exclude (recursively).
- exclude_files
Character vector with regular expressions to files that should be excluded from styling.
- ...
Arguments passed on to
styler::style_dir
style
A function that creates a style guide to use, by default
tidyverse_style
. Not used further except to construct the argumenttransformers
. Seestyle_guides()
for details.transformers
A set of transformer functions. This argument is most conveniently constructed via the
style
argument and...
. See 'Examples'.recursive
A logical value indicating whether or not files in sub directories of
path
should be styled as well.include_roxygen_examples
Whether or not to style code in roxygen examples.
base_indention
Integer scalar indicating by how many spaces the whole output text should be indented. Note that this is not the same as splitting by line and add a
base_indention
spaces before the code in the case multi-line strings are present. See 'Examples'.dry
To indicate whether styler should run in dry mode, i.e. refrain from writing back to files .
"on"
and"fail"
both don't write back, the latter returns an error if the input code is not identical to the result of styling. "off", the default, writes back if the input and output of styling are not identical.