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

はじめに

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

インストール

スタートメニューから Windows PowerShell を選択します。

pkg 001

以下のコマンドを入力します。

1	scoop install ruby

インストール完了後に MSYS2 のインストールを促されるのでインストールします。

1	scoop install msys2

続いて、以下のコマンドを入力して 3 を指定して実行します。

1	ridk install

ruby win install 001

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

Ruby for Visual Studio Code

設定

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

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

ruby win vscode 003

ruby win vscode 004

Hello world

プログラムを作成する

Projects フォルダ内に Ruby フォルダを作成してエディタからフォルダを開きます。

ruby win hello 001

ruby win hello 002

ruby win hello 003

新しいファイル 作成アイコンを押します。

ruby win hello 004

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

ruby win hello 005

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

require 'minitest/autorun'

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

ruby win hello 006

Debug Local File を選択します。

ruby win hello 007

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

ruby win hello 008

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

ruby win hello 009

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

require 'minitest/autorun'

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

end

ruby win hello 010

テスティングフレームワークの動作が確認できたので 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

ruby win hello 011

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

ruby win hello 012

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

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

ruby win hello 013

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

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

ruby win hello 014

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

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

ruby win hello 015

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

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