GolangCI-Lintの設定ファイルを理解する

Mon, 09 Dec 2019 09:00:00 +0900

DMM Advent Calendar 2019

本記事は DMM Advent Calendar 2019 の 9日目の記事です。

私は現在、DMM.com の CDS というチームに所属し、
主にユーザレビュー基盤のバックエンドを開発しています。

今回は、Go用Linterである GolangCI-Lint を軽く紹介した後に、
GolangCI-Lint のハマリポイントとその解決策である設定周りの話をします。

Linter 導入していますか？

突然ですが、みなさんの開発環境には Linter が導入されているでしょうか？

私の所属するチームでは、
コーディング規約違反およびコンパイラでは見つけられないエラーを検知するために、
ローカルと CI において Linter を回すようにしています。

GoにおけるLinter

Goの場合、Linterがデフォルトで用意されているうえに、
ライブラリとして公開されているものも多く存在します。

なかでも有名なものに以下のようなものがあります。

govet：GoデフォルトのLinter
errcheck：ちゃんとエラーハンドリングしているかチェックしてくれる
unused：未使用の定義をチェックしてくれる
goimports：未使用のimportを消してくれたり、フォーマット修正してくれる
gosimple：コードをシンプルにしてくれる

しかしながら、多すぎるがゆえにどれを選択すればいいのか分からなくなりがちです。
加えて、導入する Linter が増えれば、その分だけ導入・管理コストが増加します。

この問題を解決してくれるツールが GolangCI-Lint です。

GolangCI-Lint

勉強会でもよく耳にするようになってきている＋多くの紹介記事があるので、
ここで詳しく説明する必要もないかもしれませんが、いちおう少しだけ触れておきます。

GolangCI-Lint とは、 GoのLinterを一元管理するためのツールです。
開発者は GolangCI-Lint を導入するだけで様々な Linter を実行することができます。

【Go+VCR】外部APIとの通信を保存してテストに使用する話

Sun, 08 Dec 2019 09:00:00 +0900

Go3 Advent Calendar 2019

本記事は Go3 Advent Calendar 2019 の 8日目の記事です。

ではでは、早速本題に入っていきます。

モック使ってますか？

みなさんモックコードは書いていますか？

テストコードを書いているなら、ほぼ必ず登場するあのモックです。
DB処理や関数のモックなどいろいろありますよね。

そんなモックコードですが、作ったり管理するのめんどくさいなぁとか思ってないですか？
モックだからといって雑なコードになっていませんか？

今回は、外部API通信のモック化にフォーカスし、
モックコードの作成・管理コストを軽減する
VCR ライブラリを紹介します。

VCR ライブラリとは？

VCR（Video Cassette Recorder）とは、通信を保存し、再生するライブラリです。

つまり、APIリクエストの初回通信の内容を保存し、
次回以降その保存内容（レスポンス）を使いまわしてくれるというものです。

言い換えれば、外部APIのモックを自動生成してくれるということですね！

VCR ライブラリ in Go World

Go用のVCRライブラリはいろいろあります。
スター数が多いのは以下のものです。

go-vcr および vcr-go，govcr の開発は盛んではないようです。

rpcreplay は google-cloud-go に包含されるパッケージであり、安心して使えそうです。
ただし、gRPC 用なので、その点は注意が必要です。
GoDocはこちらです。

今回は REST API を使って説明していくので、go-vcr を使用します。

go-vcr は、vcr-go と govcr よりスター数が多いです。
Ruby 製の vcr というライブラリがもとになっているようです。

テスト on Indexing my brain