環境構築から始めるテスト駆動開発 ~Ruby開発環境を構築する(WSL版)~

はじめに

これは環境構築から始めるテスト駆動開発 ~プログラミング環境の共通基盤を構築する~ の開発言語セットアップ記事です。Windows 10 Home で共通基盤が構築されていることを前提としています。

インストール

Ruby開発環境の自動構築をするため以下のレポジトリを自分のレポジトリにフォークします。

テスト駆動開発から始めるRuby入門

Fork を押します。

Fork が完了して自分のレポジトリにコピーされたら Clone or download を押してレポジトリのURLをコピーします。

エクスプローラアイコンメニューから レポジトリをクローンする を押します。

先程コピーしたレポジトリのURLを貼り付けます。

保存先はそのままで OK を押します。

開く を押します。

メニューから ターミナル 新しいターミナル を選択します。

ターミナルに以下のコマンドを入力します。実行時にパスワード入力が求められるのでWSLで設定したパスワードを入力してください。

$ sudo apt-get update -y
[sudo] password for newbie4649:

続いて、ターミナルに以下のコマンドを入力します。

$ sudo apt install ansible -y

続いて、エクスプローラから　provisioning/vars/site.yml をファイルを開いて user: の名前をWSLで設定したユーザーIDに変更します。

変更を保存したらターミナルに以下のコマンドを入力します。

$ cd provisioning/tasks/
$ sudo ansible-playbook --inventory=localhost, --connection=local site.yml

セットアップが完了したらエディタを再起動してプロジェクトを開きます。

以下のコマンドを入力してRubyがセットアップされていることを確認します。

$ ruby -v

続いて、ターミナルに以下のコマンドを入力します。

$ code ~/.bashrc

表示されたファイルの一番最後に以下のコードを追加して保存します。

...
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_compl

保存したら以下のコマンドを実行してNode.jsのバージョンが表示されたらセットアップ完了です。

$ source ~/.bashrc
$ nvm install --lts
$ node -v

追加パッケージのインストール

Ruby for Visual Studio Code

ターミナルに以下のコマンドを入力します。

gem install rubocop
gem install debase
gem install ruby-debug-ide
gem install solargraph

Hello world

プログラムを作成する

REAMD.md を選択してから 新しいファイル 作成アイコンを押します。

ファイル名は main.rb とします。

ファイルに以下のコードを入力したらRunアイコンを選択して create a launch.json file を押してメニューからRubyを選択します。

require 'minitest/autorun'

class TestHelloWorld < Minitest::Test
  def test_何か便利なもの
    assert_equal(true, false)
  end
end

Debug Local File を選択します。

launch.json ファイルが作成されたら main.rb タブに戻ってF5キーを押します。

デバッグコンソールに実行結果が表示されれば準備完了です。

テストをパスするようにコードを修正してF5キーを押します。

require 'minitest/autorun'

class TestHelloWorld < Minitest::Test
  def test_何か便利なもの
    assert_equal(true, true)
  end

end

テスティングフレームワークの動作が確認できたので hello_world 関数の作成に入ります。まず以下のコードを追加してF5キーを押してテストが失敗することを確認します。

require 'minitest/autorun'

class TestHelloWorld < Minitest::Test
  def test_何か便利なもの
    assert_equal(true, true)
  end

  def test_簡単な挨拶を返す
    assert_equal('Hello from Ruby', hello_world)
  end
end

hello_world 関数を追加してテストをパスさせます。

require 'minitest/autorun'

class TestHelloWorld < Minitest::Test
  def test_何か便利なもの
    assert_equal(true, true)
  end

  def test_簡単な挨拶を返す
    assert_equal('Hello from Ruby', hello_world)
  end
end

def hello_world
  'Hello from Ruby'
end

指定された名前で挨拶を返すようにします。

require 'minitest/autorun'

class TestHelloWorld < Minitest::Test
  def test_何か便利なもの
    assert_equal(true, true)
  end

  def test_簡単な挨拶を返す
    assert_equal('Hello from Ruby', hello_world)
  end

  def test_指定された名前で挨拶を返す
    assert_equal('Hello from VSCode', hello_world('VSCode'))
  end
end

def hello_world
  "Hello from Ruby"
end

関数に引数を追加します。

require 'minitest/autorun'

class TestHelloWorld < Minitest::Test
  def test_何か便利なもの
    assert_equal(true, true)
  end

  def test_簡単な挨拶を返す
    assert_equal('Hello from Ruby', hello_world)
  end

  def test_指定された名前で挨拶を返す
    assert_equal('Hello from VSCode', hello_world('VSCode'))
  end
end

def hello_world(name)
  "Hello from #{name}"
end

指定された名前で挨拶を返す テストはパスしましたが今度は 簡単な挨拶を返す テストが失敗するようになりましたのでデフォルト引数を設定してテストをパスするようにします。

require 'minitest/autorun'

class TestHelloWorld < Minitest::Test
  def test_何か便利なもの
    assert_equal(true, true)
  end

  def test_簡単な挨拶を返す
    assert_equal('Hello from Ruby', hello_world)
  end

  def test_指定された名前で挨拶を返す
    assert_equal('Hello from VSCode', hello_world('VSCode'))
  end
end

def hello_world(name = 'Ruby')
  "Hello from #{name}"
end

仕上げに不要なテストを削除してテストケースの文言をわかりやすくしておきます。

require 'minitest/autorun'

class TestHelloWorld < Minitest::Test
  def test_何も指定されていない場合は既定の挨拶を返す
    assert_equal('Hello from Ruby', hello_world)
  end

  def test_指定された名前で挨拶を返す
    assert_equal('Hello from VSCode', hello_world('VSCode'))
  end
end

def hello_world(name = 'Ruby')
  "Hello from #{name}"
end