自作ツールを作って分かった Go を使うことのメリット

https://knowledgework.connpass.com/event/297546/
Enablement Bootcamp for Gopherizing #1 での発表資料

Transcript

1. 自作ツールを作って分かった
 Go を使うことのメリット
 Enablment Bootcamp for Gopherizing
 2023-10-12
 @オンライン

2. だいち / @_da1kong 
 Classi 株式会社 
 2022年4月 新卒入社
 API・画面開発や業務フローの改善
 企業
 経歴
 業務

3. Background / Motivation
 Bootcamp 以前は Goをほとんど書いたことはなかった
 これを機会を Go を書ける素地を身に付けたい
 実際に学んだこと：Goらしいコード・テスト・エラー処理 など
 
 ここからは コードを書くこと で理解を深めたい
 普段は Ruby・TypeScript を書いているので
 その経験と比較すると Go の理解も進めやすい 
 Bootcamp資料より引用 

4. 作ったもの 
 kudoas/gis (GitHub Issue Syncer)
 
 コマンド実行で自動的に 子Issue と 
 親Issue の情報を同期できるツール
 Issue から Issue を作ると 
 親Issueの情報 (label, millstone など) が 子 Issue に引き継がれないため
 このツールをまだ育てている最中なので 
 機能は最小限です🙏

5. 子 Issue から親 Issue fieldを取得する
 内部実装を簡単に紹介
 OAuth2.0 で GitHub API を認可する
 子 Issue fieldをアップデートする
 1 2 3
6. 開発で使用したツール・ライブラリ等
 Editor 
 VSCode
 Go 
 Version 1.21.3
 Library
 golang/oauth2 OAuth2.0 による認可のクライアント実装
 shurcooL/githubv4 GitHub API v4 SDK
 

7. Goを使って開発したときに感じたメリット

8. GraphQL との連携が扱いやすい 
 GitHub API のレスポンスを格納する構造体を定義 
 クエリを呼び出してレスポンスを構造体に格納する 
 API のレスポンスが構造体に合わない場合は 
 エラーになる
 GraphQLのクエリと構造体が紐づいている 
 取得した値に型のサポートがつく 

9. 構造体によって リクエスト・レスポンスの形式が正しいか を担保できる
 型が決まっているので、呼び出す際にコード補完が効いて書きやすい
 
 テストをスタブする際もライブラリのインターフェースを守れる
 テストを書く場合は外部と通信するAPIのインターフェースは
 スタブすることが多い
 スタブ自体が間違っていてもテストは通るが、実行するとバグになる
 引数や返り値の型を担保した上でより本物に近いスタブが作れる
 他の動的型付け言語 (Ruby) で実装した場合の違い

10. Goを勉強する上で感じたメリット

11. Go のコードは読みやすい
 gofmt という標準ライブラリの存在
 すぐにコードを書き始められる
 import の順番・インデントのスペース数が統一されている
 Go らしいコードを意識して書かれているものが多い
 Clarity（明確さ）や Simplicity（単純さ）を重視している
 引用：Style principles - Go Style Guide 
 ライブラリを使った実践的なコードを追いやすい

12. ライブラリを使った実践的なコードを追いやすい
 README
 GoDoc GitHub Code Search
 より実践的な
 コードを知りたい🤔
 読みやすい

13. ライブラリの実装の詳細を追いやすい
 VSCode 上のコードジャンプですぐに 実装の詳細 を確認できる
 言語仕様もシンプルなので読みやすい
 
 他の言語との比較
 Ruby はそもそもコードジャンプがしにくい
 TypeScript は 型定義ファイル(d.ts) を参照する場合が多い

14. 実際に自作ツールを開発することで Go のメリットが少しずつ見えてきた
 型によるコードの保護が手厚い
 実装する上で他のコードを参照しやすい
 ライブラリの実装の詳細を追いやすい
 Bootcamp で Go の素地がついてきたと感じた
 ここから更に手を動かしながら学んでいきたい
 まとめ