Python 2 適用的處理常式測試

適用於 Python 的本機單位測試一文說明如何為應用程式執行單位測試。雖然單位測試非常適合用於測試個別的程式碼單位,但程式碼單位的整合是讓應用程式得以運作的關鍵,因此,整合測試同樣重要。

就 App Engine 應用程式而言,要求處理常式是關鍵的整合點。WSGI 應用程式會將要求路由至適當的處理常式,而處理常式本身則會處理要求資料並產生回應 (如要瞭解詳情,請參閱要求處理常式)。要求處理常式是如同任何其他函式或類別的一般 Python 物件,易於在自動化測試中使用。但由於 WSGI 應用程式將這些要求處理常式包裝成類似 Shell,因此我們會在測試中使用類似的 Shell。

WebTest

我們會在測試中使用 WebTest 架構。WebTest 是針對測試 WSGI 應用程式提供簡易介面的程式庫,因此適用於要求處理常式。其做法是將 WSGI 應用程式包裝在特殊的測試應用程式中,以供後續測試使用。WebTest 可讓您在不具完整 App Engine 環境的情況下與處理常式互動;您可以輕鬆發出要求及修改要求環境。回應也有便於測試的介面。您未必需要使用 WebTest,但 WebTest 確實能讓您事半功倍。

在開始之前,請先在本機電腦或您預計執行處理常式測試的任何電腦上安裝 WebTest。如需操作說明,請前往 http://webtest.pythonpaste.org/#installation

測試簡單的「Hello World」處理常式

讓我們從測試簡單的「Hello World!」處理常式開始著手,以純文字回覆來回應使用者要求。處理常式的回應為「Hello World!」,而內容類型為「text/plain」:

import webapp2
import webtest

class HelloWorldHandler(webapp2.RequestHandler):
   def get(self):
       # Create the handler's response "Hello World!" in plain text.
       self.response.headers['Content-Type'] = 'text/plain'
       self.response.out.write('Hello World!')

接下來,建立測試案例,然後初始化使用處理常式的測試應用程式:

...
class AppTest(unittest.TestCase):
    def setUp(self):
        # Create a WSGI application.
        app = webapp2.WSGIApplication([('/', HelloWorldHandler)])
        # Wrap the app with WebTest’s TestApp.
        self.testapp = webtest.TestApp(app)

    # Test the handler.
    def testHelloWorldHandler(self):
        response = self.testapp.get('/')
        self.assertEqual(response.status_int, 200)
        self.assertEqual(response.normal_body, 'Hello World!')
        self.assertEqual(response.content_type, 'text/plain')

正如您所看見的,WebTest 可讓您使用簡單的 get() 呼叫建立 GET 要求 (其他要求方法也有類似的方法)。傳回值為回應物件,您可以使用該物件測試狀態碼、內文、內容類型等項目;如需可執行所有操作的詳細說明,請參閱 WebTest 首頁

測試使用 App Engine 服務的處理常式

現在,讓我們看看如何測試使用 App Engine 服務的處理常式。這表示我們現在必須處理兩個可能會影響到測試的元件:我們使用的處理常式和服務。如適用於 Python 的本機單位測試一文所述,使用 testbed 是在測試中處理服務的最佳方法。

下列範例使用 Memcache,但其原則與 Datastore 或 Task Queue 等其他服務是相同的。

我們測試的處理常式會快取指定的鍵和值。請注意,我們會剖析要求參數中的兩個值。

from google.appengine.api import memcache
from google.appengine.ext import testbed
import webapp2
import webtest

class CacheHandler(webapp2.RequestHandler):
  def post(self):
    key = self.request.get('key')
    value = self.request.get('value')
    memcache.set(key, value)

如同前述,請在這項測試中先建立應用程式,並使用 WebTest 進行包裝。此外,請啟用 Testbed 執行個體,並務必在測試後停用。

...
class AppTest(unittest.TestCase):

  def setUp(self):
    app = webapp2.WSGIApplication([('/cache/', CacheHandler)])
    self.testapp = webtest.TestApp(app)
    self.testbed = testbed.Testbed()
    self.testbed.activate()

  def tearDown(self):
     self.testbed.deactivate()

  def testCacheHandler(self):
    # First define a key and value to be cached.
    key = 'answer'
    value = '42'
    self.testbed.init_memcache_stub()
    params = {'key': key, 'value': value}
    # Then pass those values to the handler.
    response = self.testapp.post('/cache/', params)
    # Finally verify that the passed-in values are actually stored in Memcache.
    self.assertEqual(value, memcache.get(key))

設定測試架構

您可以視需要設定測試架構。您可以如同 App Engine 的單位測試方法,針對使用 WebTest 的處理常式進行測試。唯一的差別在於您必須確定已安裝 WebTest。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Python 2 適用的 App Engine 標準環境