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

はじめに

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

インストール

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

Python をインストールします。

1
> scoop install python

バージョンを確認しておきます。

1
2
> python --version
Python 3.9.4

Hello world

プログラムを作成する

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

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

ファイル名 main.py を作成します。
ファイルを開くと拡張機能インストールの案内が出るので インストール を押します。

拡張機能のインストールが終わるとリンターのインストール案内が出るので install を押します。

main.py ファイルに以下のコードを入力します。

1
2
3
4
5
6
7
8
9
import unittest


class TestHelloWorld(unittest.TestCase):
def test_何か便利なもの(self):
self.assertEqual(True, False)


unittest.main(argv=[''], verbosity=2, exit=False)

画面左上の三角ボタンを押すとプログラムが実行されます。
最初の実行時にフォーマッタのインストール案内が出るので Yes を選択します。

インストールが終わったら再度実行ボタンを押します。
プログラムが実行されて実行結果がターミナルに表示されます。

テストをパスするようにコードを修正してプログラムを実行します。

1
2
3
4
5
6
7
8
9
import unittest


class TestHelloWorld(unittest.TestCase):
def test_何か便利なもの(self):
self.assertEqual(True, True)


unittest.main(argv=[''], verbosity=2, exit=False)

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

1
2
3
4
5
6
7
8
9
10
11
12
import unittest


class TestHelloWorld(unittest.TestCase):
def test_何か便利なもの(self):
self.assertEqual(True, True)

def test_簡単な挨拶を返す(self):
self.assertEqual(hello_world(), 'Hello from Python')


unittest.main(argv=[''], verbosity=2, exit=False)

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import unittest


class TestHelloWorld(unittest.TestCase):
def test_何か便利なもの(self):
self.assertEqual(True, True)

def test_簡単な挨拶を返す(self):
self.assertEqual(hello_world(), 'Hello from Python')


def hello_world():
return 'Hello from Python'


unittest.main(argv=[''], verbosity=2, exit=False)

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
import unittest


class TestHelloWorld(unittest.TestCase):
def test_何か便利なもの(self):
self.assertEqual(True, True)

def test_簡単な挨拶を返す(self):
self.assertEqual(hello_world(), 'Hello from Python')

def test_指定された名前で挨拶を返す(self):
self.assertEqual(hello_world('VSCode'), 'Hello from VSCode')


def hello_world():
return 'Hello from Python'


unittest.main(argv=[''], verbosity=2, exit=False)

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
import unittest


class TestHelloWorld(unittest.TestCase):
def test_何か便利なもの(self):
self.assertEqual(True, True)

def test_簡単な挨拶を返す(self):
self.assertEqual(hello_world(), 'Hello from Python')

def test_指定された名前で挨拶を返す(self):
self.assertEqual(hello_world('VSCode'), 'Hello from VSCode')


def hello_world(name):
return f"Hello from {name}"


unittest.main(argv=[''], verbosity=2, exit=False)

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
import unittest


class TestHelloWorld(unittest.TestCase):
def test_何か便利なもの(self):
self.assertEqual(True, True)

def test_簡単な挨拶を返す(self):
self.assertEqual(hello_world(), 'Hello from Python')

def test_指定された名前で挨拶を返す(self):
self.assertEqual(hello_world('VSCode'), 'Hello from VSCode')


def hello_world(name="Python"):
return f"Hello from {name}"


unittest.main(argv=[''], verbosity=2, exit=False)

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import unittest


class TestHelloWorld(unittest.TestCase):
def test_何も指定してない場合は既定の挨拶を返す(self):
self.assertEqual(hello_world(), 'Hello from Python')

def test_指定された名前で挨拶を返す(self):
self.assertEqual(hello_world('VSCode'), 'Hello from VSCode')


def hello_world(name="Python"):
return f"Hello from {name}"


unittest.main(argv=[''], verbosity=2, exit=False)

プログラムをデバッグする

まず確認したいプログラムの行を左部分を押してブレークポイント(赤丸)を設定します。

ブレークポイントを設定したら 実行とデバッグ を押してプログラムの実行します。そうするとブレークポイント部分でプログラムが停止して変数などの情報が確認できるようになります。

Python File を選択します。

画面上の実行ボタンを押すと次のブレークポイントに移動します。

デバッガを終了するには終了ボタンを押します。

ブレークポイントを再度押すことで解除ができます。

プログラムをレポジトリに保存する

ソース管理を選択して リポジトリを初期化する を押します。

全ての変更をステージ を選択します。

変更内容に feat: HelloWorld と入力して コミット を押します。

変更内容は ソース管理 から確認できます。

GitHub に公開する

続いて、GitHub を使ってレポジトリを外部に公開できるようにしてみましょう。

まず、GitHub でレポジトリを作成します。

ログインしたら画面右上の+マークから New repository を選択します。

レポジトリ名は hello-python として Public で公開します。 公開したくない場合は Private を選択します。
Add a README file にもチェックを入れておきます。
最後に Create repository を押して公開レポジトリを作成します。

公開レポジトリが作成されたら VSCode から読み込めるようにするためリンク先の情報を取得します。

クリップボードのアイコンをクリックするとレポジトリの URL がコピーできます。

続いて VSCode に戻り、表示 メニューから コマンドパレット を選択します。

clone と入力して Git クローン を選択します。

リポジトリの URL へ先ほどコピーした公開レポジトリの URL を貼り付けます。

公開レポジトリの保存場所を指定する必要があるのでここでは Projects フォルダに GitHub フォルダを追加してそこに保存することにします。

チェックアウトが終わると画面左下に通知が出ますので 開く を押します。

準備ができましたので先ほどやった HelloWorld プログラムをもう一度作成して先ほどと同様にローカルレポジトリに保存します。

ローカルレポジトリの内容を GitHub の公開レポジトリに登録します。表示 メニューから コマンドパレット を選択します。

push と入力して Git プッシュ を選択します。

以下の GitHub 認証画面が表示された場合は Sign in with your browser を押します。

Authorize GitCrendtialManager を押します。

GitHub アカウントのパスワードを入力します。

認証が完了してローカルレポジトリの内容が公開レポジトリに登録されました。

内容が反映されているかをブラウザ画面から確認します。

Author: k2works
Link: https://k2works.github.io/2021/04/08/1617866474/
Copyright Notice: All articles in this blog are licensed under CC BY-NC-SA 4.0 unless stating additionally.