[Roppongi.rb#20] groverのコードをなんとなく読んでみた

Roppongi.rb#20でLTしたスライドです！

Transcript

1. groverのコードを なんとなく読んでみた Ryo Ichiki
2. 自己紹介 3社目：HRテック系ベンチャー（現在） 　　　Ruby, TypeScript 2社目：不動産テック系ベンチャー 　　　Ruby, PHP, JavaScript 1社目：小さい受託開発会社 　　　C# 大学：理学部（情報系ではない） 　　　C, R, Ruby GitHub：ryichk X：@ryichk_dev
3. groverとは？ HTMLをPDFやPNG画像、JPEG画像に変換できるgemです。 内部でPuppeteerとChromiumを使って変換しています。 PuppeteerはChromeを操作するNode.jsのライブラリです。 なのでgroverを使うためにはNode.jsの環境も必要です。 https://github.com/Studiosity/grover
4. groverを知ったきっかけ HTMLをPDFに変換するメジャーなgemとしてwicked_pdfがあります。 このwicked_pdfを別のgemにリプレイスする必要がありました。 wicked_pdfは内部でwkhtmltopdfというライブラリ(gemではない)を使っています。 wkhtmltopdfは2023/1/2にアーカイブされておりメンテが終了している状態です。 EC2のOSをAmazon Linux 2023へアップグレードした際に動かなくなるリスクがあり、仮 に動いたとしても...
5. groverの他にも候補がありました ・ferrum ・prawn
6. Groverの使い方 https://github.com/Studiosity/grover?tab=readme-ov-file#usage
7. Railsで使う場合 https://github.com/Studiosity/grover?tab=readme-ov-file#from-a-view-template
8. Grover#to_pdf を見ていく 　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　
9. Grover#to_pdf 〜
10. Grover::Processor#convert
11. Grover::Processor#convert
12. Grover::Processor#spawn_process
13. Open3.#popen3について popen3(*cmd) -> [IO, IO, IO, Thread] 外部プログラムcmdを実行し、そのプロセスの標準入力、標準出力、標準エラー出力に 接続されたパイプと実行したプロセスを待つためのスレッドを４要素の配列で返す。 https://docs.ruby-lang.org/ja/latest/method/Open3/m/popen3.html
14. Open3.#popen3 を使って別プロセスを立ち上げ、 Node.js 経由で processor.cjs を実行している
15. Grover::Processor#convert
16. Grover::Processor#ensure_packages_are_initiated
17. Grover::Processor#ensure_packages_are_initiated 要はNode.jsのプロセスが問題なく起 動しているか確認している
18. Grover::Processor#convert
19. Grover::Processor#call_js_method
20. Grover::Processor#call_js_method
21. Grover::Processor#call_js_method つまり、 processor.cjsに method, url_or_html, options を渡している method = :pdf
22. processor.cjs（超ざっくり） 1. puppeteerでChromeブラウザを起動し、接続する 2. 引数で渡されたURL or HTML文字列をブラウザで読み込む　 3. puppeteerのPage.pdf()メソッドを実行 a. 読み込んだページの PDFを生成する 4. 生成されたPDFを標準出力に書き出す 5. Chromeブラウザの接続を閉じて終了
23. まとめ・感想 ・groverはpuppeteerというNode.jsのライブラリを 　Ruby経由で無理やり操作するためのgemという感じ ・やっていることはシンプル。 ・だけど細かく見ていくと複雑 ・Ruby経由でNode.jsのライブラリを実行できるなら他にも色々できそう （Node.jsに限らず）
24. ご清聴ありがとうございました