@prettier/plugin-ruby
prettier plugin for the Ruby programming language
Last updated 14 days ago by kddeisz .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @prettier/plugin-ruby 
SYNC missed versions from official npm registry.
Prettier Ruby

Prettier for Ruby

Gitter GitHub Actions NPM Version code style: prettier Follow+Prettier+on+Twitter

@prettier/plugin-ruby is a prettier plugin for the Ruby programming language and its ecosystem. prettier is an opinionated code formatter that supports multiple languages and integrates with most editors. The idea is to eliminate discussions of style in code review and allow developers to get back to thinking about code design instead.

For example, the below code segment:

        d=[30644250780,9003106878,
    30636278846,66641217692,4501790980,
 671_24_603036,131_61973916,66_606629_920,
   30642677916,30643069058];a,s=[],$*[0]
      s.each_byte{|b|a<<("%036b"%d[b.
         chr.to_i]).scan(/\d{6}/)}
          a.transpose.each{ |a|
            a.join.each_byte{\
             |i|print i==49?\
               ($*[1]||"#")\
                 :32.chr}
                   puts
                    }

when run through @prettier/plugin-ruby will generate:

d = [
  30_644_250_780,
  9_003_106_878,
  30_636_278_846,
  66_641_217_692,
  4_501_790_980,
  671_24_603036,
  131_61973916,
  66_606629_920,
  30_642_677_916,
  30_643_069_058
]
a, s = [], $*[0]
s.each_byte { |b| a << ('%036b' % d[b.chr.to_i]).scan(/\d{6}/) }
a.transpose.each do |a|
  a.join.each_byte { |i| print i == 49 ? ($*[1] || '#') : 32.chr }
  puts
end

Getting started

To run prettier with the Ruby plugin, you're going to need ruby (version 2.5 or newer) and node (version 8.3 or newer). If you're integrating with a project that is not already using prettier, you should use the Ruby gem. Otherwise you can use the npm package directly.

Note that currently the editor integrations work best with the npm package, as most of the major editor plugins expect a node_modules directory. You can get them to work with the Ruby gem, but it requires manually configuring the paths.

Ruby gem

Add this line to your application's Gemfile:

gem 'prettier'

And then execute:

bundle

Or install it yourself as:

gem install prettier

The rbprettier executable is now installed and ready for use:

bundle exec rbprettier --write '**/*.rb'

npm package

If you're using the npm CLI, then add the plugin by:

npm install --save-dev prettier @prettier/plugin-ruby

Or if you're using yarn, then add the plugin by:

yarn add --dev prettier @prettier/plugin-ruby

The prettier executable is now installed and ready for use:

./node_modules/.bin/prettier --write '**/*.rb'

Configuration

Below are the options (from src/ruby.js) that @prettier/plugin-ruby currently supports:

API Option CLI Option Default Description
printWidth --print-width 80 Same as in Prettier (see prettier docs).
requirePragma --require-pragma false Same as in Prettier (see prettier docs).
tabWidth --tab-width 2 Same as in Prettier (see prettier docs).
addTrailingCommas --add-trailing-commas false Adds a trailing comma to array literals, hash literals, and method calls.
inlineConditionals --inline-conditionals true When it fits on one line, allows if and unless statements to use the modifier form.
inlineLoops --inline-loops true When it fits on one line, allows while and until statements to use the modifier form.
preferHashLabels --prefer-hash-labels true When possible, uses the shortened hash key syntax, as opposed to hash rockets.
preferSingleQuotes --prefer-single-quotes true When double quotes are not necessary for interpolation, prefers the use of single quotes for string literals.

Any of these can be added to your existing prettier configuration file. For example:

{
  "preferSingleQuotes": false
}

Or, they can be passed to prettier as arguments:

prettier --prefer-single-quotes false --write '**/*.rb'

Contributing

Check out our contributing guide. Bug reports and pull requests are welcome on GitHub at https://github.com/prettier/plugin-ruby.

Code

Thanks goes to these wonderful people (emoji key):


Kevin Deisz

???? ???? ⚠️ ????

Alan Foster

???? ???? ⚠️ ????

johnschoeman

⚠️

Aaron Jensen

????

Cameron Bothner

????

localhost.dev

???? ????

David Buchan-Swanson

???? ????

Jordan Pickwell

????

Josh Justice

????

xipgroc

????

Gregoire Lejeune

????

Pete Van Klaveren

????

meleyal

????

Lipis

????

Jan Piotrowski

????

Andy Waite

????

Jonathan Viney

????

acrewdson

????

Louis Orleans

????

Colton Voege

????

Stefan Kracht

????

jakeprime

????

Mario Mainz

????

CL Web Developers

????

github0013

????

James Costian

????

Joe Jackson

????

Max Albrecht

????

Matt

???? ????

Vesa Laakso

????

jrdioko

????

gin0606

???? ????

Tobyn

????

Ian Ker-Seymer

????

Richard Huang

????

Patrick Ellis

????

Peter De Berdt

????

Chris Hafley

????

Thomas Frütel

????

Alex Serban

????

Stephanie

????

Shay Davidson

????

Ryan Hunter

????

Jan Klimo

????

Rick Sullivan

???? ????

Stephen O'Brien

????

Nimish Mehta

???? ????

This project follows the all-contributors specification. Contributions of any kind welcome!

Financial

You can support prettier/plugin-ruby on OpenCollective. Your organization's logo will show up here with a link to your website.

License

The package is available as open source under the terms of the MIT License.

Current Tags

  • 0.20.1                                ...           latest (14 days ago)

37 Versions

  • 0.20.1                                ...           14 days ago
  • 0.20.0                                ...           21 days ago
  • 0.19.1                                ...           a month ago
  • 0.19.0                                ...           2 months ago
  • 0.18.2                                ...           5 months ago
  • 0.18.1                                ...           5 months ago
  • 0.18.0                                ...           6 months ago
  • 0.17.0                                ...           9 months ago
  • 0.16.0                                ...           10 months ago
  • 0.15.1                                ...           10 months ago
  • 0.15.0                                ...           a year ago
  • 0.14.0                                ...           a year ago
  • 0.13.0                                ...           a year ago
  • 0.12.3                                ...           a year ago
  • 0.12.2                                ...           a year ago
  • 0.12.1                                ...           a year ago
  • 0.12.0                                ...           a year ago
  • 0.11.0                                ...           a year ago
  • 0.10.0                                ...           a year ago
  • 0.9.1                                ...           a year ago
  • 0.9.0                                ...           2 years ago
  • 0.8.0                                ...           2 years ago
  • 0.7.0                                ...           2 years ago
  • 0.6.3                                ...           2 years ago
  • 0.6.2                                ...           2 years ago
  • 0.6.1                                ...           2 years ago
  • 0.6.0                                ...           2 years ago
  • 0.5.1                                ...           2 years ago
  • 0.5.0                                ...           2 years ago
  • 0.4.1                                ...           2 years ago
  • 0.4.0                                ...           2 years ago
  • 0.3.7                                ...           2 years ago
  • 0.3.6                                ...           2 years ago
  • 0.3.5                                ...           2 years ago
  • 0.3.4                                ...           2 years ago
  • 0.3.3                                ...           2 years ago
  • 0.3.2                                ...           2 years ago
Downloads
Today 0
This Week 4
This Month 45
Last Day 4
Last Week 15
Last Month 116
Dependencies (1)
Dev Dependencies (6)

Copyright 2014 - 2016 © taobao.org |