Django4 中文入门教程 Django4.0 进阶测试主题-请求工厂

2024-02-25 开发教程 Django4 中文入门教程匿名 6℃

class RequestFactory

RequestFactory 与测试客户端共享相同的 API。但是，RequestFactory 不能像浏览器那样运行，而是提供一种生成请求实例的方法，该实例可用作任何视图的第一个参数。这意味着您可以像测试任何其他功能一样测试视图函数——就像一个黑匣子一样，具有确切已知的输入，可以测试特定的输出。

RequestFactory 的 API 是测试客户端 API 的一个稍加限制的子集。

它只能访问 HTTP 的 get()、post()、put()、delete()、head()、options() 和 trace() 方法。
这些方法接受所有相同的参数，除了 follow。因为这只是一个产生请求的工厂，所以由你来处理响应。
它不支持中间件。如果需要视图正常运行，会话和认证属性必须由测试本身提供。

例如

下面是一个使用请求工厂的单元测试：

from django.contrib.auth.models import AnonymousUser, User
from django.test import RequestFactory, TestCase
from .views import MyView, my_view
class SimpleTest(TestCase):
    def setUp(self):
        # Every test needs access to the request factory.
        self.factory = RequestFactory()
        self.user = User.objects.create_user(
            username='jacob', email='jacob@…', password='top_secret')
    def test_details(self):
        # Create an instance of a GET request.
        request = self.factory.get('/customer/details')
        # Recall that middleware are not supported. You can simulate a
        # logged-in user by setting request.user manually.
        request.user = self.user
        # Or you can simulate an anonymous user by setting request.user to
        # an AnonymousUser instance.
        request.user = AnonymousUser()
        # Test my_view() as if it were deployed at /customer/details
        response = my_view(request)
        # Use this syntax for class-based views.
        response = MyView.as_view()(request)
        self.assertEqual(response.status_code, 200)

AsyncRequestFactory

RequestFactory 创建 WSGI 类的请求。如果你想创建 ASGI 类的请求，包括有一个正确的 ASGI scope，你可以使用 django.test.AsyncRequestFactory。
该类与 RequestFactory 直接 API 兼容，唯一的区别是它返回 ASGIRequest 实例，而不是 WSGIRequest 实例。它的所有方法仍然是可同步调用的。

上一节： Django4.0 测试工具-忽略测试

下一节： Django4.0 进阶测试主题-测试基于类的视图

"Django4 中文入门教程"的目录

Django4 中文入门教程 Django4.0 进阶测试主题-请求工厂

class RequestFactory

例如

AsyncRequestFactory