Learn R Programming

⚠️There's a newer version (1.10.3) of this package.Take me there.

styler

Overview

styler formats your code according to the tidyverse style guide (or your custom style guide) so you can direct your attention to the content of your code. It helps to keep the coding style consistent across projects and facilitate collaboration. You can access styler through

the RStudio Addin as demonstrated below
R functions like style_pkg(), style_file() or style_text()
various other tools described in vignette("third-party-integrations")

Installation

You can install the package from CRAN.

install.packages("styler")

Or get the development version from GitHub:

# install.packages("remotes")
remotes::install_github("r-lib/styler")

Documentation

The following online docs are available:

Copy Link

Version

Install

install.packages('styler')

Monthly Downloads

45,169

Version

1.10.1

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Repository

https://github.com/r-lib/styler

Homepage

https://styler.r-lib.org

Maintainer

Lorenz Walthert

Last Published

June 5th, 2023

Functions in styler (1.10.1)

alignment_ensure_trailing_comma

Ensure last pd has a trailing comma

alignment_ensure_no_closing_brace

Ensure the closing brace of the call is removed

apply_stylerignore

Ensure correct positional information for stylerignore expressions

apply_ref_indention

Apply reference indention to tokens

add_stylerignore

Adds the stylerignore column

alignment_has_correct_spacing_around_comma

Check if spacing around comma is correct

add_token_terminal

Add information about previous / next token to each terminal

apply_ref_indention_one

Applying reference indention of a target token

alignment_has_correct_spacing_around_eq_sub

Check if spacing around = is correct

alignment_serialize_column

Serialize all lines for a given column

assert_filetype

Make sure all supplied file types are allowed

assert_transformers

Assert the transformers

Check token validity

Assert text to be of positive length and replace it with the empty string otherwise.

cache_more_specs

Create more specs

Make a key for R.cache

choose_indention

Choose the indention method for the tokens

cache_by_expression

apply_transformers

Apply transformers to a parse table

compute_indent_indices

Compute the indices that need indention

alignment_serialize

Serialize text from a parse table

Create valid pos_ids if possible

contains_else_expr_that_needs_braces

Check whether an else expression needs braces

Create a terminal token

compute_parse_data_nested

Obtain a nested parse table from a character vector

create_style_guide

Create a style guide

create_node_from_nested_root

Convert a nested data frame into a node tree

context_towards_terminals

Update the a parse table given outer context

combine_children

Combine child and internal child

construct_vertical

Construct an object of class vertical

Clear the cache

dir_without_._one

dir(), but with full names, ignored case, and included hidden files and recursive.

bind_with_child

Bind a parse table with one of its children

Create a tree from text

dir(), but without dot-prefix and different defaults

Invoke a system command

create_node_from_nested

Create node from nested parse data

context_to_terminals

Propagate context to terminals

ensure_last_n_empty

Ensure there is one (and only one) blank line at the end of a vector

alignment_serialize_line

Serialize one line for a column

catch_style_file_output

Capture and post-process the output of style_file without causing side effects

find_blank_lines_to_next_block

Number of lines between cache blocks

finalize_raw_chunks

Drop start / stop, when formatting is turned off

Activate or deactivate the styler cache

get_engine_pattern

What's the engine pattern for rmd code chunks?

Construct paths of a tree object given the paths of *-in.R files

convert_newlines_to_linebreaks

Replace the newline character with a line break

enrich_terminals

Enrich flattened parse table

Construct *-out.R from a *-in.R

ensure_correct_txt

Ensure a correct text of all strings and numeric constants

copy_to_tempdir

Copy a file to a temporary directory

Remember the past to be quicker in the future

Write to the cache

Obtain robust parse data

default_style_guide_attributes

Initialize default style guide attributes

get_knitr_pattern

Get chunk pattern

hash_standardize

Standardize text for hashing

has_crlf_as_first_line_sep

Check if a string uses CRLF EOLs

identify_raw_chunks

Identifies raw Rmd or Rnw code chunks

