テスト駆動開発 (TDD) アプローチを使用して、Python で文字列計算機を?qū)g裝します。これは、対応する機能を?qū)g裝する前に、各機能のテストを作成することを意味します。

TDD 実裝のチェックポイントとして、リンク https://osherove.com/tdd-kata-1 を參照できます。リンクには、従うことができる段階的な手順が記載されています。

はじめる

プロジェクト フォルダーに、string_calculator.py と testing/test_string_calculator.py の 2 つのファイルを作成します。機能を段階的に実裝していきます。まず、add メソッドを使用して StringCalculator クラスを作成する必要があります。

ステップ 1: 空の文字列は「0」を返す必要があります

unittest ライブラリを使用して、アプリケーションの最初のテストを作成しましょう。 testing/test_string_calculator.py ファイルを開き、次のコードから始めます:

import unittest
from string_calculator import StringCalculator

class TestStringCalculator(unittest.TestCase):
    """Test suite for the StringCalculator class."""

    def setUp(self):
        """
        Create a new instance of StringCalculator for each test.
        Can use static method to avoid creating a new instance.
        """
        self.calculator = StringCalculator()

    def test_empty_string_returns_zero(self):
        """
        Test case: Adding an empty string should return 0.
        Input: "" 
        Expected Output: 0
        """
        self.assertEqual(self.calculator.add(""), 0)

次に、string_calculator.py ファイルに StringCalculator クラスを?qū)g裝しましょう。

class StringCalculator:
    def add(self, numbers:str):
        if not numbers:
            return 0

テストを?qū)g行するには、次の手順に従います:

1. string_calculator.py および testing/test_string_calculator.py ファイルが配置されているプロジェクト ディレクトリにいることを確認してください。

2. ターミナルまたはコマンド プロンプトを開きます。

3. 次のコマンドを?qū)g行してテストを?qū)g行します:
   

python -m unittest discover tests

このコマンドは、tests フォルダー內(nèi)のすべてのテストを自動的に検出して実行します。

期待される出力:

テストに合格すると、次のような內(nèi)容が表示されるはずです。

----------------------------------------------------------------------
Ran 1 test in 0.001s

OK

すべてが正しく設(shè)定され、テスト ケースに合格した場合、空の文字列を処理する実裝が期待どおりに動作していることを意味します。

ステップ 2: 1 つまたは 2 つの數(shù)値を加算すると、その合計が返されるはずです

入力文字列に數(shù)値が 1 つまたは 2 つしかない場合を処理できるようにメソッドを更新する必要があり、それらの合計を返す必要があります?？栅挝淖至肖螆龊?、メソッドは 0 を返す必要があります。

テストを書く

tests/test_string_calculator.py ファイルを開き、すべてのシナリオをカバーする次のテスト ケースを追加します。

    def test_add_single_number(self):
        """
        Test case: Adding a single number should return the number itself.
        Input: "1"
        Expected Output: 1
        """
        self.assertEqual(self.calculator.add("1"), 1)

    def test_add_two_numbers(self):
        """
        Test case: Adding two numbers should return their sum.
        Input: "1,2"
        Expected Output: 3
        """
        self.assertEqual(self.calculator.add("1,2"),3)

コードの実裝

ここで、string_calculator.py ファイルの add メソッドを更新して、1 つまたは 2 つの數(shù)値の加算を処理します。

class StringCalculator:
    def add(self, numbers:str):
        if not numbers:
            return 0
        '''
        Split the string by commas, convert each value to an integer, 
        and sum them up
        '''
        numbers_list = map(int,numbers.split(',')) 
        return sum(numbers_list)

前の手順に従ってコードを再度テストできます。

ステップ 3 : 複數(shù)の番號の処理

メソッドがカンマで區(qū)切られた複數(shù)の數(shù)値を処理できるかどうかを確認するテスト ケースを作成します。

テストを書く

tests/test_string_calculator.py ファイルを開き、複數(shù)の數(shù)値を処理するテスト ケースを追加します。

import unittest
from string_calculator import StringCalculator

class TestStringCalculator(unittest.TestCase):
    """Test suite for the StringCalculator class."""

    def setUp(self):
        """
        Create a new instance of StringCalculator for each test.
        Can use static method to avoid creating a new instance.
        """
        self.calculator = StringCalculator()

    def test_empty_string_returns_zero(self):
        """
        Test case: Adding an empty string should return 0.
        Input: "" 
        Expected Output: 0
        """
        self.assertEqual(self.calculator.add(""), 0)

