Style .R, .Rmd or .Rnw files
Performs various substitutions in the files specified. Carefully examine the results after running this function!
style_file( path, ..., style = tidyverse_style, transformers = style(...), include_roxygen_examples = TRUE, base_indention = 0, dry = "off" )
path |
A character vector with paths to files to style. |
... |
Arguments passed on to the |
style |
A function that creates a style guide to use, by default
|
transformers |
A set of transformer functions. This argument is most
conveniently constructed via the |
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 |
dry |
To indicate whether styler should run in dry mode, i.e. refrain
from writing back to files . |
UTF-8 encoding is assumed. Please convert your code to UTF-8 if necessary before applying styler.
Invisibly returns a data frame that indicates for each file considered for
styling whether or not it was actually changed (or would be changed when
dry is not "off").
This function overwrites files (if styling results in a change of the
code to be formatted and dry = "off"). It is strongly suggested to only
style files that are under version control or to create a backup copy.
We suggest to first style with scope < "tokens" and inspect and commit
changes, because these changes are guaranteed to leave the abstract syntax
tree (AST) unchanged. See section 'Round trip validation' for details.
Then, we suggest to style with scope = "tokens" (if desired) and carefully
inspect the changes to make sure the AST is not changed in an unexpected way
that invalidates code.
The following section describes when and how styling is guaranteed to yield correct code.
If tokens are not in the styling scope (as specified with the scope
argument), no tokens are changed and the abstract syntax tree (AST) should
not change.
Hence, it is possible to validate the styling by comparing whether the parsed
expression before and after styling have the same AST.
This comparison omits roxygen code examples and comments. styler throws an
error if the AST has changed through styling.
Note that if tokens are to be styled, such a comparison is not conducted because the AST might well change and such a change is intended. There is no way styler can validate styling, that is why we inform the user to carefully inspect the changes.
See section 'Warning' for a good strategy to apply styling safely.
Other stylers:
style_dir(),
style_pkg(),
style_text(),
styler_addins
file <- tempfile("styler", fileext = ".R")
xfun::write_utf8("1++1", file)
# the following is identical (because of ... and defaults),
# but the first is most convenient:
style_file(file, strict = TRUE)
style_file(file, style = tidyverse_style, strict = TRUE)
style_file(file, transformers = tidyverse_style(strict = TRUE))
# only style indention and less invasive levels (i.e. spaces)
style_file(file, scope = "indention", strict = TRUE)
# name levels explicitly to not style less invasive levels
style_file(file, scope = I(c("tokens", "spaces")), strict = TRUE)
xfun::read_utf8(file)
unlink(file)Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.