Rubyにおいてインデントが深くならないキレイな書き方を教えて下さい。

Question

いつもお世話になっております。

###背景
ちょっとした単純作業を効率化すべき主にRubyでコードを書いています。
CSVやJSONを取り扱うことが多く、コードを書く際、if や for を多様します。
そうするとインデントが深くなってしまいコードがとても見にくくなってします。
エディターをブラウザと分割して表示しており、エディターの横幅に限界があります。

###試したこと
そこで私がとっている対策は、長いコードを何分割かにして関数化しています。
動作1→動作2→動作3という感じに関数化し分割しています。
しかしこれでは分割し関数化にしたコードを再利用しませんし、使い方が間違っていると思い腑に落ちません。

###質問

1. インデントが深くなることは、良くないことなのでしょうか？

私にはコードが見づらいので、インデントを多様することにメリットを感じません。

1. forやifを多様せず、効率よく書く方法はないのでしょうか？

JSONを扱っているとfor-if-forのように入れ子になるケースが多くと感じます。

1. ユーザースクリプトを主に書いております。長いコードは、文章のように上から下へコードの流れを書くのが可読性が高いと思っています。

ただ長くなってしまうとインデントが雪だるま式に増えてしまいます。何か対策はないのでしょうか？

Comments

[nskydiving]

コードによってやり方が変わってくると思いますので、インデントが深いと感じていらっしゃる具体的なコードを提示していただけますでしょうか。

[stdio]

C++などではどうしてもインデントが深くなってしまう事が多々あります。
その上JSONのデータは多重リスト形式になっている事が多い為、インデントが深くなってしまう又は事は避けられないようなことも良くあります。この辺は再起処理で対応しても良いのですが、仕組みを理解していないと苦しい節があるのと、拡張性がなくなるのでおススメはしませんがインデント減らしには最適です。
あと、80文字で改行してくれるようなエディタもありますので使ってみるのも手かと思います。

Answer 1

しかしこれでは分割し関数化にしたコードを再利用しませんし、使い方が間違っていると思い腑に落ちません。

メソッド化（関数化）の目的は再利用だけという訳では無いので、使い方は間違っていません。
メソッド化したときに、メソッドにわかりやすい名前を付けられるのであれば、そのメソッド化は有効で、コード全体の可読性を上げます。

Comments

[otn]

そういえば、「1つのメソッドで制御構造（ループとか、条件判断）は1つまで」という細かくメソッド分けるコーディングルールもあるようです。
これは、名前付けに苦しみそうですが。

Answer 2

皆さんおっしゃってるように、インデントが深くなるのは読みにくいです。１画面に収まらないときなど、ここはどの階層？？？　と道に迷うことが多いです。
そのために再利用のないmethodに切り出すのも皆さんおっしゃるとおりです。

JSONてなんでもありなので、なんでもありな場合は使えませんが、質問のcodeをみると定義された構造を持ったJSONだと思われますのでその前提で。

わたしがよくやるのは以下のような方法です

def 第一階層の処理
  前処理
  第一階層の要素達.each
     case
     when ; 第二階層case1の処理
     when ; 第二階層case2の処理
     end
  end
  後処理
end
   :
   :
def 第123階層の処理
  前処理
  第123階層の要素達.each
     第124階層の処理
  end
  後処理
end

Comments

[yuki_90453]

回答が遅くなってしまい申し訳ございません。
非常に参考になりました。
ありがとうございます！

Answer 3

コードを見せていただけないとコメントしづらいですが、rubocopなどを使って解析してみらいかがでしょうか？

どうしたらベストかは人それぞれだとおもいますが、良い解決策が見えてくるかもしれませんよ。

Answer 4

コードが無いと具体的には説明しづらいのですが、
データ加工の処理はループだけで書くと下のようになりがちですね。
メソッド分割したところで、ループ処理があっちこっちに行ってしまうと、見通しが悪くなりがちです。

loop {
  Aの処理
  loop {
    Bの処理
    loop {
      Cの処理
    }
  }
}

(loopのとこはwhileだったりするかもしれませんが。)

こういうときは、Enumerableにあるメソッドで、一括して処理してあげると、ネストが深くならずに書くことができます。
処理が増えても、下へ下へ伸びるだけですし、メソッド化しても大きな流れを見失うことは無いかと思います。

https://docs.ruby-lang.org/ja/latest/class/Enumerable.html

対象のデータ.
  xxx { Aの処理 }.
  xxx { Bの処理 }.
  xxx { Cの処理 }

xxxの部分で呼び出すべきメソッドは処理の内容によっていろいろです。

単にループを回したいだけならeachだったり
値を変換する処理ならmap
if/unlessを置き換えるなら、selectやrejectなど。

処理内容が長くなりすぎてしまうと、読みづらいので、メソッド化するとよいです。
その際はぜひrubyの特徴であるブロックを使いましょう。
ブロック引数の使い方を学ぶといいです。
https://docs.ruby-lang.org/ja/latest/doc/spec=2fdef.html#method

Enumerableには、隣接する要素を加工する(each_slice)とか、二つの配列から値を組み合わせる(zip)とか、変わり種なメソッドもあります。
まずはリファレンスを眺めてみると良いのではないでしょうか。