{"Package":"styler","Type":"Package","Title":"Non-Invasive Pretty Printing of R Code","Version":"1.2.0","Authors@R":"\nc(person(given = \"Kirill\",\nfamily = \"Mller\",\nrole = \"aut\",\nemail = \"krlmlr+r@mailbox.org\"),\nperson(given = \"Lorenz\",\nfamily = \"Walthert\",\nrole = c(\"cre\", \"aut\"),\nemail = \"lorenz.walthert@icloud.com\"))","Description":"Pretty-prints R code without changing the user's\nformatting intent.","License":"GPL-3","URL":"https://github.com/r-lib/styler","BugReports":"https://github.com/r-lib/styler/issues","Imports":"backports (>= 1.1.0), cli (>= 1.1.0), magrittr (>= 1.0.1),\npurrr (>= 0.2.3), rematch2 (>= 2.0.1), rlang (>= 0.1.1),\nrprojroot (>= 1.1), tibble (>= 1.4.2), tools, withr (>= 1.0.0),\nxfun (>= 0.1)","Suggests":"data.tree (>= 0.1.6), dplyr, here, knitr, prettycode,\nrmarkdown, rstudioapi (>= 0.7), testthat (>= 2.1.0)","VignetteBuilder":"knitr","Encoding":"UTF-8","LazyData":"true","RoxygenNote":"6.1.1","Collate":"'addins.R' 'communicate.R' 'compat-dplyr.R' 'compat-tidyr.R'\n'detect-alignment-utils.R' 'detect-alignment.R'\n'environments.R' 'expr-is.R' 'indent.R' 'initialize.R' 'io.R'\n'nest.R' 'nested-to-tree.R' 'parse.R' 'reindent.R'\n'token-define.R' 'relevel.R' 'roxygen-examples-add-remove.R'\n'roxygen-examples-find.R' 'roxygen-examples-parse.R'\n'roxygen-examples.R' 'rules-line-break.R' 'rules-other.R'\n'rules-replacement.R' 'rules-spacing.R' 'serialize.R'\n'set-assert-args.R' 'style-guides.R' 'styler.R'\n'testing-mocks.R' 'testing-public-api.R' 'testing.R'\n'token-create.R' 'transform-code.R' 'transform-files.R' 'ui.R'\n'unindent.R' 'utils-files.R' 'utils-navigate-nest.R'\n'utils-strings.R' 'utils.R' 'vertical.R' 'visit.R' 'zzz.R'","NeedsCompilation":"no","Packaged":"2019-10-17 18:22:11 UTC; lorenz","Author":"Kirill Mller [aut],\nLorenz Walthert [cre, aut]","Maintainer":"Lorenz Walthert ","Repository":"CRAN","Date/Publication":"2019-10-17 20:20:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/styler_1.2.0.tar.gz","jsonAuthors":[{"name":"Kirill Mller","email":"krlmlr+r@mailbox.org","maintainer":false},{"name":"Lorenz Walthert","email":"lorenz.walthert@icloud.com","maintainer":true}],"readme":"\n\n\n# styler\n\n[![Build\nStatus](https://travis-ci.org/r-lib/styler.svg?branch=master)](https://travis-ci.org/r-lib/styler)\n[![AppVeyor Build\nStatus](https://ci.appveyor.com/api/projects/status/github/r-lib/styler?branch=master&svg=true)](https://ci.appveyor.com/project/r-lib/styler)\n[![lifecycle](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://www.tidyverse.org/lifecycle/#stable)\n[![codecov](https://codecov.io/gh/r-lib/styler/branch/master/graph/badge.svg)](https://codecov.io/gh/r-lib/styler)\n[![cran\nversion](https://www.r-pkg.org/badges/version/styler)](https://cran.r-project.org/package=styler)\n\nThe goal of styler is to provide non-invasive pretty-printing of R\nsource code while adhering to the\n[tidyverse](https://style.tidyverse.org) formatting rules. styler can be\ncustomized to format code according to other style guides too.\n\n## Installation\n\nYou can install the package from CRAN:\n\n``` r\ninstall.packages(\"styler\")\n```\n\nOr get the development version from GitHub:\n\n``` r\n# install.packages(\"remotes\")\nremotes::install_github(\"r-lib/styler\")\n```\n\n## API\n\nYou can style a simple character vector of code with `style_text()`:\n\n``` r\nlibrary(\"styler\")\nugly_code <- \"a=function( x){1+1} \"\nstyle_text(ugly_code)\n#> a <- function(x) {\n#> 1 + 1\n#> }\n```\n\nThere are a few variants of `style_text()`:\n\n - `style_file()` styles .R and/or .Rmd files.\n - `style_dir()` styles all .R and/or .Rmd files in a directory.\n - `style_pkg()` styles the source files of an R package.\n - RStudio Addins for styling the active file, styling the current\n package and styling the highlighted code\nregion.\n\n

\n\n## Functionality of styler\n\n**scope**\n\nYou can decide on the level of invasiveness with the scope argument. You\ncan style:\n\n - just spaces.\n - spaces and indention.\n - spaces, indention and line breaks.\n - spaces, indention, line breaks and tokens.\n\n\n\n``` r\nugly_code <- \"a=function( x){1+1} \"\nstyle_text(ugly_code, scope = \"spaces\")\n#> a = function(x) {1 + 1}\n```\n\nNote that compared to the default used above `scope = \"tokens\"`:\n\n - no line breaks were added.\n - `<-` was not replaced with `=`.\n\nWhile spaces still got styled (around `=` in `(x)`).\n\n**strict**\n\nIf you wish to keep alignment as is, you can use `strict = FALSE`:\n\n``` r\nstyle_text(\n c(\n \"first <- 4\",\n \"second <- 1+1\"\n ),\n strict = FALSE\n)\n#> first <- 4\n#> second <- 1 + 1\n```\n\nThis was just the tip of the iceberg. Learn more about customization\nwith the tidyverse style guide in in this\n[vignette](https://styler.r-lib.org/articles/introducing_styler.html). If\nthis is not flexible enough for you, you can implement your own style\nguide, as explained in the corresponding\n[vignette](https://styler.r-lib.org/articles/customizing_styler.html).\n\n## Adaption of styler\n\nstyler functionality is made available through other packages, most\nnotably\n\n - `usethis::use_tidy_style()` styles your project according to the\n tidyverse style guide.\n - `reprex::reprex(style = TRUE)` to prettify reprex code before\n printing. To permanently use `style = TRUE` without specifying it\n every time, you can add the following line to your `.Rprofile` (via\n `usethis::edit_r_profile()`): `options(reprex.styler = TRUE)`.\n - you can pretty-print your R code in RMarkdown reports without having\n styler modifying the source. This feature is implemented as a code\n chunk option in knitr. use `tidy = \"styler\"` in the header of a code\n chunks (e.g. ` ```{r name-of-the-chunk, tidy = \"styler\"}`), or\n `knitr::opts_chunk$set(tidy = \"styler\")` at the top of your\n RMarkdown script.\n - as a pre-commit hook `style-files` in\n .\n - pretty-printing of [drake](https://github.com/ropensci/drake)\n workflow data frames with `drake::drake_plan_source()`.\n - Adding styler as a fixer to the [ale\n Plug-in](https://github.com/w0rp/ale/pull/2401#issuecomment-485942966)\n for VIM.\n\n## Further resources\n\n - The official [web documentation](https://styler.r-lib.org/) of\n styler, containing various vignettes function documentation as well\n as a change-log.\n - [Blog\n post](https://lorenzwalthert.netlify.com/post/customizing-styler-the-quick-way/)\n about how you can customize styler without being an expert.\n - A [tidyverse.org blog\n post](https://www.tidyverse.org/articles/2017/12/styler-1.0.0/)\n introducing the functionality of styler.\n - The wiki of [Google Summer of Code\n 2017](https://github.com/rstats-gsoc/gsoc2017/wiki/Noninvasive-source-code-formatting)\n or the [pkgdown](https://r-lib.github.io/styler/) page contain\n information related to the initial development phase during Google\n Summer of Code 2017.","jobInfo":{"package":"styler","version":"1.2.0","parsingStatus":"success","parserVersion":1,"parsedAt":"2020-02-11T00:30:32+0000"}}

Description

Usage

Arguments