はじめに

この記事は、アドベントカレンダー Go4 の21日目の記事です。

みなさん、Goのエディタ何を使っていますか？
Vim? Vscode?

そうですねGolandを使いましょう。

Golandの利点

インストールしたらデフォルトでいい感じの環境
JetBrainsのエディタはUI同じなので複数言語使う人におすすめ

Golandはじめ方

それでは、Golandを始めていきましょう

筆者がMacしか持ってないのでここではMacでやる手順を記載してしまいました。
ただし心配することはありません。JetBrains製品はWindows,Linuxもサポートしています。導入手順も大体同じです。多分。

Golandを買いましょう

Golandは有償です。初年度は1万円ですが、2年目以降はディスカウントされます。さらに使用していくうちにだんだんと多幸感に包まれるため、相殺され実質無料になります。

国内代理店のサムライズムさん経由なら若干安く購入することが出来ます。
また、日本語でのサポートも行っていただけるのでそちら経由で購入することをおすすめします。
https://samuraism.com/jetbrains/goland

実質無料なのですが、どうしても使ってから購入したい人は30日間のトライアルがあるのでそちらを利用してもいいかもしれません。

ここまできてまだお悩みなら一旦 All Products Pack
を購入された方がいいと思います。

こちらも初年度は3万円弱のお値段なのですが、継続3年目で2万円を切る値段にディスカウントされます。

もしあなたが、複数の言語を操るプログラマーなら迷わず購入するべきです。

以降はサムライズムさんのサイトで購入した体で話を進めていきます。

インストールしましょう

購入してアクティベーションされるまで若干のタイムラグがあります。その間にGolandをインストールしておきましょう

ちょっと待ってください。ChromeでGolandと検索してダウンロードページに進もうとしませんでしたか？
JetBrains製品をインストールするために直接アプリをインストールするのは愚かです。
ToolBox Appをインストールしましょう
https://www.jetbrains.com/ja-jp/toolbox-app/

ToolBox Appを使うことで、ライセンスの自動適用、バージョン自動管理などを簡単に行うことが出来ます。

ToolBox Appを起動すると、なんか右上にメ●カ●のようなアイコンが表示されていませんか？
クリックしてみましょう。

そこにGolandがありますね。
Installボタンをポチりましょう。

そしてインストールされるのを待ちましょう。

....

アクティベーションしましょう

ちょうど、アクティベーションメールが届く頃だと思います。
Gmailで確認しましょう。
こんな感じのメールにPDFが添付されているかと思います。

アクティベーション用URLをクリックして、流れでJetBrainsアカウントを作りましょう。

そしてそのアカウントでToolBox Appにログインしましょう。
これでエディタ個別のアクティベーションが不要になり、以降は期限が切れるまでつかいたい放題です。

Goをインストールしましょう

「は？ここでGo？Golandで全部揃うって言ったじゃん？嘘なの？」

と思われるかもしれませんが、Golandと同じくらい便利なツールがあります。

anyenvです。

「は？goenv入れておけばいいやん。なんで？」
と思われるかもしれませんが、anyenvを入れておけば、他言語も使えるからとりあえず入れとこ?な？

brewで入れて環境変数をゴニョゴニョするだけです。入れておきましょう。
https://github.com/anyenv/anyenv#homebrew-for-macos-user

GOENV_DISABLE_GOPATH=1

悪いこと言わないので~/.bash_profileとかに
export GOENV_DISABLE_GOPATH=1を追加しておいてください。
何も考えずにとりあえず追加しておいてください。
理由を知りたい人はこちらにありがたい記事があるので見ておいてください。
https://qiita.com/gimKondo/items/add08298e24ae400505e
(自分もハマってた)

goの最新版をインストールしてください。

goenv install -l # インストール可能なバージョン確認
goenv install 1.13.4 # 最新バージョンインストールしてね
goenv global 1.13.4

goimportsをインストールしておきましょう

go get golang.org/x/tools/cmd/goimports

Xcodeをインストールしましょう

何も考えずにとりあえず入れておきましょう。
インストール超長いんですが、業務時間に入れて構いません。

入れたら、下記のコマンドをやってください。

xcode-select

そんで環境変数を追加してください。
これも~/.bash_profileとかに突っ込んでおけばいいです。

export SDKROOT="$(xcrun --sdk macosx --show-sdk-path)"

理由はOSXのアップデートのたびに、SDKROOTのパスがコロコロ変わるからなんですが、
ありがたい記事で解説されているので、参照されるといいと思います。
https://qiita.com/imbsky/items/da709a514dded95b8575

Golandを立ち上げましょう

あなたは今使っているエディタに不満を持っていて、Golandに乗り換えようとしていると仮定しましょう。
ただし、手元には他エディタで作業しているプロジェクトフォルダがあります。

ToolBox AppからGolandを立ち上げてください

そして、あなたのいつも作業しているプロジェクトフォルダを開いてください。

開きましたね。

後少しで開発出来ます。

設定をしましょう

GOROOT

Command + , でPreferences(設定画面)が開きます。
Go > GOROOTで設定しましょう。

Go Module

GolandはGo Moduleに対応しています。
Go > Go Modules(vgo)でEnable Go Modules(vgo) integrationにチェックしましょう
Proxyはdirectにしておいてください。