delete_if_cache_directory

Delete a cache or temp directory

Convert roxygen comments to Rd code

Identify comments that are shebangs

local_test_setup

Establish testing setup for current environment

parse_transform_serialize_r_block

Parse, transform and serialize a nested parse table

parse_transform_serialize_r

Parse, transform and serialize text

expressions_are_identical

Check whether two expressions are identical

The elements that are added to this environment are:

find_line_break_position_in_multiline_call

Find index of the token before which the line should be broken

pd_is_multi_line

Check whether a parse table is a multi-line token

find_pos_id_to_keep

Find the pos ids to keep

post_parse_roxygen

Changing the line definition

Specify what is re-indented how

Drop-in replacement for xfun::read_utf8(), with an optional warn argument.

flatten_operators

Flatten some token in the nested parse table based on operators

cache_find_block

Find the groups of expressions that should be processed together

Check if text is cached

Replace single quotes with double quotes

set_regex_indention

Set indention of tokens that match regex

enhance_mapping_special

Enhance the mapping of text to the token "SPECIAL"

Print styled code

needs_indention

Check whether indention is needed

Tell me what the next terminal is

n_times_faster_with_cache

Times two function calls with temporarily enabled cache

Get the value of an option

is_code_chunk_header_or_xaringan_or_code_output

Identify spinning code chunk header or xaringan

identify_start_to_stop_of_roxygen_examples_from_text

Figure out where code examples start and stop

if_for_while_part_requires_braces

Check if if, for or while loop expression require a braces.

cache_find_path

Where is the cache?

lookup_new_special

Lookup which new tokens were created from "SPECIAL"

next_non_comment

Find the index of the next or previous non-comment in a parse table.

separate_chunks

Separate chunks within Rmd and Rnw contents

Lookup all tokens that have a unique token-text mapping

nest_parse_data

Nest a flat parse table

find_blank_lines_to_next_expr

Find blank lines

env_add_stylerignore

Add positional information of token to next terminal

Find dontrun and friend sequences

style_space_around_token

Set spacing of token to a certain level

set_line_break_around_curly_curly

