(cache) Rubyを使っているプロジェクトのコーディング規約を見てみよう【Ginza.rb #20】

2015/2/17にみんなのウェディングさんで開催された『Ginza.rb 第20回 Rubyを使っているプロジェクトのコーディング規約を見てみよう』に参加してきました。コーディング規約をじっくり議論出来る場所はなかなか無いので、かなり面白かったです！

スタイルガイド

今回Ginza.rbで一緒に読んだコーディング規約。

Rubyのコーディング規約

ruby-style-guide/README.ja.md at japanese · fortissimo1997/ruby-style-guide

Railsのコーディング規約

rails-style-guide/README-jaJA.md at master · satour/rails-style-guide

面白かった規約

議論に聞き入りすぎてて、あんまりメモしきれませんでしたが今日から使いたいコーディング規約の俺得メモです。

whenはcaseと同じ深さに揃える

このスタイルは”The Ruby Programming Language”、”Programming Ruby” 双方で確率されている。 matzのオススメ「良い例」だそうです！

# 悪い例
case
  when song.name == 'Misty'
    puts 'Not again!'
  when song.duration > 120
    puts 'Too long!'
  when Time.now.hour > 21
    puts "It's too late"
  else
    song.play
end

# 良い例
case
when song.name == 'Misty'
  puts 'Not again!'
when song.duration > 120
  puts 'Too long!'
when Time.now.hour > 21
  puts "It's too late"
else
  song.play
end

なぜRubyのcase/whenはインデントしないのかを考えてみた - give IT a try

大きな数にはアンダースコアを入れる

ついつい忘れがちだけど大切！

# 悪い例 - 0はいくつありますか？
num = 1000000

# 良い例 - 人の頭でもより簡単に解析できます
num = 1_000_000

Railsの国際化(i18n)の「lazy lookup」について

辞書ファイルで下のように訳語が定義されている場合、app/views/users/show.html.hamlでは下記の呼び出し方でusers.show.titleを呼び出すことができます。このような呼び出し方を “lazy lookup” と呼びます。

# config/locales/en.yml
en:
  users:
    show:
      title: 'User details page'

# app/views/users/show.html.haml
## 悪い例
= t users.show.title

## 良い例
= t '.title'