皆さん、こんにちは。今日は、sheepy という新しい単体テスト ライブラリを紹介するために来ましたが、その前に単体テストの重要性について話しましょう。このライブラリは初心者向けではありません。これを使用して単体テストを行うには、少し特別な注意を払う必要があります。エンドポイントと http エラー チェック モジュールを使用した API テストのみのアサートがあります。

Github リンク: github
PyPi リンク: pypi

実稼働環境にある成熟した自尊心のあるソフトウェアにはすべて単体テストがあり、コード内にすでに存在していたものが引き続き機能するかどうかを把握するため、以前に報告され修正されているバグを防ぐため、または新機能をテストするためです。これは、彼らが物事を前進させており、技術的負債が蓄積していないことを示す良い兆候です。例として Firefox ブラウザを使用してみましょう。すべてのディレクトリには、すでに報告されているバグに対する特定のテストを含む test サブディレクトリがあります。こうすることで、修正されたバグがどこからともなく再び表示されることはなく、すでに修正されたバグが表示されることが保証されます。またどこにもないお金を捨てるということです。時間の経過とともに、より少ないリソースで自分よりも優れた業績を上げている競合他社に、時間、お金、効率、市場シェアを失うことになります。

何かを行うことができないと感じる人は誰でも、その何かを中傷しようとします。単体テストも例外ではありません。各ユースケースをカバーするより良い単体テストを作成するには時間がかかります。人生のすべてのことと同じように、バックエンドの皆さん、たった 1 つのチュートリアルを読んで完璧な API を作成できたとは思えませんが、フロントエンドの皆さんも同じことです。コースを受講してここに来たとは思えません。インターフェイスを完璧にします。したがって、単体テストでは何かが変わるとは考えないでください!

アサーションメソッド

 ----------------------- ------------------------------------------------------- 
| Assertion Method       | Description                                           |
 ----------------------- ------------------------------------------------------- 
| assertEqual(a, b)      | Checks if two values are equal.                       |
| assertNotEqual(a, b)   | Checks if two values are not equal.                   |
| assertTrue(expr)       | Verifies that the expression is True.                 |
| assertFalse(expr)      | Verifies that the expression is False.                |
| assertRaises(exc, fn)  | Asserts that a function raises a specific exception.  |
| assertStatusCode(resp) | Verifies if the response has the expected status code.|
| assertJsonResponse(resp)| Confirms the response is in JSON format.             |
| assertResponseContains(resp, key) | Ensures the response contains a given key. |
 ----------------------- ------------------------------------------------------- 

インストール

インストールは非常に簡単です。pip がインストールされた状態で選択したターミナルを開き、「pip install shepy

」と入力するだけです。

使用例

from sheepy.sheeptest import SheepyTestCase

class ExampleTest(SheepyTestCase):
    def test_success(self):
        self.assertTrue(True)

    def test_failure(self):
        self.assertEqual(1, 2)

    def test_error(self):
        raise Exception("Forced error")

    @SheepyTestCase.skip("Reason to ignore")
    def test_skipped(self):
        pass

    @SheepyTestCase.expectedFailure
    def test_expected_failure(self):
        self.assertEqual(1, 2)

SheepyTestCase クラスは、単体テストを作成および実行するためのいくつかの機能を提供します。これには、アサーティブネス メソッドや、テストのスキップや予期される失敗の処理などの特別な動作を構成するためのメカニズムが含まれます。

ExampleTest クラス内では、5 つのテスト メソッドが定義されています:

test_success: このテストは、assertTrue メソッドに渡された式が true かどうかをチェックします。 True 値が明示的に渡されるため、このテストは成功します。

test_failure: このテストは、assertEqual メソッドを使用して 2 つの値間の等価性をチェックします。ただし、比較される値 1 と 2 は異なるため、テストは失敗します。これは、テストで不整合を検出する必要がある、予想される失敗のケースを示しています。

test_error: このメソッドは、「強制エラー」というメッセージを含む意図的な例外を発生させます。目標は、テスト実行中に発生するエラーに対処するときのシステムの動作をテストすることです。メソッドは例外を処理せずにスローするため、結果はテストでエラーになります。

test_skipped: このテストは SheepyTestCase クラスの Skip メソッドで装飾されています。これは、テストの実行中にスキップされることを意味します。テストをスキップした理由は「無視する理由」として提供され、この正当性は最終テストレポートに表示できます。

test_expected_failure: このメソッドは、expectedFailure デコレータを使用して、失敗が予想されることを示します。メソッド内では 1 と 2 の間の等価性チェックがあり、通常は失敗しますが、デコレータが適用されているため、フレームワークはこの失敗を予期された動作の一部とみなし、エラーとして扱われません。 「予想される失敗」として。

出力

テスト結果:
ExampleTest.test_error: FAIL - 強制エラー
ExampleTest.test_expected_failure: 期待された失敗
例Test.test_failure: FAIL - 1 != 2
例Test.test_skipped: SKIPPED -
例Test.test_success: OK

API テストケース

Sheepy テスト フレームワークの API テストは、簡単かつ強力になるように設計されており、テスターは GET、POST、PUT、DELETE などの一般的な HTTP メソッドを使用して API を操作できます。このフレームワークは、HttpError 例外クラスを介した組み込みエラー管理を備えた、リクエストの送信と応答の処理を簡素化するための専用クラス ApiRequests を提供します。

