Python CGI FieldStorage测试工具

Question

如何为Python CGI脚本设置一个小测试工具？我不想运行服务器来测试它，但我确实想为我的测试提供各种GET/POST输入。

在我看来，FieldStorage（或其背后的对象）是完全不可变的，所以我看不到如何在线束中提供CGI数据。

Answer 1

您可以使用模拟库，如Mock来完成这项工作。例如，假设你想从你的CGI脚本测试function_to_test功能，你可以写一个unittest class这样的：

import unittest 
import cgi 

from mock import patch 

def function_to_test(): 
    form = cgi.FieldStorage() 
    if "name" not in form or "addr" not in form: 
     return "<H1>Error</H1>\nPlease fill in the name and address.\n" 
    text = "<p>name: {0}\n<p>addr: {1}\n" 
    return text.format(form["name"].value, form["addr"].value) 

@patch('cgi.FieldStorage') 
class TestClass(unittest.TestCase): 
    class TestField(object): 
     def __init__(self, value): 
      self.value = value 

    FIELDS = { "name" : TestField("Bill"), "addr" : TestField("1 Two Street") } 

    def test_cgi(self, MockClass): 
     instance = MockClass.return_value 
     instance.__getitem__ = lambda s, key: TestClass.FIELDS[key] 
     instance.__contains__ = lambda s, key: key in TestClass.FIELDS 
     text = function_to_test() 
     self.assertEqual(text, "<p>name: Bill\n<p>addr: 1 Two Street\n") 

    def test_err(self, MockClass): 
     instance = MockClass.return_value 
     instance.__contains__ = lambda self, key: False 
     text = function_to_test() 
     self.assertEqual(text, 
      "<H1>Error</H1>\nPlease fill in the name and address.\n") 

如果我运行此代码作为一个单元测试，我得到：

.. 
---------------------------------------------------------------------- 
Ran 2 tests in 0.003s 

OK 

Answer 2

如果你不想使用一个额外的库如Mock：可以用一些测试数据设置一个cgi.FieldStorage对象。下面的Python3的例子假设你指望一个POST输入：

import unittest 
from io import BytesIO 

class TestForm(unittest.TestCase): 

    def setUp(self): 
     """ 
     Makes a cgi.FieldStorage object 
     with some bogus fields. 
     """ 
     # provide a byte string with the parameters 
     # using the format b"name1=value1&name2=value2..." 
     urlencode_data = b"firstname=Joe&lastname=Bloggs&email=joe.bloggs@company.com" 
     urlencode_environ = { 
      'CONTENT_LENGTH': str(len(urlencode_data)), 
      'CONTENT_TYPE':  'application/x-www-form-urlencoded', 
      'QUERY_STRING':  '', 
      'REQUEST_METHOD': 'POST', 
     } 
     data = BytesIO(urlencode_data) 
     data.seek(0) 
     self.fs = cgi.FieldStorage(fp=data, environ=urlencode_environ) 

    # unit test methods come here 
    # form fields are accessible via `self.fs` 

思想来自https://bugs.python.org/file9507/cgitest.py。在那里你可以找到其他有趣的例子，例如形式与文件上传等。

请注意，cgi.FieldStorage的__init__方法是无证的，或者至少我找不到它在current cgi module documentation。