groverのコードを なんとなく読んでみた Ryo Ichiki

自己紹介 3社目：HRテック系ベンチャー（現在） 　　　Ruby, TypeScript 2社目：不動産テック系ベンチャー 　　　Ruby, PHP, JavaScript 1社目：小さい受託開発会社 　　　C# 大学：理学部（情報系ではない） 　　　C, R, Ruby GitHub：ryichk X：@ryichk_dev

groverとは？ HTMLをPDFやPNG画像、JPEG画像に変換できるgemです。 内部でPuppeteerとChromiumを使って変換しています。 PuppeteerはChromeを操作するNode.jsのライブラリです。 なのでgroverを使うためにはNode.jsの環境も必要です。 https://github.com/Studiosity/grover

groverを知ったきっかけ HTMLをPDFに変換するメジャーなgemとしてwicked_pdfがあります。 このwicked_pdfを別のgemにリプレイスする必要がありました。 wicked_pdfは内部でwkhtmltopdfというライブラリ(gemではない)を使っています。 wkhtmltopdfは2023/1/2にアーカイブされておりメンテが終了している状態です。 EC2のOSをAmazon Linux 2023へアップグレードした際に動かなくなるリスクがあり、仮 に動いたとしても...

groverの他にも候補がありました ・ferrum ・prawn

Groverの使い方 https://github.com/Studiosity/grover?tab=readme-ov-file#usage

Railsで使う場合 https://github.com/Studiosity/grover?tab=readme-ov-file#from-a-view-template

Grover#to_pdf を見ていく 　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

Grover#to_pdf 〜

Grover::Processor#convert

Grover::Processor#convert

Grover::Processor#spawn_process

Open3.#popen3について popen3(*cmd) -> [IO, IO, IO, Thread] 外部プログラムcmdを実行し、そのプロセスの標準入力、標準出力、標準エラー出力に 接続されたパイプと実行したプロセスを待つためのスレッドを４要素の配列で返す。 https://docs.ruby-lang.org/ja/latest/method/Open3/m/popen3.html

Open3.#popen3 を使って別プロセスを立ち上げ、 Node.js 経由で processor.cjs を実行している

Grover::Processor#convert

Grover::Processor#ensure_packages_are_initiated

Grover::Processor#ensure_packages_are_initiated 要はNode.jsのプロセスが問題なく起 動しているか確認している

Grover::Processor#convert

Grover::Processor#call_js_method

Grover::Processor#call_js_method

Grover::Processor#call_js_method つまり、 processor.cjsに method, url_or_html, options を渡している method = :pdf

processor.cjs（超ざっくり） 1. puppeteerでChromeブラウザを起動し、接続する 2. 引数で渡されたURL or HTML文字列をブラウザで読み込む　 3. puppeteerのPage.pdf()メソッドを実行 a. 読み込んだページの PDFを生成する 4. 生成されたPDFを標準出力に書き出す 5. Chromeブラウザの接続を閉じて終了

まとめ・感想 ・groverはpuppeteerというNode.jsのライブラリを 　Ruby経由で無理やり操作するためのgemという感じ ・やっていることはシンプル。 ・だけど細かく見ていくと複雑 ・Ruby経由でNode.jsのライブラリを実行できるなら他にも色々できそう （Node.jsに限らず）

ご清聴ありがとうございました