API をテストする場合、テスト クラスは SheepyTestCase を継承します。SheepyTestCase には、API の動作を検証するためのさまざまなアサーション メソッドが装備されています。これらには、HTTP ステータス コードを検証するためのassertStatusCode、応答が JSON 形式であることを確認するためのassertJsonResponse、応答本文に特定のキーが存在するかどうかを確認するためのassertResponseContains が含まれます。

たとえば、このフレームワークを使用すると、POST リクエストを API に送信し、ステータス コードが期待値と一致することを確認し、JSON 応答に正しいデータが含まれていることをアサートできます。 API リクエストは、リクエストの構築と送信を担当する ApiRequests クラスを通じて処理されますが、サーバーが予期しないステータス コードを返した場合に HTTP 固有のエラーを発生させることでエラー処理が合理化されます。

組み込みのアサーションとエラー処理を提供することにより、フレームワークは API テストの反復タスクの多くを自動化し、テスト作成の正確性と簡素性の両方を保証します。このシステムにより、開発者は API の動作とロジックの検証に集中できるため、API 対話の信頼性を確保するための効率的なツールになります。

sheepy.sheeptest から SheepyTestCase をインポート クラス TestHttpBinApi(SheepyTestCase): def __init__(自分自身): super().__init__(base_url="https://httpbin.org") def test_get_status(self): 応答 = self.api.get("/status/200") self.assertStatusCode(応答, 200) def test_get_json(self): 応答 = self.api.get("/json") self.assertStatusCode(応答, 200) self.assertJsonResponse(応答) self.assertResponseContains(応答, "スライドショー") def test_post_data(self): ペイロード = {"名前": "SheepyTest", "フレームワーク": "ユニットテスト"} 応答 = self.api.post("/post", json=ペイロード) self.assertStatusCode(応答, 200) self.assertJsonResponse(応答) self.assertResponseContains(応答, "json") self.assertEqual(response.json()["json"], ペイロード) def test_put_data(self): ペイロード = {"キー": "値"} 応答 = self.api.put("/put", json=ペイロード) self.assertStatusCode(応答, 200) self.assertJsonResponse(応答) self.assertResponseContains(応答, "json") self.assertEqual(response.json()["json"], ペイロード) def test_delete_resource(self): 応答 = self.api.delete("/delete") self.assertStatusCode(応答, 200) self.assertJsonResponse(応答)

from sheepy.sheeptest import SheepyTestCase  

class TestHttpBinApi(SheepyTestCase):
    def __init__(self):

        super().__init__(base_url="https://httpbin.org")

    def test_get_status(self):

        response = self.api.get("/status/200")
        self.assertStatusCode(response, 200)  

    def test_get_json(self):

        response = self.api.get("/json")
        self.assertStatusCode(response, 200)  
        self.assertJsonResponse(response)  
        self.assertResponseContains(response, "slideshow")  

    def test_post_data(self):

        payload = {"name": "SheepyTest", "framework": "unittest"}
        response = self.api.post("/post", json=payload)
        self.assertStatusCode(response, 200)  
        self.assertJsonResponse(response)  
        self.assertResponseContains(response, "json") 
        self.assertEqual(response.json()["json"], payload)  

    def test_put_data(self):

        payload = {"key": "value"}
        response = self.api.put("/put", json=payload)
        self.assertStatusCode(response, 200)  
        self.assertJsonResponse(response)  
        self.assertResponseContains(response, "json")  
        self.assertEqual(response.json()["json"], payload)  

    def test_delete_resource(self):

        response = self.api.delete("/delete")
        self.assertStatusCode(response, 200)  
        self.assertJsonResponse(response)  

出力例

テスト結果: TestHttpBinApi.test_delete_resource: OK TestHttpBinApi.test_get_json: OK TestHttpBinApi.test_get_status: OK TestHttpBinApi.test_post_data: OK TestHttpBinApi.test_put_data: OK

from sheepy.sheeptest import SheepyTestCase  

class TestHttpBinApi(SheepyTestCase):
    def __init__(self):

        super().__init__(base_url="https://httpbin.org")

    def test_get_status(self):

        response = self.api.get("/status/200")
        self.assertStatusCode(response, 200)  

    def test_get_json(self):

        response = self.api.get("/json")
        self.assertStatusCode(response, 200)  
        self.assertJsonResponse(response)  
        self.assertResponseContains(response, "slideshow")  

    def test_post_data(self):

        payload = {"name": "SheepyTest", "framework": "unittest"}
        response = self.api.post("/post", json=payload)
        self.assertStatusCode(response, 200)  
        self.assertJsonResponse(response)  
        self.assertResponseContains(response, "json") 
        self.assertEqual(response.json()["json"], payload)  

    def test_put_data(self):

        payload = {"key": "value"}
        response = self.api.put("/put", json=payload)
        self.assertStatusCode(response, 200)  
        self.assertJsonResponse(response)  
        self.assertResponseContains(response, "json")  
        self.assertEqual(response.json()["json"], payload)  

    def test_delete_resource(self):

        response = self.api.delete("/delete")
        self.assertStatusCode(response, 200)  
        self.assertJsonResponse(response)  

まとめ：

新しい羊のようなライブラリは、驚くべき単体テスト ライブラリです。API テスト専用のモジュールを含む、いくつかのテスト アクセシオン メソッドが含まれています。私の意見では、これは初心者向けのライブラリではなく、オブジェクト指向プログラミングの基本的な知識が必要です。メソッド、クラス、継承など。