Styling around \{\{

set_line_break_before_curly_opening

Set line break before a curly brace

style_roxygen_example_snippet

Given a code snippet is dont* or run, style it

style_roxygen_code_example_segment

Style a roxygen code example segment

is_double_indent_function_declaration

Is the function declaration double indented?

flatten_operators_one

Flatten one level of nesting with its child

set_space_around_op

Set spaces around operators

Flatten a parse table

Helper for setting spaces

find_tokens_to_update

Find the tokens to update when applying a reference indention

find_start_pos_id

Find legit starting value for a new positional id

set_arg_write_tree

Set the write_tree argument

generate_test_samples

Generate a comprehensive collection test cases for comment / insertion interaction Test consist of if / if-else / if-else-if-else cases, paired with various line-break and comment configurations. Used for internal testing.

serialize_parse_data_flattened

Serialize flattened parse data

Show information about the styler cache

get_addins_style_transformer_name

Return the style function or name

math_token_spacing

Specify spacing around math tokens

specify_transformers_drop

Specify which tokens must be absent for a transformer to be dropped

What is a parse table representing?

parser_version_set

Work with parser versions

Prettify arbitrary R code

Style files with R source code

set_style_transformers

Asks the user to supply a style

match_stop_to_start

Match a stop candidate to a start

roxygen_remove_extra_brace

Fix tools::parse_Rd() output

Repeat elements of a character vector times times and collapse it

tidyverse_style

The tidyverse style

stylerignore_consolidate_col

Consolidate columns after a merge

test_collection

Run a collection of tests

set_line_break_after_opening_if_call_is_multi_line

Sets line break after opening parenthesis

text_to_flat_pd

Creates a flat parse table with minimal initialization

transform_mixed

Transform mixed contents

is_insufficiently_parsed_string

Identify strings that were not fully parsed

cache_is_activated

Check if a cache is activated

start_comments_with_space

Start comments with a space

verify_roundtrip

Verify the styling

transform_mixed_non_empty

Ensure for .Rmd and friends that a code chunk without code is formatted as a code chunk without any lines.

wrap_if_else_while_for_fun_multi_line_in_curly

Wrap if-else, while and for statements in curly braces

try_transform_as_r_file

Style a file as if it was an .R file

needs_rd_emulation

Check if rd emulation is required with roxygen2::roc_proc_text()

needs_indention_one

Check whether indention is needed

split_roxygen_segments

Split text into roxygen and non-roxygen example segments

style_active_pkg

Wrapper around style_pkg() for access via Addin.

transformers_drop

Remove transformers that are not needed

Prettify R code in current working directory

communicate_summary

Communicate the summary of styling

wrap_multiline_curly

Wrap a multi-line statement in curly braces

Test the dry argument

Prettify R source code

remove_dont_mask

Remove dont* mask

test_transformer

Transforming test input with a transformer function

set_space_between_eq_sub_and_comma

Set space between EQ_SUB and "','"

Stylers for RStudio Addins

remove_roxygen_header

Remove roxygen header

Prettify a package

set_line_break_if_call_is_multi_line

Set line break for multi-line function calls

style_selection

Styles the highlighted selection in a .R or .Rmd file.

Set the multi-line column

communicate_warning

Communicate a warning if necessary

test_transformers_drop

Test transformers_drop for consistency

style_space_around_math_token

Style spacing around math tokens

Create the path to a test that file

Turn off styling for parts of the code

style_roxygen_code_example_one

Style a roxygen code example with exactly one @example or @exampleIf

token_is_on_aligned_line

Check if tokens are aligned

style_roxygen_code_example

Style a roxygen code example that may contain dontrun and friends

set_space_between_levels

Set space between levels of nesting

Obtain token table from text

extend_if_comment

Find the index of the last comment in the sequence of comments-only tokens after the token that has position pos in pd.

update_indention

Update indention information of parse data

Non-invasive pretty printing of R code

style_text_without_curly_curly

style_text() without rules for \{\{

Transform a file and output a customized message

Apply a function to the contents of a file

transform_files

Transform files with transformer functions

update_indention_ref

Update the indention reference

transform_utf8_one

Potentially transform a file

extract_terminals

Extract terminal tokens

Transform a flat parse table with a list of transformers

initialize_attributes

Initialize attributes

wrap_expr_in_expr

Wrap an expression into an expression

wrap_expr_in_curly

Wrap an expression in curly braces

wrap_else_multiline_curly

Add curly braces to else

wrap_subexpr_in_curly

Wrap a sub-expression in curly braces

Drop-in replacement for xfun::write_utf8()

map_filetype_to_pattern

Map the file type to a corresponding regular expression

Parse roxygen comments into text

make_transformer

Closure to return a transformer function

parse_transform_serialize_roxygen

Parse, transform and serialize roxygen comments

Standardize paths in root

parse_tree_must_be_identical

Check whether a round trip verification can be carried out

Drop-in replacement for xfun:::invalid_utf8()

Save parsing from text

scope_normalize

Convert the styling scope to its lower-level representation

Shallowify the parse table

save_after_styling_is_active

Heuristic to see if a file styled with the addin should be saved or not.

set_and_assert_arg_filetype

Set the file type argument

set_unindention_child

Unindent a child if necessary

transform_and_check

Transform a file an check the result

Transform code from R, Rmd or Rnw files

Unindent a child

unindent_fun_dec

Revert the indention of function declaration header

update_newlines

Update the newlines attribute

validate_new_pos_ids

Validate sequence of new position ids

add_id_and_short

Add column pos_id and short

alignment_drop_comments

Remove all comment tokens

alignment_drop_last_expr

Remove last expression

add_spaces_or_newlines

Concentrate newlines or spaces in a string

add_cache_block

Add the block id to a parse table

alignment_col1_all_named

Checks if all arguments of column 1 are named

add_roxygen_mask

Add the roxygen mask to code