Skip to content

toreriklinnerud/sublime-rubyfmt

Repository files navigation

sublime-rubyfmt

Sublime text plugin to autoformat Ruby code with Rubyfmt. If the file contains syntax errors it won't be formatted and the error is displayed in the Sublime status bar at the bottom of the editor window.

Dependencies

A ruby and rubyfmt executable is assumed to be in path but this can be overriden with absolute paths in the package settings ("ruby_executable" and "rubyfmt_executable" respectively).

Plugin installation

Through Sublime Package Control: Install Package -> Rubyfmt

Formatting code

On Windows/Linux: Alt + ; On MacOS: Cmd + ;

With a file open and syntax set to Ruby or Ruby on Rails, hit the above combination to apply auto format.

If your file contains syntax errors it won't be formatted. The syntax error will briefly flash in the Sublime Text status bar at the bottom of the editor window.

Format on Save / Other settings

Format on save is enabled by default but can be disabled from Sublime Text -> Preferences -> Package Settings -> Rubyfmt -> Settings - User and adding {"format_on_save: false"}.

All settings with default values:

{
  "ruby_executable": "ruby",
  "rubyfmt_executable": "rubyfmt",
  "format_on_save": true,
}

Troubleshooting

If execution of Ruby/Rubyfmt fails, debug information will be printed to the Sublime Text console: View -> Show Console