Dep,Go Mdudle Vendoring modeにも対応していますが、絶対にやめておきましょう。
Go Moduleを使っている限り、プロジェクトフォルダにvendor/が存在することに何の意味もありません。(個人の感想です)

コーディングしましょう

おめでとうございます！ここまできたら、Golandでの開発環境は整いました！
あとはザクザクコーディングしていくだけです！Golandの世界へようこそ！

プラグインを入れておきましょう

どんなにデフォでいい感じと言いつつも、やれvimバインドしたいだの、github連携させたいだの
個人の趣味に合わせた使い方をしたい場合はプラグインをインストールすることが出来ます。

僕は本当はデフォでも大丈夫なんですが、下記のプラグインとか入れています。

ideaVim
.ignore
BashSupport
Github
Docker

コーディングサンプル

先ほど、あなたのプロジェクトフォルダを開いてもらったのですが、いったん閉じていただいて、
ここではサンプルを使って、Golandでのコーディング作業を見ていきましょう。

こちらのコードを下記のディレクトリ構成にして貼り付けてください

project/
  `- sample/
      |- mocks/
      `- sample.go
       |- sample.go
       `- sample.test.go

sample/sample.go

package sample

import (
    "fmt"
)

type HogeClient interface {
    Do() error
}

type Sample struct {
    HogeClient HogeClient
}

func (s *Sample) Do() error {
    err := s.HogeClient.Do()
    if err != nil {
      return fmt.Errorf("えらーだよ : %w", err)
    }
    return nil
}

sample/sample_test.go

package sample

import (
    "fmt"
    "testing"

    "github.com/golang/mock/gomock"
    "github.com/junpayment/sample/sample/mocks"
    "github.com/stretchr/testify/assert"
)

func TestSample_Do(t *testing.T) {
    t.Run("success", func(t *testing.T) {
        ctrl := gomock.NewController(t)
        mock := mocks.NewMockHogeClient(ctrl)
        mock.EXPECT().Do().Return(nil)
        s := &Sample{HogeClient: mock}
        err := s.Do()
        assert.Nil(t, err)
    })
    t.Run("failed", func(t *testing.T) {
        ctrl := gomock.NewController(t)
        mock := mocks.NewMockHogeClient(ctrl)
        mock.EXPECT().Do().Return(fmt.Errorf("test"))
        s := &Sample{HogeClient: mock}
        err := s.Do()
        assert.Nil(t, err)
    })
}

sample/mocks/sample.go

// Code generated by MockGen. DO NOT EDIT.
// Source: sample/sample.go

// Package mocks is a generated GoMock package.
package mocks

import (
    gomock "github.com/golang/mock/gomock"
    reflect "reflect"
)

// MockHogeClient is a mock of HogeClient interface
type MockHogeClient struct {
    ctrl     *gomock.Controller
    recorder *MockHogeClientMockRecorder
}

// MockHogeClientMockRecorder is the mock recorder for MockHogeClient
type MockHogeClientMockRecorder struct {
    mock *MockHogeClient
}

// NewMockHogeClient creates a new mock instance
func NewMockHogeClient(ctrl *gomock.Controller) *MockHogeClient {
    mock := &MockHogeClient{ctrl: ctrl}
    mock.recorder = &MockHogeClientMockRecorder{mock}
    return mock
}

// EXPECT returns an object that allows the caller to indicate expected use
func (m *MockHogeClient) EXPECT() *MockHogeClientMockRecorder {
    return m.recorder
}

// Do mocks base method
func (m *MockHogeClient) Do() error {
    m.ctrl.T.Helper()
    ret := m.ctrl.Call(m, "Do")
    ret0, _ := ret[0].(error)
    return ret0
}

// Do indicates an expected call of Do
func (mr *MockHogeClientMockRecorder) Do() *gomock.Call {
    mr.mock.ctrl.T.Helper()
    return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Do", reflect.TypeOf((*MockHogeClient)(nil).Do))
}

さらにいろいろgo getしてください

go get github.com/golang/mock
go get github.com/stretchr/testify

この状態で、ここの緑の三角をクリックしましょう。

そしてRunするとテスト実行されます

こんな感じでまじでほとんど何もしなくてもデフォでデバッグ出来ます。

おっとテスト失敗しましたね。
テストを書き直して失敗したテストだけやり直しましょう。

sample/sample_test.go

    t.Run("failed", func(t *testing.T) {
        ctrl := gomock.NewController(t)
        mock := mocks.NewMockHogeClient(ctrl)
        mock.EXPECT().Do().Return(fmt.Errorf("test"))
        s := &Sample{HogeClient: mock}
        err := s.Do()
        assert.NotNil(t, err) // ここ
    })

楽ぅ〜

デバッグモードでも実行出来ます

ブレークポイントも貼りましょう。

条件付きのブレークポイントも貼りましょう。

便利ぃ〜

最後に

ここまで来たら、もはや今までのエディタをアンインストールし、全てのJetBrains製品をインストールするのみです。

Goland,JetBrains人口は他のエディタに比べて少ないのですが、

[引用]https://job-draft.jp/articles/323

デフォルト状態でいい感じに開発スタートできる(当社比), すぐコーディング作業に没頭することのできる(当社比)という利点は
各プログラミング言語ごとに最適化された製品があるJetBrainsならでは無いでしょうか？だよね？

みなさんGolandつかいましょう。

Golandをつかいましょう 2019冬