Download as PDF, PPTX
筋肉によるGoコードジェネレーション
- 1. による Go コードジェネレーション kamakura.go #3 2018/1/20 株式会社HDE 牧大輔 (@lestrrat) Brute-force Code Generation In Go 筋 肉
- 2. • @lestrrat • Perl/Gohacker, author, father • Author of github.com/peco/peco • Organizer for builderscon
- 3. agenda 1. go-slack 2. 私流コードジェネレーション 3.コードジェネレーションtips 4. 反省とまとめ
- 4.
- 5.
- 6. クライアント • APIが完全自動生成 (endpoints.jsonを編集） •APIが完全にGoogle風味 (google.golang.org/api) 自動生成前提 →大量のAPIが存在する時にはとても重要
- 7.
- 8.
- 9.
- 10.
- 11.
- 12.
- 13. サーバー • モックサーバー・プロキシサーバーを完全自動生成！ • Slackへの通信をインターセプト！ •ボットが無駄にポストしなくなる！
- 14.
- 15.
- 16.
- 17. Kubernetesと相性良い！ • 本番Service (type=ExternalName,api.slack.com) • 開発Service (type=ClusterIP, slaproxy Pod) • どちらもクライアント側からは slack.$namespace.svc.cluster.local に見える
- 18.
- 19.
- 20. 手法は？ • ASTを作成して printer.Fprintf?(このドMがッ！） • Perl/Python/Ruby/PHPから生成？ • text/templateで生成？
- 21.
- 22.
- 23.
- 24. • schemalex/schemalex • go-jsval •go-libxml2 internal/cmd/gen* • go-slack • go-msgpack • go-ical • go-jsschema 拙作のライブラリではinternal以下にコマンドを 仕込んでおき、go generateから呼んでる
- 25. • schemalex/schemalex • go-jsval •go-libxml2 internal/cmd/gen* • go-slack • go-msgpack • go-ical • go-jsschema 拙作のライブラリではinternal以下にコマンドを 仕込んでおき、go generateから呼んでる internal 以下なら godocには載らないんじゃ！
- 26.
- 27. go generate あとは gogenerateから呼べるようにしておくだけ
- 28. go generate あとは gogenerateから呼べるようにしておくだけ サーバもクライアントも 同じ定義から作れるので とっても便利じゃ！
- 29.
- 30.
- 31. text/templateの限界に 挑戦する必要がない • 「は！今のコンテキストからはグローバルな変数に直接アクセスできない…」 • 「あれ、この文字列を処理する関数をちょっと入れたいだけなのに…なに？ FuncMapだぁ？」 • 「補助関数・変数一杯いれたけど、一体今どれが有効なのかわからん！」 利点:
- 32. text/templateの限界に 挑戦する必要がない • 「は！今のコンテキストからはグローバルな変数に直接アクセスできない…」 • 「あれ、この文字列を処理する関数をちょっと入れたいだけなのに…なに？ FuncMapだぁ？」 • 「補助関数・変数一杯いれたけど、一体今どれが有効なのかわからん！」 利点: 個人的には、簡単な テンプレート以外で使う text/templateはクソじゃと 思っておる！
- 33.
- 34.
- 35. Tip: Optionパターンが便利 • 任意の0~N個の引数を好きな順番で与える事ができる •メソッドチェーンと同じく「メソッドの正しい引数の順 番」を考えるより楽 • 必須でない引数に便利 slack.New( token, // 必須なので、Optionではない slack.WithDebug(true), // デバッグ有効化 slack.WithClient(&http.Client{}), // http.Clientをカスタマイズしたい )
- 36. Tip: メソッドチェーンは便利 • メソッドを呼ぶと、呼び出したオブジェクトを戻り値と して返す •メソッドの呼び出し順を（ほとんど）考えずに済む •「メソッドの正しい引数の順番」を考えるより楽 slackClient.Chat(). // go-slackの場合… PostMessage(…). // ここまでは必須。 Attachment(…). // ここから任意引数を… EscapeText(false). // メソッドチェーン。 Do(ctx) // 最後にDo()を呼ぶと発火
- 37. Tip: メソッドは”.n”から if (addMethod1){ fmt.Fprintf(“.nMethod1()”) } if (addMethod2) { fmt.Fprintf(“.nMethod2()”) }
- 38.
- 39. Tip: 定義対象は必ずソートする • 元々リストから生成するならやらなくてもOK •マップから生成するクラス名、メソッド名、etc… • 順番が安定しないと、diffがおかしなことになる
- 40. Tip: 無駄に思えても、1行ずつ • 一気にPrint(複数行）とかしたくなるけど、我慢 •あとで何かを差し込みたくなったり、条件分岐する時に そのほうが楽
- 41.
- 42. Tip: 生成されたファイル名を揃える • 後悔するので、必ずファイル名から生成されたことがわ かるようにしましょう •“xxxxx_gen.go” 等で揃えるとよい
- 43. Tip: CIでgit diffをチェック •生成されたファイルがチャントコミットできてるか確認 • 結構漏れるので注意 • トラックされていないファイルは “git ls-files -- others —exclude-standard" https://github.com/lestrrat/go-slack/blob/master/scripts/check-diff.sh
- 44.
- 45.
- 46. それでもやるべき瞬間（とき） • 今回のような機械的なコードの羅列がある場合 • そして、とにかくその数が多い •「自分がイチイチ変更していくと絶対エンバグするぞ」 という時
- 47.
- 48.
- 49.
- 50.