Hướng dẫn python unit test return value - giá trị trả về kiểm tra đơn vị python
Trên đây là lớp học của tôi! Với một phương thức thêm đơn giản. Show
Về cơ bản, những gì tôi đang cố gắng làm là, chuẩn bị cho các thuật toán và cấu trúc dữ liệu/phỏng vấn lập trình, trong đó tôi tạo phiên bản cho từng đầu vào và muốn viết các bài kiểm tra đơn vị cho các trường hợp .. Đây là những gì tôi đã thử dưới đây:
Không chắc chắn làm thế nào để thực hiện việc này, nếu tôi chạy mã trên, tôi nhận được thông báo lỗi này:
Tôi muốn có thể kiểm tra các giá trị trả về của một phương thức thể hiện của lớp 33, trong trường hợp này 34 Mới trong phiên bản 3.3. Mã nguồn: lib/unittest/mock.py Lib/unittest/mock.py 35 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. 35 cung cấp lớp lõi 37 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í 38 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 39 để 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 37, 41 và 38.Mock được thiết kế để sử dụng với 43 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à 35 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¶Các đối tượng 37 và 41 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') 47 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 48.Bộ trang trí / Trình quản lý bối cảnh 38 giúp bạn 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 50 được thông qua đầu tiên.Với 38, 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í 38 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ó 53 để 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 41. 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 41 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 41 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: 0Để đả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 56. 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 56 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: 1 56 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 58 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 59.Lớp giả 37 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. 41 là một lớp con của 37 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: 63 và 64Các nhà trang trí 38 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 37. Theo mặc định 38 sẽ tạo 41 cho bạn. Bạn có thể chỉ định một lớp thay thế 37 bằng cách sử dụng đối số new_callable thành 38. 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 37 mới. 37 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 85 để biết chi tiết. assert_called () ¶()¶Khẳng định rằng giả được gọi ít nhất một lần. 2Mớ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. 3Mớ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. 4 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ể: 5
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) ¶ 6 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ư 86 và 87 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 87, đó 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 89 được kiểm tra các cuộc gọi. 7 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 89. 8Mớ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à 79 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 48).(*, 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ề. 9Tê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 85 để biết chi tiết.assert_called () ¶ Khẳng định rằng giả được gọi ít nhất một lần. Mới trong phiên bản 3.6.(spec, spec_set=False)¶assert_called_once () ¶ Khẳng định rằng giả được gọi là chính xác một lần. assert_called_with (*args, ** kwargs) ¶(mock, attribute)¶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ể: assert_called_once_with (*args, ** kwargs) ¶(**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) ¶ 0khẳng định giả đã được gọi với các đối số được chỉ định. 1Assert vượt qua nếu giả đã được gọi, không giống như 86 và 87 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 87, đó 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 89 được kiểm tra các cuộc gọi.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 89.(**kw)¶assert_not_called () ¶ Đố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à: 2
Call_Count¶¶Một số nguyên cho bạn biết bao nhiêu lần đối tượng giả đã được gọi: 3
return_value¶¶Đặt cái này để định cấu hình giá trị được trả về bằng cách gọi Mock: 4Giá 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: 5 80 cũng có thể được đặt trong hàm tạo: 6 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ề 78 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ề 78 thì Mock sẽ trả về giá trị bình thường của nó (từ 80).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ý 78 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): 7Sử dụng 47 để trả về một chuỗi các giá trị: 8Sử dụng một cuộc gọi có thể gọi được: 9 47 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ó:>>> 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')0 Cài đặt 47 thành 79 Xóa nó:>>> 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')1 Call_args¶¶ Đây là 79 (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 12, bất kỳ đối số được đặt hàng nào mà giả đượ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 13, là bất kỳ đối số từ khóa nào (hoặc từ điển trố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')2 14, cùng với các thành viên của danh sách 15, 96 và 89 là các đối tượng 18. Đâ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 12 and 13 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 18 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 15.>>> 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')3 Các thành viên của 15 là đối tượng 18. Đâ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 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')4 Các thành viên của 96 là đối tượng 18. Đâ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_calls¶¶ 89 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 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')5 Các thành viên của 89 là đối tượng 18. Đâ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 89 đượ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 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')6 __lớp__¶¶ Thông thường thuộc tính 74 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 32, 74 trả về lớp Spec. Điều này cho phép các đối tượng giả vượt qua các bài kiểm tra 75 cho đối tượng họ đang thay thế / giả mạo như:>>> 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')7 74 có thể được gán, điều này cho phép một chế độ giả vượt qua kiểm tra 75 mà không buộc bạn sử dụng thông số kỹ thuật:>>> 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')8 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 37. Các tham số của hàm tạo có cùng ý nghĩa của 37, 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 32 hoặc 40 có thể vượt qua các bài kiểm tra 75:>>> 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')9 Các lớp 37 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í 38 đều có các đối số từ khóa tùy ý cho cấu hình. Đối với các nhà trang trí 38, 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ả:>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'0 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 45: 1Mộ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: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'2 Điều này áp dụng cho 86, 87, 48 và 49. 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. 50 cung cấp các phương thức 51 và 52 để bạn có thể chỉ định giá trị trả về khi nó được tìm nạp.Tìm nạp một thể hiện 50 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.>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'3 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 50 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ả:>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'4 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 41. Đối tượng 56 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.>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'5 Kết quả của 57 là một hàm async sẽ có kết quả của 47 hoặc 80 sau khi nó đã được chờ đợi:
Đặt thông số kỹ thuật của 37 hoặc 41 thành hàm async sẽ dẫn đến một đối tượng coroutine được trả về sau khi gọi.>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'6 Đặt thông số của 37, 41 hoặc 56 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à 41 . Tất cả các chức năng không đồng bộ sẽ là 56.>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'7 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 78 phải được sử dụng:>>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'8 assert_awaited_once () ¶()¶ Khẳng định rằng giả đã được chờ đợi chính xác một lần. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'9 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. >>> 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 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. >>> 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 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. >>> 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 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 79 đượ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 79.>>> 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 assert_not_awaited () ¶()¶ Khẳng định rằng giả không bao giờ được chờ đợ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)4 reset_mock (*args, ** kwargs) ¶(*args, **kwargs)¶ Xem 81. Cũng đặt 82 thành 0, 83 thành không có và xóa 79. Await_Count¶¶Một số nguyên theo dõi số lần đối tượng giả đã được chờ đợ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)5 Await_args¶¶ Đây là 79 (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ư 86.>>> 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 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. >>> 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 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 80. 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ư 14 và 15.Nếu 47 được đặt thì nó sẽ được gọi sau khi cuộc gọi đã được ghi lại, vì vậy nếu 47 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 47 thành một lớp hoặc thể hiện ngoại 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)8 Nếu 47 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 47 đượ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:>>> 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 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 95 từ bên trong 47 hoặc trả về 78:>>> 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 Để xóa 47 và quay lại hành vi mặc định, hãy đặt 47 thành 79:>>> 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 47 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à một >>> 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')02 được nâng lê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()2 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: >>> 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 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 >>> 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')03 cho cuộc gọi >>> 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')04 hoặc tăng 48 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 32 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 48.>>> 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 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 37, 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 85:>>> 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 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ả: >>> 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 Đí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 cho trẻ được ghi lại trong các thuộc tính 96 và 89 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ả:>>> 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 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. >>> 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()8 Mocks được tạo cho bạn bởi 38 tự động được đặt tên. Để đí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 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')13: >>> 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()91 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 48. Đ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)¶ 38 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 56 nếu đối tượng được vá là hàm async hoặc 41 khác. Nếu 38 đượ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 38 đượ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 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')20. 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 38. 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 41 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 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')23 hoặc >>> 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')24, đ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 56 được sử dụng cho các hàm Async và 41 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 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')27 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 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')28 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 chức năng 56 và tự động.Autospeccing.Thay vì >>> 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')27, bạn có thể vượt qua >>> 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')31 để 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 38 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 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')33 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ú Đã thay đổi trong phiên bản 3.5: Nếu bạn đang vá lỗi tích hợp trong một mô -đun thì bạn không cần phải vượt qua >>> 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')33, it will be added by default. Bản vá có thể được sử dụng như một công cụ trang trí lớp >>> 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')35. Nó hoạt động bằng cách trang trí từng phương pháp kiểm tra trong lớp. Điều này làm giảm mã Boilerplate khi các phương pháp thử nghiệm của bạn chia sẻ một tập hợp các bản vá chung. 38 Tìm các bài kiểm tra bằng cách tìm kiếm tên phương thức bắt đầu bằ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')37. Theo mặc định, đây là >>> 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')38, phù hợp với cách 43 tìm các bài kiểm tra. Bạn có thể chỉ định một tiền tố thay thế bằng cách đặt >>> 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')37. Bản vá có thể được sử dụng như một trình quản lý bối cảnh, với câu lệnh với câu lệnh. Ở đây, việc vá lỗi áp dụng cho khối thụt vào sau tuyên bố. Nếu bạn sử dụng trên mạng As, thì đối tượng được vá sẽ được liên kết với tên sau khi As As As; Rất hữu ích nếu 38 đang tạo một đối tượng giả cho bạn. 38 lấy các đối số từ khóa tùy ý. Chúng sẽ được truyền đến 56 nếu đối tượng được vá không đồng bộ, đến 41 nếu không hoặc đến new_callable nếu được chỉ định.>>> 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')45, >>> 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')46 và >>> 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')47 có sẵn cho các trường hợp sử dụng thay thế. 38 là người trang trí chức năng, tạo ra sự giả cho bạn và chuyển nó vào chức năng được trang trí:>>> 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 Việc vá một lớp thay thế lớp bằng một thể hiện 41. Nếu lớp được khởi tạo trong mã được kiểm tra thì đó sẽ là 80 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 47 để 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 80. Ví dụ:>>> 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 Nếu bạn sử dụng spec hoặc spec_set và 38 đ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.>>> 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 Đố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 41 cho giả tạo. Ví dụ: nếu bạn muốn sử dụng 63:>>> 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 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 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')56: >>> 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 Khi 38 đ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:>>> 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 Cũng như các thuộc tính trên các thuộc tính giả tạo, như 80 và 47, 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 38 bằng cách sử dụng 45:>>> 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 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 48:>>> 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 Nhưng thêm >>> 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')33 trong cuộc gọi đến 38 sẽ làm cho ví dụ trước hoạt động như mong đợ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)8 Đã thay đổi trong phiên bản 3.8: 38 now returns an 56 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 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')67 có thể được sử dụng như một người trang trí, người trang trí lớp học hoặc người quản lý bối cảnh. Các đối số Mới, Spec, Creat, Spec_set, Autospec và New_Callable có ý nghĩa tương tự như đối với 38. Giống như 38, >>> 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')67 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 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')67 Danh dự >>> 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')37 để chọn phương pháp nào để bọc. Bạn có thể gọi >>> 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')67 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í: >>> 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 Spec, Tạo và các đối số khác cho >>> 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')67 có ý nghĩa tương tự như chúng cho 38.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 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')76. 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. 53 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: 53 now returns the patched dictionary when used as a context manager.
53 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:>>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original0 Khi được sử dụng làm người trang trí lớp 53 Danh dự >>> 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')37 (mặc định là >>> 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')38) để chọn phương pháp nào để bọc: >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original1 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 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')37. Để biết thêm chi tiết về cách thay đổi giá trị của see test_prefix.TEST_PREFIX. 53 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.>>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original2 >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original3 Các từ khóa có thể được sử dụng trong cuộc gọi 53 để đặt các giá trị trong từ điển:>>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original4 53 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 thức ma thuật >>> 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')87, >>> 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')88, >>> 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')89 và >>> 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')90 hoặc >>> 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')91. >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original5 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á: >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original6 Sử dụng 78 làm giá trị nếu bạn muốn >>> 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')93 để 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 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')93 được sử dụng làm trình quản lý ngữ cảnh. >>> 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')93 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ố thông số kỹ thuật, spec_set, created, autospec và new_callable có ý nghĩa tương tự như đối với 38. 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 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')93. Khi được sử dụng làm người trang trí lớp >>> 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')93 Danh dự >>> 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')37 để chọn phương pháp nào để bọc. Nếu bạn muốn >>> 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')93 để tạo sự chế giễu cho bạn, thì bạn có thể sử dụng 78 làm giá trị. Nếu bạn 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')93 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. >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original7 >>> 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')93 có thể được lồng với các nhà trang trí >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'04 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 38:>>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original8 Nếu >>> 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')93 đượ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: >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original9 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'07 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'08. 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'09 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 38, >>> 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')67 hoặc 53 là bình thường và giữ một tham chiếu đến đối tượng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'13 đã trả lại. Sau đó, bạn có thể gọi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'07 để đặt bản vá vào vị trí và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'08 để hoàn tác nó. Nếu bạn đang sử dụng 38 để tạo một chế độ giả cho bạn thì nó sẽ được trả lại bằng cách gọi cho >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'17. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()0 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'09 của >>> 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')35: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()1 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'20. Đ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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'09 thì >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'22 không được gọi. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'23 làm cho điều này dễ dàng hơn: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()2 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'13. 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'25. 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'26. 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'27: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()3 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 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')38 là phương pháp thử nghiệm. Đây là cách tương tự mà >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'29 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 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')37: >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()4 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 = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()5 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 38 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 = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()6 Bây giờ chúng tôi muốn kiểm tra >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 nhưng chúng tôi muốn chế giễu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 bằng cách sử dụng 38. 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 từ mô -đun a. Nếu chúng tôi sử dụng 38 để chế giễu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'37 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 thực và có vẻ như việc vá lỗi của chúng tôi không có hiệu lực. Điều quan trọng là vá >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 nơi nó được sử dụng (hoặc nơi nó được tra cứu). Trong trường hợp này >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 sẽ thực sự tra cứu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'33 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 ____442 B không >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'43 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'32 sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'37. 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á >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'37 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 37 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'48 làm đối số đầu tiên 3. >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()7 >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()8 >>> mock = MagicMock() >>> mock.__str__.return_value = 'foobarbaz' >>> str(mock) 'foobarbaz' >>> mock.__str__.assert_called_with()9 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ố >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'49: 00Các cuộc gọi đến các phương thức ma thuật không xuất hiện trong 96, nhưng chúng được ghi lại trong 89.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 48.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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'80, >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'81, >>> 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 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)14. 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ể 41: 41 và 64. classunittest.mock.magicmock (*args, ** kw) ¶
unittest.mock.MagicMock(*args, **kw)¶ 41 là một lớp con của 37 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 41 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 37.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 41.Các tham số của hàm tạo có cùng ý nghĩa với 41, 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 41, 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: 01Theo 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ụ: 02Hai phương pháp bình đẳ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)68 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)69, 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 47, trừ khi bạn thay đổi giá trị trả về của chúng để trả về một cái gì đó khác: 03Giá trị trả về 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)71 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: 04Nế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: 05 41 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 41 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 37 đượ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 39 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 39 attributes now preserve their identity when they are >>> 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)92 or >>> 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)93. Đô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. 39 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 Monkey Patch >>> 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)95 để trả 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)96: 06MẶC ĐỊNH¶Unittest.mock.default¶DEFAULT¶Đối tượng 78 là một sentinel được tạo sẵn (thực ra 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)98). Nó có thể được sử dụng bởi các hàm 47 để 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)¶>>> 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()00 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 14, 15, 89 và 96. >>> 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()00 cũng có thể được sử dụng với 48.
07 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, >>> 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()07 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. >>> 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 đặc biệt hữu ích để đưa ra các xác nhận 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 89 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.>>> 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()07 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: 08Một đối tượng 18 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 18 có trong các thuộc tính 86, >>> 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()14 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()15 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 18 trong 86 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()14 là hai phần của (args vị trí, từ khóa args) trong khi các đối tượng 18 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()15, cùng với các đối tượng bạn tự xây dựng, là ba chữ cái của (tên, argres args, từ khóa tranh luận). 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: 09 10created_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à 94 thì cố gắng đặt các thuộc tính mà don don tồn tại trên đối tượng Spec sẽ tăng 48.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 >>> 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. 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. 56 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 tự động để biết các ví dụ về cách sử dụng tự động hóa tự động với 56 và đối số Autospec thành 38.Autospeccing for examples of how to use auto-speccing with 56 and the autospec argument to
38.KHÔNG TÍ NÀO¶Unittest.mock.Man¶ANY¶Đôi khi bạn có thể cần phải đưa ra các xác nhận 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 14 và đưa ra các xác nhận phức tạp hơn đối với 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 86 và 87 sau đó sẽ thành công bất kể điều gì đã được thông qua. 11>>> 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 cũng có thể được sử dụng để so sánh với các danh sách cuộc gọi như 89: 12Filter_Dir¶Unittest.mock.filter_dir¶FILTER_DIR¶ 01 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 >>> 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. Mặc định là 94, 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 >>> 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()35. Với việc lọc, 00 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 sẽ đượ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: 13Nhiều trong số những người không có ích (riêng tư đến 37 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 >>> 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 trên 37. 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 01: 14Ngoài ra, bạn chỉ có thể 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()41 (thành viên ví dụ) 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()42 (thành viên loại) để bỏ qua việc lọc không phân biệ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()43. 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 >>> 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()44. Nó hoạt động 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()44 đượ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 79 (mặc định) thì 41 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 >>> 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()48, >>> 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()49 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()50 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ợ >>> 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()49 and >>> 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()50 support. The mock of >>> 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()48 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 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')90 to implementation so that iteration (such as in for loops) correctly consumes read_data. 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()44 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: 15Vấn đề là ngay cả khi bạn chế giễu cuộc gọi đế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()44, đó là đối tượng được trả về được sử dụng làm trình quản lý bối cảnh (và 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()57 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()58 được gọi). Các nhà quản lý bối cảnh chế giễu với 41 là đủ phổ biến và đủ khó khăn để hàm trợ giúp là hữu ích. 16Và để đọc các tập tin: 17Tự động phátAutospeccing dựa trên tính năng 32 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 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')28 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. 37 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 37 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 37. 37 có hai phương pháp khẳng định cực kỳ tiện dụng: 86 và 87. 18Bở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: 19Cá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. >>> 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()68 đã 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 32 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: 20Thô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: 21Tự động giải quyết vấn đề này. Bạn có thể chuyển >>> 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')27 đến 38 / >>> 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')67 hoặc sử dụng hàm 56 để 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 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')27 cho 38 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: 22Bạn có thể thấy rằ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()76 có một 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()76 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: 23Thô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): 24Các đối 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()78 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 >>> 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()76 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: 25Trong nhiều trường hợp, bạn sẽ có thể thêm >>> 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')27 vào các cuộc gọi 38 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 38, có một 56 để tạo trực tiếp các chế giễu tự động: 26Tuy 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 >>> 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à 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. 27Có 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: 28Có 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: 29Có 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 >>> 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. Lưu ý rằng nếu bạn chỉ thiết lập các thuộc tính mặc định 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()84 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à 79 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. 79 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ì 79 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 79. Đây sẽ chỉ là những giả thông thường (tốt - MagicMocks): 30Nế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 38 hỗ trợ điều này - bạn có thể chỉ cần chuyển đối tượng thay thế như đối số Autospec: 314Đ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 >>> 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 - đượ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ả. 32Mới trong phiên bản 3.7. @Patch trong Python là gì?Điều này, cùng với các lớp con của nó, sẽ đáp ứng hầu hết các nhu cầu chế giễu Python mà bạn sẽ phải đối mặt trong các bài kiểm tra của mình. Thư viện cũng cung cấp một hàm, được gọi là Patch (), thay thế các đối tượng thực trong mã của bạn bằng các phiên bản giả.replaces the real objects in your code with Mock instances.
Side_effect trong giả trăn là gì?Side_Effect: Một chức năng được gọi bất cứ khi nào giả được gọi.Xem thuộc tính Side_Effect.Hữu ích để nâng cao các ngoại lệ hoặc thay đổi một cách tự động các giá trị trả về.Hàm được gọi với cùng một đối số với giả và trừ khi nó trả về mặc định, giá trị trả về của hàm này được sử dụng làm giá trị trả về.A function to be called whenever the Mock is called. See the side_effect attribute. Useful for raising exceptions or dynamically changing return values. The function is called with the same arguments as the mock, and unless it returns DEFAULT , the return value of this function is used as the return value.
Assert_called_once_with là gì?assert_called_once_with () được sử dụng để kiểm tra xem phương thức có được gọi với một tập hợp các đối số cụ thể không.used to check if the method is called with a particular set of arguments.
Làm thế nào để kiểm tra đơn vị hoạt động trong Python?Kiểm tra đơn vị là một phương pháp để kiểm tra phần mềm xem xét các đoạn mã có thể kiểm tra nhỏ nhất, được gọi là đơn vị, được kiểm tra để hoạt động chính xác.Bằng cách thực hiện kiểm tra đơn vị, chúng tôi có thể xác minh rằng mỗi phần của mã, bao gồm các chức năng trợ giúp có thể không được tiếp xúc với người dùng, hoạt động chính xác và như dự định.looks at the smallest testable pieces of code, called units, which are tested for correct operation. By doing unit testing, we can verify that each part of the code, including helper functions that may not be exposed to the user, works correctly and as intended. |