Rubyで書かれた ソースコードを読む技術 in kaigi on rails/technic-of-reading-source-code-written-in-ruby-for-kaigi-on-rails-2020

Transcript

1. Rubyで書かれた ソースコードを読む技術 2020-10-03 Kaigi on Rails fukajun

2. 今日話すこと

3. 今日話すこと Rubyで書かれたソースコード読んでいて 困ったときにぼくがやっていること

4. 自己紹介

5. 自己紹介 - @fukajun - 株式会社ロコガイドで働くサーバーサイドエンジニア - データ基盤、インフラ周りを担当 - ときどきRuby＆Railsでの開発に参加 -

   Railsとの出会い - Arelが入る前、Rails 2.3 or 3 くらい - sendagaya.rb主催 with @tkawa - 毎週月曜日に勉強会を開催 - そろそろ350回を超える!? - キーボード - デフォルト => hhkb type-s => NiZ atom66 (沼回避)

6. アジェンダ

7. アジェンダ - どういう感じで読めないか？ - それを乗り越えるためには？ - 具体的な方法

8. どういう感じで読めないか？

9. - コードがどこにあるのかわからない - コードを読んだけど推測する動作に自信が持てない - コードの流れがわからない どういう感じで読めないか？

10. それを乗り越えるには？

11. それを乗り越えるには？ Rubyやgemの便利な機能を使う => 実際にコードを動かす

12. 具体的な方法について

13. コードを探すには？ （検索編）

14. コードを探すには？（検索編） gemのインストール場所をRails.root配下に ⬇こちらのやり方はDEPRECATED (bundler 2.1〜) $ bundle config set path

    ‘vendor/bundle’ --local $ bundle install $ bundle install --path vendor/bundle

15. コードを探すには？（検索編） Rails.root 配下にgemをインストールしたら？ - △遅い・終わらない - grep - ◯簡単・速い・便利 -

    ag(silver searcher) - rg(ripgrep) - ack

16. コードを探すには？ （メソッド編）

17. コードを探すには？(メソッド編) Method#source_location 1 class Hoge 2 def run 3 end

    4 end hoge = Hoge.new > hoge.method(:run).source_location => ["hoge.rb", 2] > hoge.method(:run) # Ruby2.7〜 => #<Method: Hoge#run() hoge.rb:2>

18. コードを探すには？(メソッド編) 例) Railsのソースコードを読むときに使ってみる ActiveRecord::Base.connectionの定義場所を調べる > ActiveRecord::Base.method(:connection).source_location => [".../gems/activerecord-6.0.3.3/lib/active_record/connection_handling.rb", 188] 1

    # frozen_string_literal: true 2 3 module ActiveRecord 4 module ConnectionHandling ... 187 # to any of the specific Active Records. 188 def connection 189 retrieve_connection

19. 具体的な動作について知るには？

20. 具体的な動作について知るには？ デバッガーをつかう - binding.irb (ruby標準) - binding.pry (pry gem) -

    byebug (byebug gem) From: .../photos/app/controllers/albums_controller.rb @ line 3 : 1: class AlbumsController < ApplicationController 2: def index => 3: binding.irb 4: end 5: end

21. 具体的な動作について知るには？ From: .../photos/app/controllers/albums_controller.rb @ line 3 : 1: class AlbumsController

    < ApplicationController 2: def index => 3: binding.irb 4: end 5: end irb(#<AlbumsController:0x00007f8d94ae4998>):001:0> params => <ActionController::Parameters {"controller"=>"albums", "action"=>"index"} permitted: false> ... irb(#<AlbumsController:0x00007f8d94ae4998>):007:0> controller_name => "albums" irb(#<AlbumsController:0x00007f8d94ae4998>):008:0> action_name => "index"

22. 呼び出し元について知るには？

23. 呼び出し元について知るには？ - puts caller (ruby標準) - backtrace (byebug gemでデバッグ中) class

    AlbumsController < ApplicationController def index puts caller end end

24. 呼び出し元について知るには？ .../app/controllers/albums_controller.rb:4:in `index' .../actionpack-6.0.3.3/lib/action_controller/metal/basic_implicit_render.rb:6:in `send_action' .../actionpack-6.0.3.3/lib/abstract_controller/base.rb:195:in `process_action' .../actionpack-6.0.3.3/lib/action_controller/metal/rendering.rb:30:in `process_action' .../actionpack-6.0.3.3/lib/abstract_controller/callbacks.rb:42:in

    `block in process_action' .../activesupport-6.0.3.3/lib/active_support/callbacks.rb:135:in `run_callbacks' : 省略 : .../rack-proxy-0.6.5/lib/rack/proxy.rb:57:in `call' .../railties-6.0.3.3/lib/rails/engine.rb:527:in `call' .../puma-4.3.6/lib/puma/server.rb:713:in `handle_request' .../puma-4.3.6/lib/puma/server.rb:472:in `process_client' .../puma-4.3.6/lib/puma/server.rb:328:in `block in run' .../puma-4.3.6/lib/puma/thread_pool.rb:134:in `block in spawn_thread' ※byebug起動中にスタックトレースをたどるときは、 up/down (スタック階層を上下移動) frame n (スタック階層n番へ移動), list (コード表示), edit (エディタで開く)を利用すると便利です

25. gemのコードを読むときは？

26. gemのコードを読むときは？ - gemのコードでも気にせず変更 - 動作を知るためのコードを直接埋め込んでいく - binding.irb、byebugなどのデバッガー - Method#source_location, caller

    - puts, p - ブレークポイントを利用してもできるけど...

27. 変更したgemを 元に戻すには？

28. 変更したgemを元に戻すには？ bundle or gem pristine コマンドを使う - Gemfileにあるgemを全部 - bundle

    pristine - Gemfileにあるgem(extensionなしのみ)を全部 : 速い ※ - bundle exec gem pristine --all --no-extension - 変更したgemを覚えている場合 ※ - bundle exec gem pristine [GEMNAME] --no-extension ※extensionありではうまく動作しなかった

29. 迷子にならないように するには？

30. 迷子にならないようにする? - コードを読む目的を明確に - 例) - 複数の値をオプションに渡す区切り文字を知る - activestorageでS3を使ったときのkeyの変更可否 -

    目的をどこかにメモする - メモをときどき振り返る

31. まとめ

32. まとめ - 困ったときはRubyやgemに助けてもらおう - 読む前/長期化しそうなとき目的を再確認しよう - デバッグ力の向上にもつながるかも

33. ロコガイドではソースコードを どんどん読んで、Ruby/Railsで一緒に楽しく 開発してくれる仲間を募集中です！ 気になったら wantedly、@fukajun に連絡ください

34. ご視聴ありがとうございました。