機能はすでに実裝されているため、コードのテストに進み、次のステップに進むことができます。

ステップ 4: 數(shù)値間の改行の処理

ここで、コンマに加えて、新しい行 (n) を數(shù)値間の有効な區(qū)切り文字として処理できるように add メソッドを強化する必要があります。

テストを書く

tests/test_string_calculator.py ファイルを開き、メソッドが改行を區(qū)切り文字として正しく処理するかどうかを確認するテスト ケースを追加します。

class StringCalculator:
    def add(self, numbers:str):
        if not numbers:
            return 0

コードの実裝

次に、string_calculator.py ファイルの add メソッドを更新して、改行 (n) を區(qū)切り文字として処理します。 n をカンマに置き換えて文字列をカンマで分割するようにメソッドを変更できます。

add メソッドの更新されたコードは次のとおりです:

python -m unittest discover tests

step1 で定義されている前の手順に従って、コードを再度テストできます。

ステップ 5: カスタム區(qū)切り文字の処理

このステップでは、カスタム區(qū)切り文字を使用できるように機能をさらに強化します。たとえば、ユーザーは文字列の先頭にカスタム區(qū)切り文字を指定できる必要があります。例:

• 入力文字列は // で始まり、その後にカスタム區(qū)切り文字が続きます。たとえば、//;n1;2;3 は 6 を返す必要があります。
• //;n1;2;3 のような區(qū)切り文字をサポートします。

テストを書く

tests/test_string_calculator.py ファイルを開き、カスタム區(qū)切り文字機能を処理するテスト ケースを追加します。

----------------------------------------------------------------------
Ran 1 test in 0.001s

OK

コードの実裝

カスタム區(qū)切り文字を処理するには、入力文字列で區(qū)切り文字を検索するように add メソッドを更新します。區(qū)切り文字は、文字列の先頭の //.

の後に指定する必要があります。

更新された追加メソッドは次のとおりです:

    def test_add_single_number(self):
        """
        Test case: Adding a single number should return the number itself.
        Input: "1"
        Expected Output: 1
        """
        self.assertEqual(self.calculator.add("1"), 1)

    def test_add_two_numbers(self):
        """
        Test case: Adding two numbers should return their sum.
        Input: "1,2"
        Expected Output: 3
        """
        self.assertEqual(self.calculator.add("1,2"),3)

ステップ 6: 負の數(shù)の処理

このステップでは、負の數(shù)を処理できるように add メソッドを変更する必要があります。負の數(shù)値が渡された場合は、「負の値は許可されません」というメッセージを含む例外をスローし、渡された負の數(shù)値を含める必要があります。

テストを書く

tests/test_string_calculator.py ファイルを開き、負の數(shù)の例外を処理するテスト ケースを追加します。

class StringCalculator:
    def add(self, numbers:str):
        if not numbers:
            return 0
        '''
        Split the string by commas, convert each value to an integer, 
        and sum them up
        '''
        numbers_list = map(int,numbers.split(',')) 
        return sum(numbers_list)

コードの実裝

ここで、負の數(shù)値をチェックし、適切なメッセージで ValueError を発生させるように add メソッドを変更します。

更新された追加メソッドは次のとおりです:

def test_add_multiple_numbers(self):
    """
    Test case: Adding multiple numbers should return their sum.
    Input: "1,2,3,4,5"
    Expected Output: 15
    """
    self.assertEqual(self.calculator.add("1,2,3,4,5"), 15)

ステップ 7: Add メソッド呼び出しのカウント

このステップでは、add() メソッドが呼び出された回數(shù)を返す GetCalledCount() というメソッドを StringCalculator クラスに追加します。最初に失敗するテストを作成し、次に機能を?qū)g裝するという TDD プロセスに従います。

テストを書く

まず、GetCalledCount() メソッドのテスト ケースを追加します。このテストでは、メソッドが add() の呼び出し回數(shù)を正しくカウントしていることを確認する必要があります。

tests/test_string_calculator.py ファイルを開き、次のテストを追加します:

import unittest
from string_calculator import StringCalculator

