Skip to content
forked from lionel-/codegrip

Reshaping and navigation commands for R code

License

Notifications You must be signed in to change notification settings

jennybc/codegrip

 
 

Repository files navigation

codegrip

Codecov test coverage R-CMD-check

codegrip provides RStudio addins and Emacs commands for reshaping R code and navigating across syntactic constructs.

Reshaping

addin_reshape lets you cycle between different shapes of function calls. For instance, reshaping transforms code from wide to long shape and vice versa.

Note that for function definitions, addin_reshape cycles through two different long shapes. The traditional L form uses more horizontal space whereas the flat form uses less horizontal space and the arguments are always aligned at double indent:

Navigating

There are currently two motions implemented in codegrip: outwards and inwards.

  • addin_move_inside finds the first opening delimiter ((, [, or {) after your cursor and steps inside it.

  • addin_move_outside finds the first opening delimiter before your cursor and steps outside it.

These motions are handy for quick navigation across to quickly jump from a function argument to the corresponding function call. From there, you can reshape the whole call using addin_reshape.

Installation

The package is not yet on CRAN but you can install the development version from GitHub with:

# install.packages("devtools")
devtools::install_github("lionel-/codegrip")

Setup

Suggested keybindings:

  • Alt + Tab: addin_reshape
  • Alt + 3: addin_move_outside
  • Alt + 4: addin_move_inside

Not yet implemented:

  • Alt + 1: addin_move_backwards
  • Alt + 2: addin_move_forwards

Roadmap

  • Forward and backward motions.

  • Adding arguments to a function call using forward backward motions.

  • Reshaping of repeated calls like foo(...)(...). This will help reshaping data.table pipelines, e.g. DT[...][...].

  • Reshaping of { expressions.

  • Reshaping of pipelines of binary operations, including pipes.

  • Columnar formatting of tibble::tribble() calls.

  • Selection of syntactic constructs, such as function arguments.

Limitations

codegrip currently uses the R parser to figure out the structure of your code. Because of this, it doesn't work with malformed or partially written code. Your whole file must be valid R code for codegrip commands to work.

About

Reshaping and navigation commands for R code

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • R 94.3%
  • Emacs Lisp 5.7%