Hướng dẫn python patch path - con đường vá python
|
Mới trong phiên bản 3.3. Show
Mã nguồn: lib/unittest/mock.py Lib/unittest/mock.py >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'30 là một thư viện để thử nghiệm trong Python. Nó cho phép bạn thay thế các phần của hệ thống của bạn được thử nghiệm bằng các đối tượng giả và đưa ra các xác nhận về cách chúng đã được sử dụng. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'30 cung cấp lớp lõi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 Loại bỏ sự cần thiết phải tạo một loạt các cuống trong suốt bộ thử nghiệm của bạn. Sau khi thực hiện một hành động, bạn có thể đưa ra các xác nhận về phương thức / thuộc tính nào đã được sử dụng và các đối số mà chúng được gọi. Bạn cũng có thể chỉ định các giá trị trả về và đặt các thuộc tính cần thiết theo cách thông thường. Ngoài ra, Mock cung cấp một trình trang trí >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 xử lý mô -đun vá và các thuộc tính cấp lớp trong phạm vi của một bài kiểm tra, cùng với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'34 để tạo các đối tượng độc đáo. Xem hướng dẫn nhanh để biết một số ví dụ về cách sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32, >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33. Mock được thiết kế để sử dụng với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'38 và dựa trên mẫu ‘hành động -> khẳng định thay vì‘ bản ghi -> phát lại được sử dụng bởi nhiều khung bắt buộc. Có một backport là >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'30 cho các phiên bản Python trước đó, có sẵn dưới dạng giả trên PYPI. Hướng dẫn nhanh¶>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 Các đối tượng Tạo tất cả các thuộc tính và phương thức khi bạn truy cập chúng và lưu trữ chi tiết về cách chúng đã được sử dụng. Bạn có thể định cấu hình chúng, để chỉ định các giá trị trả về hoặc giới hạn các thuộc tính có sẵn và sau đó đưa ra các xác nhận về cách chúng đã được sử dụng: >>> from unittest.mock import MagicMock >>> thing = ProductionClass() >>> thing.method = MagicMock(return_value=3) >>> thing.method(3, 4, 5, key='value') 3 >>> thing.method.assert_called_with(3, 4, 5, key='value') >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 cho phép bạn thực hiện các tác dụng phụ, bao gồm cả việc tăng ngoại lệ khi một giả được gọi: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo' >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3) Mock có nhiều cách khác mà bạn có thể định cấu hình và kiểm soát hành vi của nó. Ví dụ, đối số Spec cấu hình giả để lấy thông số kỹ thuật của nó từ một đối tượng khác. Cố gắng truy cập các thuộc tính hoặc phương thức trên chế độ giả mà don lồng tồn tại trên thông số kỹ thuật sẽ thất bại với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'43. Bộ trang trí / Trình quản lý bối cảnh >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 giúp dễ dàng chế giễu các lớp hoặc đối tượng trong một mô -đun được thử nghiệm. Đối tượng bạn chỉ định sẽ được thay thế bằng một giả (hoặc đối tượng khác) trong quá trình kiểm tra và khôi phục khi thử nghiệm kết thúc: >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test() Ghi chú Khi bạn làm tổ trang trí, các chế độ giả được chuyển vào chức năng được trang trí theo cùng thứ tự chúng được áp dụng (thứ tự python bình thường mà các nhà trang trí được áp dụng). Điều này có nghĩa là từ dưới lên, vì vậy trong ví dụ phía trên chế độ giả cho >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'45 được thông qua đầu tiên. Với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33, vấn đề là bạn vá các đối tượng trong không gian tên nơi chúng được nhìn lên. Điều này thường đơn giản, nhưng đối với một hướng dẫn nhanh, hãy đọc nơi để vá.where to patch. Cũng như một người trang trí >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 có thể được sử dụng làm trình quản lý bối cảnh trong một câu lệnh: >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3) Ngoài ra còn có >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 để thiết lập các giá trị trong một từ điển chỉ trong một phạm vi và khôi phục từ điển về trạng thái ban đầu của nó khi thử nghiệm kết thúc: >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original Mock hỗ trợ việc chế giễu các phương pháp ma thuật Python. Cách dễ nhất để sử dụng các phương thức ma thuật là với lớp >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36. Nó cho phép bạn làm những việc như:magic methods. The easiest way of using magic methods is with the >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 class. It allows you to do things like: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with() Mock cho phép bạn gán các chức năng (hoặc các phiên bản giả khác) cho các phương thức ma thuật và chúng sẽ được gọi là thích hợp. Lớp >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 chỉ là một biến thể giả có tất cả các phương pháp ma thuật được tạo sẵn cho bạn (tốt, tất cả đều là những phương pháp hữu ích). Sau đây là một ví dụ về việc sử dụng các phương thức ma thuật với lớp giả thông thường: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee' Để đảm bảo rằng các đối tượng giả trong các thử nghiệm của bạn có cùng API với các đối tượng chúng đang thay thế, bạn có thể sử dụng tự động. Tự động sử dụng có thể được thực hiện thông qua đối số Autospec thành bản vá hoặc hàm >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'51. Tự động tạo ra các đối tượng giả có cùng thuộc tính và phương thức như các đối tượng chúng đang thay thế, và bất kỳ hàm và phương thức nào (bao gồm cả các hàm tạo) đều có chữ ký cuộc gọi giống như đối tượng thực.auto-speccing. Auto-speccing can be done through the autospec argument to patch, or the >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'51 function. Auto-speccing creates mock objects that have the same attributes and methods as the objects they are replacing, and any functions and methods (including constructors) have the same call signature as the real object. Điều này đảm bảo rằng giả của bạn sẽ thất bại theo cách tương tự như mã sản xuất của bạn nếu chúng được sử dụng không chính xác: >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'51 cũng có thể được sử dụng trên các lớp, trong đó nó sao chép chữ ký của phương thức >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'53 và trên các đối tượng có thể gọi được trong đó nó sao chép chữ ký của phương thức >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'54. Lớp giả>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 là một đối tượng giả linh hoạt nhằm thay thế việc sử dụng các cuống và kiểm tra đôi trong suốt mã của bạn. Mocks có thể gọi được và tạo các thuộc tính dưới dạng giả mới khi bạn truy cập chúng 1. Truy cập cùng một thuộc tính sẽ luôn trả về cùng một giả. Mocks ghi lại cách bạn sử dụng chúng, cho phép bạn đưa ra các xác nhận về những gì mã của bạn đã làm với chúng. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 là một lớp con của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 với tất cả các phương pháp ma thuật được tạo sẵn và sẵn sàng để sử dụng. Ngoài ra còn có các biến thể không thể gọi được, hữu ích khi bạn đang chế giễu các đối tượng có thể gọi được: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'58 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'59 Các nhà trang trí >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 giúp dễ dàng thay thế các lớp trong một mô -đun cụ thể bằng một đối tượng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32. Theo mặc định >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 sẽ tạo >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 cho bạn. Bạn có thể chỉ định một lớp thay thế >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 bằng cách sử dụng đối số new_callable thành >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33. classunittest.mock.mock (spec = none, side_effect = none, return_value = default, wraps = none, name = none, spec_set = noneunittest.mock.Mock(spec=None, side_effect=None, return_value=DEFAULT, wraps=None, name=None, spec_set=None, unsafe=False, **kwargs)¶ Tạo một đối tượng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 mới. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 có một số đối số tùy chọn xác định hành vi của đối tượng giả:
Mocks cũng có thể được gọi với các đối số từ khóa tùy ý. Chúng sẽ được sử dụng để đặt các thuộc tính trên giả sau khi nó được tạo. Xem phương thức >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'80 để biết chi tiết. assert_called () ¶()¶ Khẳng định rằng giả được gọi ít nhất một lần. >>> mock = Mock() >>> mock.method() Mới trong phiên bản 3.6. assert_called_once () ¶()¶Khẳng định rằng giả được gọi là chính xác một lần. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'0 Mới trong phiên bản 3.6. assert_called_once () ¶(*args, **kwargs)¶Khẳng định rằng giả được gọi là chính xác một lần. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'1 assert_called_with (*args, ** kwargs) ¶(*args, **kwargs)¶ Phương pháp này là một cách thuận tiện để khẳng định rằng cuộc gọi cuối cùng đã được thực hiện theo một cách cụ thể: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'2 assert_called_once_with (*args, ** kwargs) ¶(*args, **kwargs)¶ Khẳng định rằng giả được gọi là chính xác một lần và cuộc gọi đó là với các đối số được chỉ định. assert_any_call (*args, ** kwargs) ¶ >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'3 khẳng định giả đã được gọi với các đối số được chỉ định.(calls, any_order=False)¶ Assert vượt qua nếu giả đã được gọi, không giống như >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'81 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'82 chỉ vượt qua nếu cuộc gọi là cuộc gọi gần đây nhất, và trong trường hợp >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'82 cũng phải là cuộc gọi duy nhất. assert_has_calls (cuộc gọi, any_order = false) ¶ khẳng định giả đã được gọi với các cuộc gọi được chỉ định. Danh sách >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84 được kiểm tra các cuộc gọi. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'4 Nếu Any_order là sai thì các cuộc gọi phải được tuần tự. Có thể có thêm các cuộc gọi trước hoặc sau các cuộc gọi được chỉ định.()¶ Nếu Any_order là đúng thì các cuộc gọi có thể theo bất kỳ thứ tự nào, nhưng tất cả chúng phải xuất hiện trong >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'5 Mới trong phiên bản 3.5. Wraps: Mục cho đối tượng giả để bọc. Nếu Wraps không phải là>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74 thì việc gọi Mock sẽ chuyển cuộc gọi qua đối tượng được gói (trả về kết quả thực). Truy cập thuộc tính trên giả sẽ trả về một đối tượng giả kết thúc thuộc tính tương ứng của đối tượng được bọc (do đó, cố gắng truy cập một thuộc tính không tồn tại sẽ tăng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'43).(*, return_value=False, side_effect=False)¶ Nếu Mock có một bộ trả về rõ ràng_value thì các cuộc gọi không được chuyển đến đối tượng được bọc và thay vào đó, return_value được trả về. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'6 Tên: Nếu giả có một tên thì nó sẽ được sử dụng trong repr of the Mock. Điều này có thể hữu ích để gỡ lỗi. Tên được nhân giống đến chế giễu trẻ em.Added two keyword only argument to the reset_mock function. Mocks cũng có thể được gọi với các đối số từ khóa tùy ý. Chúng sẽ được sử dụng để đặt các thuộc tính trên giả sau khi nó được tạo. Xem phương thức >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'80 để biết chi tiết. Ghi chú return_value và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 chỉ là đối số từ khóa. Mock_add_spec (spec, spec_set = false) ¶(spec, spec_set=False)¶ Thêm một thông số kỹ thuật vào một giả. Thông số kỹ thuật có thể là một đối tượng hoặc một danh sách các chuỗi. Chỉ các thuộc tính trên thông số kỹ thuật mới có thể được tìm nạp dưới dạng các thuộc tính từ giả. Nếu spec_set là đúng thì chỉ có thể đặt các thuộc tính trên thông số kỹ thuật. bomptep_mock (giả, thuộc tính) ¶(mock, attribute)¶Đính kèm một giả làm một thuộc tính của cái này, thay thế tên và cha mẹ của nó. Các cuộc gọi đến Mock đính kèm sẽ được ghi lại trong các thuộc tính >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'91 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84 của cái này. Cấu hình_mock (** kwargs) ¶(**kwargs)¶ Đặt các thuộc tính trên giả thông qua các đối số từ khóa. Các thuộc tính cộng với các giá trị trả về và các tác dụng phụ có thể được đặt trên các chế giễu trẻ em bằng cách sử dụng ký hiệu dấu chấm tiêu chuẩn và giải nén từ điển trong cuộc gọi phương thức: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'7 Điều tương tự có thể đạt được trong cuộc gọi xây dựng đến Mocks: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'8 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'80 tồn tại để làm cho cấu hình dễ dàng hơn sau khi giả được tạo. __dir __ ()()¶ >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 Các đối tượng giới hạn kết quả của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'95 là kết quả hữu ích. Đối với các chế giễu với một thông số kỹ thuật này bao gồm tất cả các thuộc tính được phép cho giả. Xem >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'96 để biết những gì bộ lọc này làm và cách tắt nó. _get_child_mock (** kw) ¶(**kw)¶ Tạo các chế giễu trẻ em cho các thuộc tính và giá trị trả về. Theo mặc định, chế giễu trẻ em sẽ có cùng loại với cha mẹ. Các lớp con của Mock có thể muốn ghi đè lên điều này để tùy chỉnh cách chế tạo trẻ em. Đối với giả không thể gọi, biến thể có thể gọi sẽ được sử dụng (thay vì bất kỳ lớp con tùy chỉnh nào). gọi lබMột boolean đại diện cho việc đối tượng giả có được gọi là: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'9 Call_Count¶¶ Một số nguyên cho bạn biết bao nhiêu lần đối tượng giả đã được gọi: >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)0 return_value¶¶ Đặt cái này để định cấu hình giá trị được trả về bằng cách gọi Mock: >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)1 Giá trị trả về mặc định là một đối tượng giả và bạn có thể định cấu hình nó theo cách thông thường: >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)2 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'75 cũng có thể được đặt trong hàm tạo: >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)3 tác dụng phụ¶¶ Đây có thể là một chức năng được gọi khi giả được gọi, một điều khác biệt hoặc một ngoại lệ (lớp hoặc thể hiện) sẽ được nêu ra. Nếu bạn chuyển trong một hàm, nó sẽ được gọi với cùng một đối số với giả và trừ khi hàm trả về >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'73 singleton, cuộc gọi cho giả sau đó sẽ trả về bất kỳ chức năng nào trả về. Nếu hàm trả về >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'73 thì Mock sẽ trả về giá trị bình thường của nó (từ >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'75). Nếu bạn vượt qua một điều khác, nó được sử dụng để truy xuất một trình lặp phải mang lại một giá trị cho mỗi cuộc gọi. Giá trị này có thể là một trường hợp ngoại lệ được nâng lên hoặc giá trị được trả về từ cuộc gọi cho giả (xử lý >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'73 giống hệt với trường hợp hàm). Một ví dụ về một chế độ giả tạo ra một ngoại lệ (để kiểm tra ngoại lệ xử lý API): >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)4 Sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 để trả về một chuỗi các giá trị: >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)5 Sử dụng một cuộc gọi có thể gọi được: >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)6 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 có thể được đặt trong hàm tạo. Ở đây, một ví dụ thêm một vào giá trị mà giả được gọi và trả về nó: >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)7 Cài đặt >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 thành >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74 Xóa nó: >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)8 Call_args¶¶ Đây là >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74 (nếu giả đã được gọi), hoặc các lập luận mà giả được gọi lần cuối. Điều này sẽ ở dạng một tuple: thành viên đầu tiên, cũng có thể được truy cập thông qua thuộc tính >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)07, là bất kỳ đối số được đặt hàng nào mà Mock được gọi với (hoặc một tuple trống) và thành viên thứ hai, cũng có thể được truy cập thông qua thuộc tính >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)08, là bất kỳ đối số từ khóa nào (hoặc từ điển trống). >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)9 >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)09, cùng với các thành viên của danh sách >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)10, >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'91 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84 là các đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)13. Đây là những bộ dữ liệu, vì vậy chúng có thể được giải nén để có được các đối số riêng lẻ và đưa ra những khẳng định phức tạp hơn. Xem các cuộc gọi là Tuples.calls as tuples. Đã thay đổi trong phiên bản 3.8: Đã thêm các thuộc tính >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)07 and >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)08 properties. call_args_list¶¶ Đây là danh sách tất cả các cuộc gọi được thực hiện cho đối tượng giả theo trình tự (vì vậy độ dài của danh sách là số lần nó được gọi). Trước khi bất kỳ cuộc gọi nào được thực hiện, nó là một danh sách trống. Đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)13 có thể được sử dụng để xây dựng một cách thuận tiện các danh sách các cuộc gọi để so sánh với >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)10. >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()0 Các thành viên của >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)10 là đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)13. Đây có thể được giải nén dưới dạng bộ dữ liệu để có được các đối số riêng lẻ. Xem các cuộc gọi là Tuples.calls as tuples. Phương pháp_Calls¶¶ Cũng như theo dõi các cuộc gọi đến chính họ, các chế giễu cũng theo dõi các cuộc gọi đến các phương thức và thuộc tính, và các phương thức và thuộc tính của chúng: >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()1 Các thành viên của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'91 là đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)13. Đây có thể được giải nén dưới dạng bộ dữ liệu để có được các đối số riêng lẻ. Xem các cuộc gọi là Tuples.calls as tuples. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84 ghi lại tất cả các cuộc gọi đến đối tượng giả, các phương thức, phương thức ma thuật và chế giễu giá trị trả về. >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()2 Các thành viên của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84 là đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)13. Đây có thể được giải nén dưới dạng bộ dữ liệu để có được các đối số riêng lẻ. Xem các cuộc gọi là Tuples.calls as tuples. Ghi chú Cách >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84 được ghi lại có nghĩa là nơi các cuộc gọi lồng nhau được thực hiện, các tham số của các cuộc gọi tổ tiên không được ghi lại và do đó sẽ luôn so sánh bằng nhau: >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()3 __lớp__¶¶ Thông thường thuộc tính >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'69 của một đối tượng sẽ trả về loại của nó. Đối với một đối tượng giả với >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)27, >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'69 trả về lớp Spec. Điều này cho phép các đối tượng giả vượt qua các thử nghiệm >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'70 cho đối tượng họ đang thay thế / giả dạng như: >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()4 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'69 có thể được gán cho, điều này cho phép một chế độ giả vượt qua kiểm tra >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'70 mà không buộc bạn sử dụng thông số kỹ thuật: >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()5 classunittest.mock.noncallablemock (spec = none, wraps = none, name = none, spec_set = none, ** kwargs) ¶unittest.mock.NonCallableMock(spec=None, wraps=None, name=None, spec_set=None, **kwargs)¶ Một phiên bản không thể gọi của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32. Các tham số của hàm tạo có cùng ý nghĩa của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32, ngoại trừ return_value và side_effect không có ý nghĩa trên một giả không thể gọi được. Các đối tượng giả sử dụng một lớp hoặc một thể hiện dưới dạng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)27 hoặc >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)35 có thể vượt qua các bài kiểm tra >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'70: >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()6 Các lớp >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 có hỗ trợ cho các phương pháp ma thuật chế giễu. Xem Phương pháp ma thuật để biết chi tiết đầy đủ.magic methods for the full details. Các lớp giả và các nhà trang trí >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 đều có các đối số từ khóa tùy ý cho cấu hình. Đối với các nhà trang trí >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33, các từ khóa được chuyển cho hàm tạo của giả được tạo. Các đối số từ khóa là để định cấu hình các thuộc tính của giả: >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()7 Giá trị trả về và tác dụng phụ của giả trẻ em có thể được đặt theo cùng một cách, sử dụng ký hiệu chấm. Vì bạn có thể sử dụng các tên chấm trực tiếp trong một cuộc gọi, bạn phải tạo một từ điển và giải nén nó bằng cách sử dụng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)40: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'8 Một chế độ giả có thể gọi được được tạo ra với một thông số kỹ thuật (hoặc một spec_set) sẽ hướng nội vào chữ ký của đối tượng đặc tả khi khớp các cuộc gọi với giả. Do đó, nó có thể khớp với các đối số cuộc gọi thực tế bất kể chúng được thông qua vị trí hay theo tên: >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()9 Điều này áp dụng cho >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'81, >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'82, >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)43 và >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)44. Khi tự động hóa, nó cũng sẽ áp dụng cho các cuộc gọi phương thức trên đối tượng giả.Autospeccing, it will also apply to method calls on the mock object. classunittest.mock.propertymock (*args, ** kwargs) ¶unittest.mock.PropertyMock(*args, **kwargs)¶ Một giả dự định được sử dụng làm tài sản hoặc mô tả khác trên một lớp. >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)45 cung cấp các phương thức >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)46 và >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)47 để bạn có thể chỉ định giá trị trả về khi nó được tìm nạp. Tìm nạp một ví dụ >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)45 từ một đối tượng gọi là giả, không có args. Đặt nó gọi là giả với giá trị được đặt. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)0 Do cách lưu trữ các thuộc tính giả, bạn có thể gắn trực tiếp một >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)45 vào một đối tượng giả. Thay vào đó, bạn có thể gắn nó vào đối tượng loại giả: >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)1 classunittest.mock.asyncmock (spec = none, side_effect = none, return_value = default, wraps = none, name = none, spec_set = none, không an toàn = false unittest.mock.AsyncMock(spec=None, side_effect=None, return_value=DEFAULT, wraps=None, name=None, spec_set=None, unsafe=False, **kwargs)¶ Một phiên bản không đồng bộ của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36. Đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)51 sẽ hoạt động để đối tượng được công nhận là hàm async và kết quả của một cuộc gọi là một cuộc gọi có thể chờ đợi. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)2 Kết quả của >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)52 là một hàm async sẽ có kết quả của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 hoặc >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'75 sau khi nó đã được chờ đợi:
Đặt thông số kỹ thuật của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 hoặc >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 thành hàm async sẽ dẫn đến một đối tượng coroutine được trả về sau khi gọi. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)3 Đặt thông số của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32, >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 hoặc >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)51 thành một lớp có hàm đồng bộ và đồng bộ sẽ tự động phát hiện các hàm đồng bộ và đặt chúng là >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 . Tất cả các chức năng không đồng bộ sẽ là >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)51. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)4 Mới trong phiên bản 3.8. assert_awaited ()()¶Khẳng định rằng giả đã được chờ đợi ít nhất một lần. Lưu ý rằng điều này tách biệt với đối tượng đã được gọi, từ khóa >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)73 phải được sử dụng: >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)5 assert_awaited_once () ¶()¶ Khẳng định rằng giả đã được chờ đợi chính xác một lần. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)6 assert_awaited_with (*args, ** kwargs) ¶(*args, **kwargs)¶ Khẳng định rằng cuối cùng đang chờ đợi là với các đối số được chỉ định. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)7 assert_awaited_once_with (*args, ** kwargs) ¶(*args, **kwargs)¶ Khẳng định rằng giả đã được chờ đợi chính xác một lần và với các đối số được chỉ định. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)8 assert_any_await (*args, ** kwargs) ¶(*args, **kwargs)¶ Khẳng định giả đã từng được chờ đợi với các đối số được chỉ định. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)9 assert_has_awaits (cuộc gọi, any_order = false) ¶(calls, any_order=False)¶ Khẳng định giả đã được chờ đợi với các cuộc gọi được chỉ định. Danh sách >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)74 được kiểm tra các bản chờ. Nếu Any_order là sai thì các chờ đợi phải được tuần tự. Có thể có thêm các cuộc gọi trước hoặc sau khi được chỉ định đang chờ. Nếu Any_order là đúng thì các chờ đợi có thể theo bất kỳ thứ tự nào, nhưng tất cả chúng phải xuất hiện trong >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)74. >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original0 assert_not_awaited () ¶()¶ Khẳng định rằng giả không bao giờ được chờ đợi. >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original1 reset_mock (*args, ** kwargs) ¶(*args, **kwargs)¶ Xem >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)76. Cũng đặt >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)77 thành 0, >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)78 thành không có và xóa >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)74. Await_Count¶¶ Một số nguyên theo dõi số lần đối tượng giả đã được chờ đợi. >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original2 Await_args¶¶ Đây là >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74 (nếu giả đã được chờ đợi), hoặc các lập luận mà giả được chờ đợi lần cuối. Có chức năng giống như >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)81. >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original3 Await_args_list¶¶ Đây là danh sách tất cả các phần đang chờ được thực hiện cho đối tượng giả theo trình tự (vì vậy độ dài của danh sách là số lần nó đã được chờ đợi). Trước khi bất kỳ sự chờ đợi đã được thực hiện, nó là một danh sách trống. >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original4 Gọi tắtĐối tượng giả có thể gọi được. Cuộc gọi sẽ trả về giá trị được đặt làm thuộc tính >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'75. Giá trị trả về mặc định là một đối tượng giả mới; Nó được tạo ra lần đầu tiên giá trị trả về được truy cập (rõ ràng hoặc bằng cách gọi giả) - nhưng nó được lưu trữ và cùng một lần trả về mỗi lần. Các cuộc gọi được thực hiện cho đối tượng sẽ được ghi lại trong các thuộc tính như >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)09 và >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)10. Nếu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 được đặt thì nó sẽ được gọi sau khi cuộc gọi đã được ghi lại, vì vậy nếu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 sẽ đặt ra một ngoại lệ, cuộc gọi vẫn được ghi lại. Cách đơn giản nhất để làm cho một chế độ giả tạo ra một ngoại lệ khi được gọi là biến >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 thành một lớp hoặc thể hiện ngoại lệ: >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original5 Nếu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 là một chức năng thì bất cứ điều gì mà hàm đó trả về là những gì gọi cho sự trở lại giả. Hàm >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 được gọi với các đối số tương tự như giả. Điều này cho phép bạn thay đổi giá trị trả về của cuộc gọi một cách linh hoạt, dựa trên đầu vào: >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original6 Nếu bạn muốn Mock vẫn trả về giá trị trả về mặc định (một giả mới) hoặc bất kỳ giá trị trả về được đặt nào, thì có hai cách để làm điều này. Trả lại >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)90 từ bên trong >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 hoặc trả về >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'73: >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original7 Để xóa >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 và quay lại hành vi mặc định, hãy đặt >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 thành >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74: >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original8 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 cũng có thể là bất kỳ đối tượng có thể lặp lại. Các cuộc gọi lặp đi lặp lại cho Mock sẽ trả về các giá trị từ Itable (cho đến khi có thể cạn kiệt và >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)97 được nâng lên): >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original9 Nếu bất kỳ thành viên nào trong số đó là ngoại lệ, họ sẽ được nuôi dưỡng thay vì trả lại: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()0 Xóa các thuộc tínhĐối tượng giả tạo các thuộc tính theo yêu cầu. Điều này cho phép họ giả vờ là đối tượng của bất kỳ loại nào. Bạn có thể muốn một đối tượng giả phải trả lại >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)98 cho cuộc gọi >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)99 hoặc tăng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'43 khi một thuộc tính được tìm nạp. Bạn có thể làm điều này bằng cách cung cấp một đối tượng dưới dạng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)27 cho một chế độ giả, nhưng đó không phải là luôn luôn thuận tiện. Bạn có thể chặn các thuộc tính bằng cách xóa chúng. Sau khi bị xóa, việc truy cập một thuộc tính sẽ tăng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'43. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()1 Tên giả và thuộc tính tênVì tên gọi tên là một đối số cho hàm tạo >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32, nếu bạn muốn đối tượng giả của bạn có thuộc tính tên của tên, bạn có thể chỉ cần vượt qua nó vào thời điểm sáng tạo. Có hai lựa chọn thay thế. Một tùy chọn là sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'80: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()2 Một tùy chọn đơn giản hơn là chỉ cần đặt thuộc tính tên của tên gọi sau khi tạo ra giả: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()3 Đính kèm giả là thuộc tínhKhi bạn gắn một giả làm một thuộc tính của một chế độ giả khác (hoặc là giá trị trả về), nó trở thành một đứa trẻ của người Hồi giáo của giả đó. Các cuộc gọi đến trẻ được ghi lại trong các thuộc tính >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'91 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84 của cha mẹ. Điều này rất hữu ích cho việc định cấu hình các chế giễu trẻ em và sau đó gắn chúng vào cha mẹ hoặc để đính kèm giả với cha mẹ ghi lại tất cả các cuộc gọi cho con cái và cho phép bạn đưa ra các xác nhận về thứ tự các cuộc gọi giữa các giả: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()4 Ngoại lệ cho điều này là nếu giả có một tên. Điều này cho phép bạn ngăn chặn việc nuôi dạy con cái của người Viking nếu vì một lý do nào đó mà bạn không muốn điều đó xảy ra. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()5 Mocks được tạo cho bạn bởi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 được đặt tên tự động. Để đính kèm các giả có tên vào cha mẹ, bạn sử dụng phương thức >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()08: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()61 Ngoại lệ duy nhất là các phương pháp và thuộc tính ma thuật (những người có dấu gạch dưới và dẫn đầu đôi). Mock doesn tạo ra những thứ này nhưng thay vào đó là tăng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'43. Điều này là do thông dịch viên thường sẽ hoàn toàn yêu cầu các phương pháp này và rất bối rối để có được một đối tượng giả mới khi nó mong đợi một phương pháp ma thuật. Nếu bạn cần Phương pháp ma thuật hỗ trợ, hãy xem Phương pháp ma thuật.magic methods. The Patchers¶Các bộ trang trí bản vá được sử dụng để vá các đối tượng chỉ trong phạm vi của chức năng mà chúng trang trí. Họ tự động xử lý việc không phù hợp cho bạn, ngay cả khi các ngoại lệ được nêu ra. Tất cả các chức năng này cũng có thể được sử dụng trong các tuyên bố hoặc là người trang trí lớp. vá¶Ghi chú Điều quan trọng là thực hiện bản vá trong không gian tên phải. Xem phần nơi để vá. unittest.mock.patch (Target, new = default, spec = nonepatch(target, new=DEFAULT, spec=None, create=False, spec_set=None, autospec=None, new_callable=None, **kwargs)¶>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 hoạt động như một người trang trí chức năng, người trang trí lớp học hoặc người quản lý bối cảnh. Bên trong phần thân của hàm hoặc với câu lệnh, mục tiêu được vá bằng một đối tượng mới. Khi hàm/với câu lệnh ra, bản vá được hoàn tác. Nếu mới bị bỏ qua, thì mục tiêu sẽ được thay thế bằng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)51 nếu đối tượng được vá là hàm async hoặc >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 khác. Nếu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 được sử dụng như một người trang trí và mới bị bỏ qua, chế độ giả được tạo ra được chuyển vào như một lập luận bổ sung cho chức năng được trang trí. Nếu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 được sử dụng làm Trình quản lý bối cảnh, Mock đã tạo được trả về bởi Trình quản lý ngữ cảnh. Mục tiêu phải là một chuỗi trong Mẫu >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()15. Mục tiêu được nhập và đối tượng được chỉ định được thay thế bằng đối tượng mới, vì vậy mục tiêu phải được nhập từ môi trường mà bạn đang gọi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33. Mục tiêu được nhập khi chức năng trang trí được thực hiện, không phải vào thời điểm trang trí. Các đối số từ khóa Spec_set được truyền đến >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 nếu bản vá đang tạo một bản vá cho bạn. Ngoài ra, bạn có thể vượt qua >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()18 hoặc >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()19, điều này khiến bản vá chuyển qua đối tượng bị chế giễu dưới dạng đối tượng spec/spec_set. new_callable cho phép bạn chỉ định một lớp khác hoặc đối tượng có thể gọi được, sẽ được gọi để tạo đối tượng mới. Theo mặc định >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)51 được sử dụng cho các hàm Async và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 cho phần còn lại. Một dạng thông số kỹ thuật mạnh mẽ hơn là Autospec. Nếu bạn đặt >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()22 thì giả sẽ được tạo bằng một thông số kỹ thuật từ đối tượng được thay thế. Tất cả các thuộc tính của giả cũng sẽ có thông số kỹ thuật của thuộc tính tương ứng của đối tượng được thay thế. Các phương pháp và chức năng bị chế giễu sẽ kiểm tra đối số của họ và sẽ tăng >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()23 nếu chúng được gọi với chữ ký sai. Đối với việc giả thay thế một lớp, giá trị trả về của chúng (’thể hiện) sẽ có cùng thông số kỹ thuật với lớp. Xem hàm >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'51 và tự động.Autospeccing. Thay vì >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()22, bạn có thể vượt qua >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()26 để sử dụng một đối tượng tùy ý làm thông số kỹ thuật thay vì cái được thay thế. Theo mặc định >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 sẽ không thay thế các thuộc tính mà don lồng tồn tại. Nếu bạn vượt qua trong >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()28 và thuộc tính không tồn tại, bản vá sẽ tạo thuộc tính cho bạn khi hàm được vá được gọi và xóa lại sau khi hàm được vá đã thoát. Điều này rất hữu ích để viết các bài kiểm tra chống lại các thuộc tính mà mã sản xuất của bạn tạo ra trong thời gian chạy. Nó bị tắt theo mặc định vì nó có thể nguy hiểm. Với nó được bật lên, bạn có thể viết các bài kiểm tra vượt qua đối với API mà don thực sự tồn tại! Ghi chú Điều quan trọng là thực hiện bản vá trong không gian tên phải. Xem phần nơi để vá.If you are patching builtins in a module then you don’t need to pass >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()28, it will be added by default. unittest.mock.patch (Target, new = default, spec = none >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 hoạt động như một người trang trí chức năng, người trang trí lớp học hoặc người quản lý bối cảnh. Bên trong phần thân của hàm hoặc với câu lệnh, mục tiêu được vá bằng một đối tượng mới. Khi hàm/với câu lệnh ra, bản vá được hoàn tác. Nếu mới bị bỏ qua, thì mục tiêu sẽ được thay thế bằng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)51 nếu đối tượng được vá là hàm async hoặc >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 khác. Nếu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 được sử dụng như một người trang trí và mới bị bỏ qua, chế độ giả được tạo ra được chuyển vào như một lập luận bổ sung cho chức năng được trang trí. Nếu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 được sử dụng làm Trình quản lý bối cảnh, Mock đã tạo được trả về bởi Trình quản lý ngữ cảnh. Mục tiêu phải là một chuỗi trong Mẫu >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()15. Mục tiêu được nhập và đối tượng được chỉ định được thay thế bằng đối tượng mới, vì vậy mục tiêu phải được nhập từ môi trường mà bạn đang gọi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33. Mục tiêu được nhập khi chức năng trang trí được thực hiện, không phải vào thời điểm trang trí. Các đối số từ khóa Spec_set được truyền đến >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 nếu bản vá đang tạo một bản vá cho bạn. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()7 Việc vá một lớp thay thế lớp với một thể hiện >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36. Nếu lớp được khởi tạo trong mã được kiểm tra thì đó sẽ là >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'75 của giả sẽ được sử dụng. Nếu lớp được khởi tạo nhiều lần, bạn có thể sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 để trả lại một chế độ giả mới mỗi lần. Ngoài ra, bạn có thể đặt return_value thành bất cứ thứ gì bạn muốn. Để định cấu hình các giá trị trả về trên các phương thức của các trường hợp trên lớp được vá, bạn phải thực hiện điều này trên >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'75. Ví dụ: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()8 Nếu bạn sử dụng spec hoặc spec_set và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 đang thay thế một lớp, thì giá trị trả về của giả tạo sẽ có cùng một thông số kỹ thuật. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()9 Đối số new_callable rất hữu ích khi bạn muốn sử dụng một lớp thay thế cho mặc định >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 cho giả tạo. Ví dụ: nếu bạn muốn sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'58: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'0 Một trường hợp sử dụng khác có thể là thay thế một đối tượng bằng một thể hiện >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()51: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'1 Khi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 đang tạo ra một sự giả tạo cho bạn, điều phổ biến là điều đầu tiên bạn cần làm là định cấu hình giả. Một số cấu hình đó có thể được thực hiện trong cuộc gọi đến bản vá. Bất kỳ từ khóa tùy ý nào bạn chuyển vào cuộc gọi sẽ được sử dụng để đặt các thuộc tính trên chế tạo đã tạo: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'2 Cũng như các thuộc tính trên các thuộc tính giả tạo, như >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'75 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42, của các chế giễu trẻ em cũng có thể được cấu hình. Các aren này có giá trị về mặt cú pháp để truyền trực tiếp dưới dạng các đối số từ khóa, nhưng từ điển với các khóa này vẫn có thể được mở rộng thành một cuộc gọi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 bằng cách sử dụng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)40: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'3 Theo mặc định, việc cố gắng vá một hàm trong mô -đun (hoặc phương thức hoặc thuộc tính trong một lớp) không tồn tại sẽ thất bại với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'43: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'4 Nhưng thêm >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()28 trong cuộc gọi đến >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 sẽ làm cho ví dụ trước hoạt động như mong đợi: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'5 Đã thay đổi trong phiên bản 3.8: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 now returns an >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)51 if the target is an async function. Patch.Object¶Patch.Object (Target, Thuộc tính, new = default, spec = none, create = false, spec_set = none, autospec = none, new_callable = none,object(target, attribute, new=DEFAULT, spec=None, create=False, spec_set=None, autospec=None, new_callable=None, **kwargs)¶Bản vá thành viên được đặt tên (thuộc tính) trên một đối tượng (mục tiêu) với một đối tượng giả. >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()62 có thể được sử dụng như một người trang trí, trang trí lớp học hoặc người quản lý bối cảnh. Đối số Mới, Spec, Creat, Spec_set, Autospec và New_Callable có cùng ý nghĩa với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33. Giống như >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33, >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()62 lấy các đối số từ khóa tùy ý để định cấu hình đối tượng giả mà nó tạo ra. Khi được sử dụng làm người trang trí lớp >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()62 Danh dự >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()32 để chọn phương pháp nào để bọc. Bạn có thể gọi >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()62 với ba đối số hoặc hai đối số. Hình thức ba đối số lấy đối tượng được vá, tên thuộc tính và đối tượng để thay thế thuộc tính bằng. Khi gọi bằng hai biểu mẫu đối số, bạn bỏ qua đối tượng thay thế và một giả được tạo cho bạn và được chuyển vào như một đối số bổ sung cho chức năng được trang trí: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'6 Spec, Tạo và các đối số khác cho >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()62 có ý nghĩa tương tự như chúng cho >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33. Patch.dict¶Patch.dict (in_dict, value = (), rõ ràng = false, ** kwargs) ¶dict(in_dict, values=(), clear=False, **kwargs)¶Vá một từ điển, hoặc từ điển như đối tượng và khôi phục từ điển về trạng thái ban đầu của nó sau khi thử nghiệm. in_dict có thể là một từ điển hoặc ánh xạ như container. Nếu nó là một ánh xạ thì ít nhất nó phải hỗ trợ nhận, cài đặt và xóa các mục cộng với lặp lại các khóa. IN_DICT cũng có thể là một chuỗi chỉ định tên của từ điển, sau đó sẽ được tìm nạp bằng cách nhập nó. Các giá trị có thể là một từ điển của các giá trị để đặt trong từ điển. Các giá trị cũng có thể là một cặp có thể lặp lại của các cặp >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()71. Nếu rõ ràng là đúng thì từ điển sẽ được xóa trước khi các giá trị mới được đặt. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 cũng có thể được gọi với các đối số từ khóa tùy ý để đặt các giá trị trong từ điển. Đã thay đổi trong phiên bản 3.8: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 now returns the patched dictionary when used as a context manager. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 có thể được sử dụng như một người quản lý bối cảnh, người trang trí hoặc trang trí lớp học: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'7 Khi được sử dụng làm người trang trí lớp >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 Danh dự >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()32 (mặc định là >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()33) để chọn phương pháp nào để bọc: >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'8 Nếu bạn muốn sử dụng một tiền tố khác cho bài kiểm tra của mình, bạn có thể thông báo cho các bản vá của tiền tố khác nhau bằng cách đặt >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()32. Để biết thêm chi tiết về cách thay đổi giá trị của see test_prefix.TEST_PREFIX. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 có thể được sử dụng để thêm các thành viên vào từ điển, hoặc đơn giản là để một bài kiểm tra thay đổi từ điển và đảm bảo từ điển được khôi phục khi thử nghiệm kết thúc. >>> mock = Mock() >>> mock.__str__ = Mock(return_value='wheeeeee') >>> str(mock) 'wheeeeee'9 >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:0 Các từ khóa có thể được sử dụng trong cuộc gọi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 để đặt các giá trị trong từ điển: >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:1 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 có thể được sử dụng với từ điển như các đối tượng không thực sự từ điển. Ở mức tối thiểu, họ phải hỗ trợ mục nhận, cài đặt, xóa và kiểm tra thành viên hoặc lặp lại. Điều này tương ứng với các phương pháp ma thuật >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()82, >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()83, >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()84 và >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()85 hoặc >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()86. >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:2 Patch.Multiple¶Patch.multiple (Target, spec = none, created = false, spec_set = none, autospec = none, new_callable = none, ** kwargs) ¶multiple(target, spec=None, create=False, spec_set=None, autospec=None, new_callable=None, **kwargs)¶Thực hiện nhiều bản vá trong một cuộc gọi. Nó cần đối tượng được vá (dưới dạng đối tượng hoặc một chuỗi để tìm nạp đối tượng bằng cách nhập) và các đối số từ khóa cho các bản vá: >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:3 Sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'73 làm giá trị nếu bạn muốn >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()88 để tạo sự giả cho bạn. Trong trường hợp này, các giả tạo được chuyển vào một hàm được trang trí theo từ khóa và từ điển được trả về khi >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()88 được sử dụng làm trình quản lý ngữ cảnh. >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()88 có thể được sử dụng như một người trang trí, trang trí lớp học hoặc người quản lý bối cảnh. Các đối số Spec, spec_set, created, autospec và new_callable có ý nghĩa tương tự như đối với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33. Những đối số này sẽ được áp dụng cho tất cả các bản vá được thực hiện bởi >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()88. Khi được sử dụng làm người trang trí lớp >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()88 Danh dự >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()32 để chọn phương pháp nào để bọc. Nếu bạn muốn >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()88 để tạo sự chế giễu cho bạn, thì bạn có thể sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'73 làm giá trị. Nếu bạn sử dụng >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()88 như một người trang trí thì các giả tạo được chuyển vào chức năng được trang trí bằng từ khóa. >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:4 >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()88 có thể được lồng với các nhà trang trí >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()99 khác, nhưng đặt các đối số được truyền bởi từ khóa sau bất kỳ đối số tiêu chuẩn nào được tạo bởi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33: >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:5 Nếu >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()88 được sử dụng làm trình quản lý ngữ cảnh, giá trị được Trình quản lý ngữ cảnh trả về là một từ điển trong đó các chế độ giả được tạo ra bởi tên: >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:6 Phương pháp vá: Bắt đầu và dừng lạiTất cả các bản vá có các phương thức >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)02 và >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)03. Chúng làm cho nó đơn giản hơn để thực hiện bản vá trong các phương thức >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)04 hoặc nơi bạn muốn thực hiện nhiều bản vá mà không cần trang trí làm tổ hoặc với các tuyên bố. Để sử dụng chúng, hãy gọi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33, >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()62 hoặc >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 là bình thường và giữ một tham chiếu đến đối tượng >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)08 đã trả lại. Sau đó, bạn có thể gọi >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)02 để đặt bản vá vào vị trí và >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)03 để hoàn tác nó. Nếu bạn đang sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 để tạo một chế độ giả cho bạn thì nó sẽ được trả lại bằng cách gọi cho >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)12. >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:7 Một trường hợp sử dụng điển hình cho điều này có thể là để thực hiện nhiều bản vá trong phương thức >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)04 của >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()30: >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:8 Thận trọng Nếu bạn sử dụng kỹ thuật này, bạn phải đảm bảo rằng việc vá lỗi được hoàn tác bằng cách gọi >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)15. Điều này có thể khó khăn hơn bạn nghĩ, bởi vì nếu một ngoại lệ được nêu ra trong >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)04 thì >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)17 không được gọi. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)18 làm cho điều này dễ dàng hơn: >>> from unittest.mock import create_autospec >>> def function(a, b, c): ... pass ... >>> mock_function = create_autospec(function, return_value='fishy') >>> mock_function(1, 2, 3) 'fishy' >>> mock_function.assert_called_once_with(1, 2, 3) >>> mock_function('wrong arguments') Traceback (most recent call last): ... TypeError:9 Là một phần thưởng bổ sung, bạn không còn cần phải giữ một tham chiếu đến đối tượng >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)08. Cũng có thể dừng tất cả các bản vá đã được bắt đầu bằng cách sử dụng >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)20. patch.stopall () ¶stopall()¶ Dừng tất cả các bản vá hoạt động. Chỉ dừng các bản vá bắt đầu với >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)21. Bản vá tích hợpBạn có thể vá bất kỳ tích hợp nào trong một mô -đun. Các bản vá ví dụ sau đây được xây dựng >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)22: >>> mock = Mock() >>> mock.method()0 Test_prefix¶Tất cả các bản vá có thể được sử dụng làm người trang trí lớp. Khi được sử dụng theo cách này, chúng bao bọc mọi phương pháp kiểm tra trên lớp. Các bản vá nhận ra các phương pháp bắt đầu bằng >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()33 là phương pháp thử nghiệm. Đây là cách tương tự mà >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)24 tìm thấy các phương thức kiểm tra theo mặc định. Có thể bạn muốn sử dụng một tiền tố khác cho các bài kiểm tra của mình. Bạn có thể thông báo cho các bản vá của tiền tố khác nhau bằng cách đặt >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()32: >>> mock = Mock() >>> mock.method()1 Người trang trí bản vá làm tổNếu bạn muốn thực hiện nhiều bản vá thì bạn chỉ có thể xếp các nhà trang trí. Bạn có thể xếp chồng lên nhiều bộ trang trí bản vá bằng cách sử dụng mẫu này: >>> mock = Mock() >>> mock.method()2 Lưu ý rằng các nhà trang trí được áp dụng từ phía dưới lên trên. Đây là cách tiêu chuẩn mà Python áp dụng các nhà trang trí. Thứ tự của các giả tạo được truyền vào chức năng thử nghiệm của bạn phù hợp với thứ tự này. Bản vá lỗi ở đâu>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 hoạt động bằng cách (tạm thời) thay đổi đối tượng mà một tên trỏ đến với một đối tượng khác. Có thể có nhiều tên chỉ vào bất kỳ đối tượng riêng lẻ nào, vì vậy để vá để hoạt động, bạn phải đảm bảo rằng bạn vá tên được sử dụng bởi hệ thống đang được kiểm tra. Nguyên tắc cơ bản là bạn vá trong đó một đối tượng được nhìn lên, điều này không nhất thiết là cùng một nơi như nơi nó được xác định. Một vài ví dụ sẽ giúp làm rõ điều này. Hãy tưởng tượng chúng tôi có một dự án mà chúng tôi muốn kiểm tra với cấu trúc sau: >>> mock = Mock() >>> mock.method()3 Bây giờ chúng tôi muốn kiểm tra >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)27 nhưng chúng tôi muốn chế giễu >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)28 bằng cách sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33. Vấn đề là khi chúng tôi nhập mô -đun B, mà chúng tôi sẽ phải làm thì nó nhập >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)28 từ mô -đun a. Nếu chúng tôi sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 để chế giễu >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)32 thì nó sẽ không có tác dụng đối với bài kiểm tra của chúng tôi; Mô -đun B đã có một tham chiếu đến >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)28 thực và có vẻ như việc vá lỗi của chúng tôi không có tác dụng. Điều quan trọng là vá >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)28 nơi nó được sử dụng (hoặc nơi nó được tra cứu). Trong trường hợp này >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)27 thực sự sẽ tra cứu >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)28 trong mô -đun B, nơi chúng tôi đã nhập nó. Việc vá lỗi trông giống như: Tuy nhiên, hãy xem xét kịch bản thay thế trong đó thay vì mô -đun ____437 B không >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)38 và >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)27 sử dụng >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)32. Cả hai hình thức nhập khẩu này là phổ biến. Trong trường hợp này, lớp chúng tôi muốn bản vá đang được tra cứu trong mô -đun và vì vậy chúng tôi phải vá >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)32 thay thế: thay vào đó: Bản vá mô tả và đối tượng proxyCả bản vá và bản vá. Bạn nên vá những thứ này trên lớp chứ không phải là một ví dụ. Chúng cũng hoạt động với một số đối tượng mà quyền truy cập thuộc tính proxy, như đối tượng Cài đặt Django. Phương pháp ma thuật và phương pháp ma thuật hỗ trợ BurPhương pháp ma thuật chế giễu>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 hỗ trợ chế giễu các phương pháp giao thức Python, còn được gọi là Phương pháp ma thuật. Điều này cho phép các đối tượng giả thay thế các container hoặc các đối tượng khác thực hiện các giao thức Python. Bởi vì các phương pháp ma thuật được tra cứu khác với các phương pháp bình thường 2, hỗ trợ này đã được thực hiện đặc biệt. Điều này có nghĩa là chỉ các phương pháp ma thuật cụ thể được hỗ trợ. Danh sách được hỗ trợ bao gồm hầu hết tất cả chúng. Nếu có bất kỳ thiếu mà bạn cần, xin vui lòng cho chúng tôi biết. Bạn chế giễu các phương thức ma thuật bằng cách đặt phương thức bạn quan tâm đến một hàm hoặc một thể hiện giả. Nếu bạn đang sử dụng một chức năng thì nó phải lấy >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)43 làm đối số đầu tiên 3. >>> mock = Mock() >>> mock.method()4 >>> mock = Mock() >>> mock.method()5 >>> mock = Mock() >>> mock.method()6 Một trường hợp sử dụng cho điều này là cho các đối tượng chế giễu được sử dụng làm Trình quản lý ngữ cảnh trong tuyên bố >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)44: >>> mock = Mock() >>> mock.method()7 Các cuộc gọi đến các phương thức ma thuật không xuất hiện trong >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'91, nhưng chúng được ghi lại trong >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84. Ghi chú Nếu bạn sử dụng đối số từ khóa Spec để tạo một chế độ giả thì cố gắng đặt một phương thức ma thuật không phải là trong thông số kỹ thuật sẽ tăng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'43. Danh sách đầy đủ các phương pháp ma thuật được hỗ trợ là:
Đã thay đổi trong phiên bản 3.8: Đã thêm hỗ trợ cho >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)75, >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)76, >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original08 and >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original09. Các phương pháp sau đây tồn tại nhưng không được hỗ trợ vì chúng được sử dụng bởi Mock, có thể được đặt một cách linh hoạt hoặc có thể gây ra vấn đề:
Ma thuật giảCó hai biến thể >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'59. classunittest.mock.magicmock (*args, ** kw) ¶ unittest.mock.MagicMock(*args, **kw)¶ >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 là một lớp con của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 với việc triển khai mặc định của hầu hết các phương thức ma thuật. Bạn có thể sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 mà không cần phải tự cấu hình các phương thức ma thuật. Các tham số hàm tạo có cùng ý nghĩa với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32. Nếu bạn sử dụng các đối số spec hoặc spec_set thì chỉ các phương thức ma thuật tồn tại trong thông số kỹ thuật sẽ được tạo. classunittest.mock.noncallablemagicmock (*args, ** kw) ¶unittest.mock.NonCallableMagicMock(*args, **kw)¶Một phiên bản không thể gọi của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36. Các tham số của hàm tạo có cùng ý nghĩa với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36, ngoại trừ return_value và side_effect không có ý nghĩa trên một giả không thể gọi được. Các phương thức ma thuật được thiết lập với các đối tượng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36, vì vậy bạn có thể định cấu hình chúng và sử dụng chúng theo cách thông thường: >>> mock = Mock() >>> mock.method()8 Theo mặc định, nhiều phương thức giao thức được yêu cầu trả về các đối tượng thuộc loại cụ thể. Các phương thức này được cấu hình sẵn với giá trị trả về mặc định, do đó chúng có thể được sử dụng mà không cần bạn phải làm bất cứ điều gì nếu bạn không quan tâm đến giá trị trả về. Bạn vẫn có thể đặt giá trị trả về theo cách thủ công nếu bạn muốn thay đổi mặc định. Phương pháp và mặc định của chúng:
Ví dụ: >>> mock = Mock() >>> mock.method()9 Hai phương pháp bình đẳng, >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original63 và >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original64, là đặc biệt. Họ thực hiện so sánh bình đẳng mặc định trên danh tính, sử dụng thuộc tính >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42, trừ khi bạn thay đổi giá trị trả về của chúng để trả về một cái gì đó khác: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'00 Giá trị trả về của >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original66 có thể là bất kỳ đối tượng nào có thể đi được và isn yêu cầu phải là người lặp: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'01 Nếu giá trị trả về là một trình lặp, thì việc lặp lại nó một lần sẽ tiêu thụ nó và các lần lặp tiếp theo sẽ dẫn đến một danh sách trống: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'02 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 có tất cả các phương pháp ma thuật được hỗ trợ được cấu hình ngoại trừ một số phương pháp tối nghĩa và lỗi thời. Bạn vẫn có thể thiết lập những thứ này nếu bạn muốn. Các phương thức ma thuật được hỗ trợ nhưng không được thiết lập theo mặc định trong >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 là:
Phương pháp ma thuật nên được tra cứu trên lớp chứ không phải là ví dụ. Các phiên bản khác nhau của Python không nhất quán về việc áp dụng quy tắc này. Các phương pháp giao thức được hỗ trợ nên hoạt động với tất cả các phiên bản được hỗ trợ của Python. 3Hàm về cơ bản được nối với lớp, nhưng mỗi trường hợp >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 được giữ cách ly với các trường hợp khác. Người trợ giúp trongSentinel¶Unittest.mock.sentinel¶sentinel¶Đối tượng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'34 cung cấp một cách thuận tiện để cung cấp các đối tượng độc đáo cho các thử nghiệm của bạn. Các thuộc tính được tạo theo yêu cầu khi bạn truy cập chúng theo tên. Truy cập cùng một thuộc tính sẽ luôn trả về cùng một đối tượng. Các đối tượng được trả về có một repred hợp lý để các thông báo thất bại kiểm tra có thể đọc được. Đã thay đổi trong phiên bản 3.7: Các thuộc tính >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'34 attributes now preserve their identity when they are >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original87 or >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original88. Đôi khi khi kiểm tra, bạn cần kiểm tra xem một đối tượng cụ thể được truyền như một đối số cho một phương thức khác hoặc được trả về. Nó có thể là phổ biến để tạo các đối tượng Sentinel được đặt tên để kiểm tra điều này. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'34 cung cấp một cách thuận tiện để tạo và kiểm tra danh tính của các đối tượng như thế này. Trong ví dụ này, chúng tôi, khỉ monkey >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original90 để trả về >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original91: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'03 MẶC ĐỊNH¶Unittest.mock.default¶DEFAULT¶Đối tượng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'73 là một sentinel được tạo sẵn (thực ra là >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original93). Nó có thể được sử dụng bởi các hàm >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'42 để chỉ ra rằng giá trị trả về bình thường nên được sử dụng. cuộc gọi¶unittest.mock.call (*args, ** kwargs) ¶call(*args, **kwargs)¶>>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original95 là một đối tượng trợ giúp để đưa ra các xác nhận đơn giản hơn, để so sánh với >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)09, >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)10, >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'91. >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original95 cũng có thể được sử dụng với >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)43. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'04 call.call_list ()call_list()¶ Đối với một đối tượng cuộc gọi đại diện cho nhiều cuộc gọi, >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()02 trả về danh sách tất cả các cuộc gọi trung gian cũng như cuộc gọi cuối cùng. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()03 đặc biệt hữu ích để đưa ra các khẳng định trên các cuộc gọi chuỗi xích. Một cuộc gọi có chuỗi là nhiều cuộc gọi trên một dòng mã. Điều này dẫn đến nhiều mục trong >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84 trên một giả. Xây dựng thủ công chuỗi các cuộc gọi có thể tẻ nhạt. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()02 có thể xây dựng chuỗi các cuộc gọi từ cùng một cuộc gọi chuỗi: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'05 Một đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)13 là một tuple của (args vị trí, từ khóa args) hoặc (tên, args vị trí, từ khóa args) tùy thuộc vào cách nó được xây dựng. Khi bạn tự xây dựng, điều này, điều này đặc biệt thú vị, nhưng các đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)13 có trong các thuộc tính >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)81, >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()09 và >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()10 có thể được hướng vào để có được các đối số riêng lẻ mà chúng chứa. Các đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)13 trong >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)81 và >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()09 là hai phần của (args vị trí, từ khóa args) trong khi các đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)13 trong >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()10, cùng với các đối tượng bạn tự xây dựng, là ba bản (tên, tranh luận về vị trí, từ khóa). Bạn có thể sử dụng Tuplity của họ, để rút ra các đối số riêng lẻ để tìm hiểu và khẳng định phức tạp hơn. Các đối số vị trí là một tuple (một tuple trống nếu không có đối số vị trí) và các đối số từ khóa là một từ điển: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'06 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'07 created_autospec¶unittest.mock.create_autospec (spec_set = false, instance = false, ** kwargs) ¶create_autospec(spec, spec_set=False, instance=False, **kwargs)¶Tạo một đối tượng giả bằng cách sử dụng một đối tượng khác như một thông số kỹ thuật. Các thuộc tính trên giả sẽ sử dụng thuộc tính tương ứng trên đối tượng Spec làm thông số kỹ thuật của chúng. Các chức năng hoặc phương pháp bị chế giễu sẽ kiểm tra đối số của chúng để đảm bảo rằng chúng được gọi với chữ ký chính xác. Nếu spec_set là >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'89 thì cố gắng đặt các thuộc tính mà don lồng tồn tại trên đối tượng Spec sẽ tăng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'43. Nếu một lớp được sử dụng làm thông số kỹ thuật thì giá trị trả về của giả (thể hiện của lớp) sẽ có cùng một thông số kỹ thuật. Bạn có thể sử dụng một lớp làm thông số kỹ thuật cho một đối tượng thể hiện bằng cách truyền >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()18. Mock được trả lại sẽ chỉ có thể gọi được nếu các trường hợp của giả có thể gọi được. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'51 cũng lấy các đối số từ khóa tùy ý được truyền cho hàm tạo của chế tạo được tạo. Xem Autospeccing để biết các ví dụ về cách sử dụng Auto-Speccing với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'51 và đối số Autospec thành >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33.Autospeccing for examples of how to use auto-speccing with >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'51 and the autospec argument to >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33. KHÔNG TÍ NÀO¶Unittest.mock.Man¶ANY¶Đôi khi bạn có thể cần đưa ra các khẳng định về một số đối số trong một cuộc gọi để chế giễu, nhưng không quan tâm đến một số đối số hoặc muốn rút chúng ra khỏi >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)09 và đưa ra những khẳng định phức tạp hơn về chúng. Để bỏ qua một số đối số nhất định, bạn có thể truyền trong các đối tượng so sánh bằng mọi thứ. Các cuộc gọi đến >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'81 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'82 sau đó sẽ thành công bất kể điều gì đã được thông qua. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'08 >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()25 cũng có thể được sử dụng để so sánh với các danh sách cuộc gọi như >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'84: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'09 Filter_Dir¶Unittest.mock.filter_dir¶FILTER_DIR¶>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'96 là một biến cấp mô -đun kiểm soát cách các đối tượng giả phản ứng với >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()28. Mặc định là >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'89, sử dụng bộ lọc được mô tả dưới đây, chỉ hiển thị các thành viên hữu ích. Nếu bạn không thích bộ lọc này hoặc cần tắt nó cho mục đích chẩn đoán, thì hãy đặt >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()30. Với việc lọc, >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'95 chỉ hiển thị các thuộc tính hữu ích và sẽ bao gồm bất kỳ thuộc tính được tạo động nào mà thường được hiển thị. Nếu tất nhiên là giả được tạo bằng một thông số kỹ thuật (hoặc autospec) thì tất cả các thuộc tính từ bản gốc đều được hiển thị, ngay cả khi chúng chưa được truy cập: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'10 Nhiều trong số những người không có ích (riêng tư đến >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 chứ không phải là thứ bị chế giễu) nhấn mạnh và các thuộc tính tiền tố được nhấn mạnh gấp đôi đã được lọc từ kết quả của việc gọi >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()28 trên >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32. Nếu bạn không thích hành vi này, bạn có thể tắt nó bằng cách đặt công tắc cấp mô -đun >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'96: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'11 Ngoài ra, bạn chỉ có thể sử dụng >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()36 (thành viên ví dụ) và >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()37 (thành viên loại) để bỏ qua việc lọc không phân biệt >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()38. Mock_open¶unittest.mock.mock_open (mock = none, read_data = none) ¶mock_open(mock=None, read_data=None)¶Một hàm trợ giúp để tạo một chế độ giả để thay thế việc sử dụng >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()39. Nó hoạt động cho >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()39 được gọi là trực tiếp hoặc được sử dụng làm trình quản lý ngữ cảnh. Đối số giả là đối tượng giả cấu hình. Nếu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74 (mặc định) thì >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 sẽ được tạo cho bạn, với API giới hạn trong các phương thức hoặc thuộc tính có sẵn trên tay cầm tệp tiêu chuẩn. read_data là một chuỗi cho các phương thức >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()43, >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()44 và >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()45 của xử lý tệp để trả về. Các cuộc gọi đến các phương thức đó sẽ lấy dữ liệu từ read_data cho đến khi nó bị cạn kiệt. Việc giả của các phương thức này khá đơn giản: mỗi khi giả được gọi, read_data sẽ được khởi động lại. Nếu bạn cần kiểm soát nhiều hơn đối với dữ liệu mà bạn đang cung cấp cho mã đã được kiểm tra, bạn sẽ cần phải tự mình tùy chỉnh điều này. Khi đó là không đủ, một trong những gói hệ thống tập tin trong bộ nhớ trên PYPI có thể cung cấp một hệ thống tập tin thực tế để thử nghiệm. Đã thay đổi trong phiên bản 3.4: Đã thêm hỗ trợ >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()44 and >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()45 support. The mock of >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()43 changed to consume read_data rather than returning it on each call. Đã thay đổi trong phiên bản 3.5: read_data hiện được đặt lại trên mỗi cuộc gọi đến giả.read_data is now reset on each call to the mock. Đã thay đổi trong phiên bản 3.8: Đã thêm >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()85 to implementation so that iteration (such as in for loops) correctly consumes read_data. Sử dụng >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()39 làm trình quản lý bối cảnh là một cách tuyệt vời để đảm bảo xử lý tệp của bạn được đóng đúng và đang trở nên phổ biến: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'12 Vấn đề là ngay cả khi bạn chế giễu cuộc gọi đến >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()39, đó là đối tượng được trả về được sử dụng làm trình quản lý bối cảnh (và có >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()52 và >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()53 được gọi). Các nhà quản lý bối cảnh chế giễu với >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'36 là đủ phổ biến và đủ khó khăn để hàm trợ giúp là hữu ích. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'13 Và để đọc các tập tin: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'14 Tự động phátTự động hóa dựa trên tính năng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)27 hiện có của Mock. Nó giới hạn API của các chế giễu đối với API của một đối tượng gốc (thông số kỹ thuật), nhưng nó là đệ quy (được triển khai một cách uể oải) để các thuộc tính của giả chỉ có API giống như các thuộc tính của thông số kỹ thuật. Ngoài ra, các hàm / phương thức bị chế giễu có chữ ký cuộc gọi tương tự như bản gốc để chúng tăng >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()23 nếu chúng được gọi là không chính xác. Trước khi tôi giải thích cách thức hoạt động của Auto-Speccing, ở đây, tại sao nó cần thiết. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 là một đối tượng rất mạnh mẽ và linh hoạt, nhưng nó bị hai sai sót khi được sử dụng để chế giễu các đối tượng từ một hệ thống được thử nghiệm. Một trong những sai sót này là cụ thể cho API >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 và cái còn lại là một vấn đề chung hơn với việc sử dụng các đối tượng giả. Đầu tiên là vấn đề cụ thể cho >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 có hai phương pháp khẳng định cực kỳ tiện dụng: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'81 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'82. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'15 Bởi vì chế giễu các thuộc tính tạo tự động theo yêu cầu và cho phép bạn gọi chúng bằng các đối số tùy ý, nếu bạn viết sai một trong những phương thức khẳng định này thì khẳng định của bạn đã biến mất: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'16 Các bài kiểm tra của bạn có thể vượt qua âm thầm và không chính xác vì lỗi đánh máy. Vấn đề thứ hai là tổng quát hơn để chế giễu. Nếu bạn tái cấu trúc một số mã của mình, đổi tên thành viên, v.v., bất kỳ kiểm tra nào cho mã vẫn đang sử dụng API cũ nhưng sử dụng giả thay vì các đối tượng thực vẫn sẽ vượt qua. Điều này có nghĩa là tất cả các bài kiểm tra của bạn có thể vượt qua mặc dù mã của bạn bị hỏng. Lưu ý rằng đây là một lý do khác tại sao bạn cần kiểm tra tích hợp cũng như các bài kiểm tra đơn vị. Kiểm tra mọi thứ trong sự cô lập đều ổn và bảnh bao, nhưng nếu bạn không kiểm tra cách các đơn vị của bạn có dây với nhau thì vẫn còn rất nhiều chỗ cho các lỗi mà các bài kiểm tra có thể đã bắt được. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()63 đã cung cấp một tính năng để giúp điều này, được gọi là Speccing. Nếu bạn sử dụng một lớp hoặc phiên bản làm >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)27 cho một chế độ giả thì bạn chỉ có thể truy cập các thuộc tính trên chế độ giả tồn tại trên lớp thực: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'17 Thông số kỹ thuật chỉ áp dụng cho chính giả, vì vậy chúng tôi vẫn có cùng một vấn đề với bất kỳ phương thức nào trên Mock: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'18 Tự động giải quyết vấn đề này. Bạn có thể chuyển >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()22 đến >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 / >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()62 hoặc sử dụng hàm >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'51 để tạo một chế độ giả bằng một thông số kỹ thuật. Nếu bạn sử dụng đối số >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()22 cho >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 thì đối tượng đang được thay thế sẽ được sử dụng làm đối tượng Spec. Bởi vì Speccing được thực hiện, một cách lười biếng (thông số kỹ thuật được tạo dưới dạng các thuộc tính trên giả được truy cập), bạn có thể sử dụng nó với các đối tượng rất phức tạp hoặc được lồng sâu (như các mô -đun nhập các mô -đun nhập mô -đun) mà không có hiệu suất lớn. Ở đây, một ví dụ về nó được sử dụng: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'19 Bạn có thể thấy rằng >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()71 có một thông số kỹ thuật. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()71 có hai đối số trong hàm tạo (một trong số đó là bản thân). Đây là những gì xảy ra nếu chúng ta cố gắng gọi nó không chính xác: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'20 Thông số kỹ thuật cũng áp dụng cho các lớp khởi tạo (nghĩa là giá trị trả về của giả đặc biệt): >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'21 Các đối tượng >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()73 không thể gọi được, vì vậy giá trị trả lại của việc khởi tạo chúng ta bị chế giễu >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()71 là một giả không thể gọi được. Với thông số kỹ thuật, bất kỳ lỗi chính tả nào trong các khẳng định của chúng tôi sẽ tăng lỗi chính xác: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'22 Trong nhiều trường hợp, bạn sẽ có thể thêm >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()22 vào các cuộc gọi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 hiện tại của bạn và sau đó được bảo vệ chống lại các lỗi do lỗi chính tả và thay đổi API. Cũng như sử dụng autospec thông qua >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33, có một >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'51 để tạo trực tiếp các chế giễu tự động: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'23 Tuy nhiên, đây không phải là những lời cảnh báo và hạn chế, đó là lý do tại sao nó không phải là hành vi mặc định. Để biết những thuộc tính nào có sẵn trên đối tượng Spec, Autospec phải hướng nội (thuộc tính truy cập) thông số kỹ thuật. Khi bạn đi qua các thuộc tính trên giả, một đường truyền tương ứng của đối tượng ban đầu đang xảy ra dưới mui xe. Nếu bất kỳ đối tượng cụ thể nào của bạn có thuộc tính hoặc mô tả có thể kích hoạt thực thi mã thì bạn có thể không sử dụng Autospec. Mặt khác, tốt hơn là thiết kế các đối tượng của bạn để hướng nội là an toàn 4. Một vấn đề nghiêm trọng hơn là các thuộc tính thường được tạo ra trong phương thức >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()79 và không tồn tại trên lớp. Autospec có thể biết về bất kỳ thuộc tính được tạo động nào và hạn chế API thành các thuộc tính có thể nhìn thấy. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'24 Có một vài cách khác nhau để giải quyết vấn đề này. Cách dễ nhất, nhưng không nhất thiết là cách ít khó chịu nhất, chỉ đơn giản là đặt các thuộc tính cần thiết trên giả sau khi tạo. Chỉ vì autospec không cho phép bạn tìm nạp các thuộc tính mà don lồng tồn tại trên thông số kỹ thuật, nó không ngăn cản bạn thiết lập chúng: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'25 Có một phiên bản tích cực hơn của cả spec và autospec không ngăn cản bạn thiết lập các thuộc tính không tồn tại. Điều này rất hữu ích nếu bạn muốn đảm bảo mã của mình chỉ đặt các thuộc tính hợp lệ, nhưng rõ ràng nó ngăn chặn kịch bản cụ thể này: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'26 Có lẽ cách tốt nhất để giải quyết vấn đề là thêm các thuộc tính lớp làm giá trị mặc định cho các thành viên được khởi tạo trong >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()79. Lưu ý rằng nếu bạn chỉ thiết lập các thuộc tính mặc định trong >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()79 thì việc cung cấp chúng thông qua các thuộc tính lớp (được chia sẻ giữa các trường hợp tất nhiên) cũng nhanh hơn. ví dụ. Điều này mang lại một vấn đề khác. Việc cung cấp giá trị mặc định là >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74 là tương đối phổ biến cho các thành viên sau này sẽ là một đối tượng của một loại khác. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74 sẽ vô dụng như một thông số kỹ thuật vì nó sẽ cho phép bạn truy cập bất kỳ thuộc tính hoặc phương thức nào trên đó. Vì >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74 sẽ không bao giờ hữu ích như một thông số kỹ thuật và có lẽ chỉ ra một thành viên thường sẽ thuộc một số loại khác, Autospec không sử dụng một thông số kỹ thuật cho các thành viên được đặt thành >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'74. Đây sẽ chỉ là những giả thông thường (tốt - MagicMocks): >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'27 Nếu việc sửa đổi các lớp sản xuất của bạn để thêm mặc định là theo ý thích của bạn thì có nhiều tùy chọn hơn. Một trong số này chỉ đơn giản là sử dụng một thể hiện làm thông số kỹ thuật chứ không phải lớp. Cái khác là tạo một lớp con của lớp sản xuất và thêm mặc định vào lớp con mà không ảnh hưởng đến lớp sản xuất. Cả hai đều yêu cầu bạn sử dụng một đối tượng thay thế làm thông số kỹ thuật. Rất may >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 hỗ trợ điều này - bạn có thể chỉ cần chuyển đối tượng thay thế như đối số Autospec: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'284 Điều này chỉ áp dụng cho các lớp hoặc các đối tượng đã khởi tạo. Gọi một lớp bị chế giễu để tạo một thể hiện giả không tạo ra một ví dụ thực. Đó chỉ là tra cứu thuộc tính - cùng với các cuộc gọi đến >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()28 - được thực hiện. Niêm phong Mocks¶Unittest.mock.Seal (Mock) ¶seal(mock)¶Con dấu sẽ vô hiệu hóa việc tạo tự động giả khi truy cập một thuộc tính của giả được niêm phong hoặc bất kỳ thuộc tính nào của nó đã bị chế giễu một cách đệ quy. Nếu một thể hiện giả với một tên hoặc một thông số kỹ thuật được gán cho một thuộc tính, nó đã giành được được xem xét trong chuỗi niêm phong. Điều này cho phép một người ngăn chặn con dấu sửa một phần của đối tượng giả. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'29 Mới trong phiên bản 3.7. |