class TestStringCalculator(unittest.TestCase):
    """Test suite for the StringCalculator class."""

    def setUp(self):
        """
        Create a new instance of StringCalculator for each test.
        Can use static method to avoid creating a new instance.
        """
        self.calculator = StringCalculator()

    def test_empty_string_returns_zero(self):
        """
        Test case: Adding an empty string should return 0.
        Input: "" 
        Expected Output: 0
        """
        self.assertEqual(self.calculator.add(""), 0)

コードの実裝

次に、StringCalculator クラスに GetCalledCount() メソッドを?qū)g裝します。このメソッドは、add() が呼び出された回數(shù)を追跡する必要があります。

更新された StringCalculator クラスは次のとおりです:

class StringCalculator:
    def add(self, numbers:str):
        if not numbers:
            return 0

ステップ 8 と 9: 1000 を超える數(shù)値を無視し、任意の長さのカスタム區(qū)切り文字を処理する

このステップでは、次の 2 つの要件を?qū)g裝します。

1. 合計では 1000 を超える數(shù)値は無視されます。
2. カスタム區(qū)切り文字は //[delimiter]n の形式で任意の長さにすることができ、メソッドはそれらを処理する必要があります。

最初にこれらの要件の両方に対するテストを作成し、次に StringCalculator クラスに機能を?qū)g裝します。

テストを書く

1000 を超える數(shù)値の無視と、任意の長さのカスタム區(qū)切り文字の処理の両方について、次のテストを追加します。 testing/test_string_calculator.py ファイルを開き、以下を追加します:

python -m unittest discover tests

コードの実裝

次に、StringCalculator クラスに機能を?qū)g裝します。これには以下が含まれます:

1. 1000 を超える數(shù)値は無視されます。
2. 任意の長さのカスタム區(qū)切り文字を処理します。

更新された StringCalculator クラスは次のとおりです:

----------------------------------------------------------------------
Ran 1 test in 0.001s

OK

ステップ 10: 複數(shù)の區(qū)切り文字のサポート

このステップでは、任意の長さの複數(shù)の區(qū)切り文字をサポートするように add() メソッドを変更します。これにより、//[delimiter1][delimiter2]n.

の形式で複數(shù)の區(qū)切り文字がある場合を処理できるようになります。

テストを書く

まず、複數(shù)の區(qū)切り文字をチェックするテスト ケースを追加します。 testing/test_string_calculator.py ファイルを開き、次のテストを追加します:

    def test_add_single_number(self):
        """
        Test case: Adding a single number should return the number itself.
        Input: "1"
        Expected Output: 1
        """
        self.assertEqual(self.calculator.add("1"), 1)

    def test_add_two_numbers(self):
        """
        Test case: Adding two numbers should return their sum.
        Input: "1,2"
        Expected Output: 3
        """
        self.assertEqual(self.calculator.add("1,2"),3)

コードの実裝

次に、複數(shù)の區(qū)切り文字を処理できるように add() メソッドを変更します。區(qū)切り文字は [] 內(nèi)で渡され、//[delimiter1][delimiter2]n.

形式での複數(shù)の區(qū)切り文字の処理をサポートする必要があります。

これをサポートするために更新された StringCalculator クラスは次のとおりです。

class StringCalculator:
    def add(self, numbers:str):
        if not numbers:
            return 0
        '''
        Split the string by commas, convert each value to an integer, 
        and sum them up
        '''
        numbers_list = map(int,numbers.split(',')) 
        return sum(numbers_list)

テストしてみる

テストを再度実行して、古い形式との下位互換性や新しい複數(shù)區(qū)切り文字形式のサポートなど、すべてが機能することを確認します。

def test_add_multiple_numbers(self):
    """
    Test case: Adding multiple numbers should return their sum.
    Input: "1,2,3,4,5"
    Expected Output: 15
    """
    self.assertEqual(self.calculator.add("1,2,3,4,5"), 15)

期待される出力

古い形式と新しい形式の両方でテストに合格する必要があります:

def test_add_numbers_with_newlines(self):
    """
    Test case: Adding numbers separated by newlines should return their sum.
    Input: "1\n2\n3"
    Expected Output: 6
    """
    self.assertEqual(self.calculator.add("1\n2\n3"), 6)

この TDD シリーズをフォローしていただきありがとうございます!お役に立てば幸いです。

以上がテスト駆動開発 (TDD) を使用した文字列計算機の構(gòu)築: ステップバイステップ ガイドの詳細內(nèi)容です。詳細については、PHP 中國語 Web サイトの他の関連記事を參照してください。