Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

stylerignore

Turn off styling for parts of the code


Description

Using stylerignore markers, you can temporarily turn off styler. Beware that for styler > 1.2.0, some alignment is detected by styler, making stylerignore redundant. See a few illustrative examples below.

Details

Styling is on by default when you run styler.

  • To mark the start of a sequence where you want to turn styling off, use # styler: off.

  • To mark the end of this sequence, put # styler: on in your code. After that line, styler will again format your code.

  • To ignore an inline statement (i.e. just one line), place # styler: off at the end of the line. Note that inline statements cannot contain other comments apart from the marker, i.e. a line like 1 # comment # styler: off won't be ignored.

To use something else as start and stop markers, set the R options styler.ignore_start and styler.ignore_stop using options(). If you want these settings to persist over multiple R sessions, consider setting them in your R profile, e.g. with usethis::edit_rprofile().

Examples

# as long as the order of the markers is correct, the lines are ignored.
style_text(
  "
  1+1
  # styler: off
  1+1
  # styler: on
  1+1
  "
)

# if there is a stop marker before a start marker, styler won't be able
# to figure out which lines you want to ignore and won't ignore anything,
# issuing a warning.
## Not run: 
style_text(
  "
  1+1
  # styler: off
  1+1
  # styler: off
  1+1
  "
)

## End(Not run)
# some alignment of code is detected, so you don't need to use stylerignore
style_text(
  "call(
    xyz =  3,
    x   = 11
  )"
)

styler

Non-Invasive Pretty Printing of R Code

v1.4.1
MIT + file LICENSE
Authors
Kirill Müller [aut], Lorenz Walthert [cre, aut]
Initial release

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.