shallowify: Shallowify the parse table
In styler: Non-Invasive Pretty Printing of R Code
shallowify R Documentation
Shallowify the parse table
Description
Cached expressions don't need to be transformed with transformers in
parse_transform_serialize_r_block(), we simply return text for the
top-level token.
Usage
shallowify(pd)
Details
Expressions that are cached are already styled correctly. We can make the
parse table shallow at these locations, fully relying on the text column:
remove all children, as they are not needed anymore.
mark the expression as a terminal.
Top-level comments
Note that we do not cache top-level comments. Because package code has a lot
of roxygen comments and each of them is a top-level expression, checking is
very expensive. More expensive than styling, because comments are always
terminals. This will also yield large speed improvements in
compute_parse_data_nested() because nesting is expensive and will not be
done for cached expressions.
Implementation
Because the structure of the parse table is not always "top-level expression
first, then children", this function creates a temporary parse table that has
this property and then extract the ids and subset the original parse table so
it is shallow in the right places.
styler documentation built on Aug. 29, 2023, 5:10 p.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
| shallowify | R Documentation |
Shallowify the parse table
Description
Cached expressions don't need to be transformed with transformers in
parse_transform_serialize_r_block(), we simply return text for the
top-level token.
Usage
shallowify(pd)
Details
Expressions that are cached are already styled correctly. We can make the
parse table shallow at these locations, fully relying on the text column:
remove all children, as they are not needed anymore.
mark the expression as a terminal.
Top-level comments
Note that we do not cache top-level comments. Because package code has a lot
of roxygen comments and each of them is a top-level expression, checking is
very expensive. More expensive than styling, because comments are always
terminals. This will also yield large speed improvements in
compute_parse_data_nested() because nesting is expensive and will not be
done for cached expressions.
Implementation
Because the structure of the parse table is not always "top-level expression first, then children", this function creates a temporary parse table that has this property and then extract the ids and subset the original parse table so it is shallow in the right places.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.