Hướng dẫn python format keyerror n - keyerror định dạng python n
|
Đoạn mã sau: Show
ném KeyError: Có ai đó biết tại sao? Đã hỏi ngày 8 tháng 3 năm 2012 lúc 18:51Mar 8, 2012 at 18:51
 3
Bạn có một số niềng răng không được phân loại trong mã đó. Python coi tất cả các niềng răng là người giữ chỗ và đang cố gắng thay thế tất cả. Tuy nhiên, bạn chỉ cung cấp một giá trị. Tôi hy vọng rằng bạn không muốn tất cả các niềng răng của bạn là người giữ chỗ, vì vậy bạn nên nhân đôi những người mà bạn không muốn thay thế. Như là: Tôi cũng đã tự do sử dụng ba trích dẫn cho chuỗi theo nghĩa đen để bạn không cần dấu gạch chéo ngược ở cuối mỗi dòng. Đã trả lời ngày 8 tháng 3 năm 2012 lúc 18:57Mar 8, 2012 at 18:57
Kindallkindallkindall 173K34 Huy hiệu vàng268 Huy hiệu bạc300 Huy hiệu đồng34 gold badges268 silver badges300 bronze badges 1 Mới trong phiên bản 3.3. Mã nguồn: lib/unittest/mock.py Lib/unittest/mock.py Ngoài ra, Mock cung cấp một trình trang trí Mock được thiết kế để sử dụng với Có một backport là Hướng dẫn nhanh¶Các đối 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') >>> 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 Bộ trang trí / Trình quản lý bối cảnh >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test() 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ụ trên giả cho Với Cũng như một người 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) Ngoài ra còn có >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original Mock hỗ trợ việc chế giễu các phương pháp ma thuật Python. Cách dễ nhất để sử dụng các phương thức ma thuật là với lớp >>> mock = 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 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: Để đả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 Đ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: Lớp giảCác nhà trang trí Tạo một đối tượng
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 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. assert_called_once () ¶()¶Khẳng định rằng giả được gọi là chính xác một lần. Mới trong phiên bản 3.6. assert_called_once () ¶(*args, **kwargs)¶Khẳng định rằng giả được gọi là chính xác một lần. 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ể: 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) ¶ Assert vượt qua nếu giả đã được gọi, không giống như 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 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 assert_not_called () ¶ Khẳng định giả không bao giờ được gọi.(*, return_value=False, side_effect=False)¶Mới trong phiên bản 3.5. reset_mock (*, return_value = false, side_effect = false) ¶Added two keyword only argument to the reset_mock function. Phương thức reset_mock đặt lại tất cả các thuộc tính cuộc gọi trên một đối tượng giả: Đã thay đổi trong phiên bản 3.6: Đã thêm hai đối số từ khóa vào chức năng reset_mock. Điều này có thể hữu ích khi bạn muốn thực hiện một loạt các xác nhận sử dụng lại cùng một đối tượng. Lưu ý rằng return_value và Mock_add_spec (spec, spec_set = false) ¶ Thêm một thông số kỹ thuật vào một giả. Thông số kỹ thuật có thể là một đối tượng hoặc một danh sách các chuỗi. Chỉ các thuộc tính trên thông số kỹ thuật mới có thể được tìm nạp dưới dạng các thuộc tính từ giả.(mock, attribute)¶Nếu spec_set là đúng thì chỉ có thể đặt các thuộc tính trên thông số kỹ thuật. bomptep_mock (giả, thuộc tính) ¶(**kwargs)¶Đính kèm một giả làm một thuộc tính của cái này, thay thế tên và cha mẹ của nó. Các cuộc gọi đến Mock đính kèm sẽ được ghi lại trong các thuộc tính Cấu hình_mock (** kwargs) ¶ Đặt các thuộc tính trên giả thông qua các đối số từ khóa. Các thuộc tính cộng với các giá trị trả về và các tác dụng phụ có thể được đặt trên các chế giễu trẻ em bằng cách sử dụng ký hiệu dấu chấm tiêu chuẩn và giải nén từ điển trong cuộc gọi phương thức: Điều tương tự có thể đạt được trong cuộc gọi xây dựng đến Mocks:()¶__dir __ () Xem _get_child_mock (** kw) ¶ Tạo các chế giễu trẻ em cho các thuộc tính và giá trị trả về. Theo mặc định, chế giễu trẻ em sẽ có cùng loại với cha mẹ. Các lớp con của Mock có thể muốn ghi đè lên điều này để tùy chỉnh cách chế tạo trẻ em.¶Đối với giả không thể gọi, biến thể có thể gọi sẽ được sử dụng (thay vì bất kỳ lớp con tùy chỉnh nào). Một boolean đại diện cho việc đối tượng giả có được gọi là: Một số nguyên cho bạn biết bao nhiêu lần đối tượng giả đã được gọi: return_value¶ Đặt cái này để định cấu hình giá trị được trả về bằng cách gọi Mock: 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. 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): Sử dụng Sử dụng một cuộc gọi có thể gọi đượ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')0 Cài đặ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')1 Call_args¶¶ Đâ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')2 Đã thay đổi trong phiên bản 3.8: Đã thêm các thuộc tính Đâ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 >>> 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 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 >>> 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 Ghi chú Cách >>> 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 >>> 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 >>> 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 Các đối tượng giả sử dụng một lớp hoặc một thể hiện dưới 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')9 Các lớp Các lớp giả và các nhà trang trí >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'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 Một chế độ giả có thể gọi được được tạo ra với một thông số kỹ thuật (hoặc một spec_set) sẽ hướng nội vào chữ ký của đối tượng đặc tả khi khớp các cuộc gọi với giả. Do đó, nó có thể khớp với các đối số cuộc gọi thực tế bất kể chúng được thông qua vị trí hay theo tên: >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'2 Điều này áp dụng cho 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. Tìm nạp một thể hiện >>> 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 >>> 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 >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'5 Kết quả của
Đặt thông số kỹ thuật của >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'6 Đặt thông số của >>> 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 >>> 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 Nếu Any_order là sai thì các chờ đợi phải được tuần tự. Có thể có thêm các cuộc gọi trước hoặc sau khi được chỉ định đang chờ. Nếu Any_order là đúng thì các chờ đợi có thể theo bất kỳ thứ tự nào, nhưng tất cả chúng phải xuất hiện trong >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)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 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à >>> 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 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ư Nếu 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 >>> 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 >>> 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 >>> 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 >>> 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 >>> 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')00 đượ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')01 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')02 hoặc tăng 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 >>> 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 >>> 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 >>> 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 >>> 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')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()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 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)¶Nếu mới bị bỏ qua, thì mục tiêu sẽ được thay thế bằng 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')18. 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 Các đối số từ khóa spec_set được truyền đế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')21 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')22, đ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 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')25 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')26 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 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')25, 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')29 để 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 >>> 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 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')31, 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')33. 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. >>> 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. 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')36, phù hợp với cách >>> 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. 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 >>> 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')43, >>> 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')44 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')45 có sẵn cho các trường hợp sử dụng thay thế. >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)0 Việc vá một lớp thay thế lớp bằng một thể hiện Nếu lớp được khởi tạo nhiều lần, bạn có thể sử dụng Để đị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 >>> 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à >>> 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 >>> 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')54: >>> 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 >>> 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ư >>> 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 >>> 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 việc 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')31 trong cuộc gọi đến >>> with patch.object(ProductionClass, 'method', return_value=None) as mock_method: ... thing = ProductionClass() ... thing.method(1, 2, 3) ... >>> mock_method.assert_called_once_with(1, 2, 3)8 Đã thay đổi trong phiên bản 3.8: 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')65 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ố Mới, Spec, Creat, Spec_set, Autospec và New_Callable có ý nghĩa tương tự như đối vớ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')65 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')65 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')35 để 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')65 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')65 có ý nghĩa tương tự như chúng cho 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')74. 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. Đã thay đổi trong phiên bản 3.8: >>> 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 >>> 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 (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')36) để 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')35. Để biết thêm chi tiết về cách thay đổi giá trị của see test_prefix.TEST_PREFIX. >>> 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 >>> foo = {'key': 'value'} >>> original = foo.copy() >>> with patch.dict(foo, {'newkey': 'newvalue'}, clear=True): ... assert foo == {'newkey': 'newvalue'} ... >>> assert foo == original4 >>> 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')85, >>> 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')86, >>> 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 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')88 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')89. >>> 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 >>> 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 để 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')91 đượ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')91 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ố thông số kỹ thuật, spec_set, created, autospec và new_callable có ý nghĩa tương tự như đối vớ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')91. 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')91 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')35 để 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')91 để tạo sự chế giễu cho bạn, thì bạn có thể 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')91 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')91 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'02 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 >>> 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')91 đượ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'05 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'06. 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'07 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 >>> 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')65 hoặc >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'11 đã trả lại. Sau đó, bạn có thể gọi >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'05 để đặt bản vá vào vị trí và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'06 để hoàn tác nó. Nếu bạn đang sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'15. >>> 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'07 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')33: >>> 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'18. Đ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'07 thì >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'20 không được gọi. >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'21 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'11. 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'23. 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'24. 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'25: >>> 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')36 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'27 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')35: >>> 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 ở đâuNguyê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'30 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'31 bằng cách sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'31 từ mô -đun a. Nếu chúng tôi sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'35 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'31 thực và có vẻ như việc vá lỗi của chúng tôi không có tác dụng. Điều quan trọng là vá >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'31 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'30 thực sự sẽ tra cứu >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'31 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 ____440 B không >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'41 và >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'30 sử dụng >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'35. 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'35 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ễuBở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'46 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 người quản lý ngữ cảnh trong tuyên bố >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'47: Các cuộc gọi đến các phương thức ma thuật không xuất hiện trong 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 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'78, >>> mock = Mock(side_effect=KeyError('foo')) >>> mock() Traceback (most recent call last): ... KeyError: 'foo'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)11 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)12. 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ể Các tham số hàm tạo có cùng ý nghĩa với 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 Các tham số của hàm tạo có cùng ý nghĩa với Các phương thức ma thuật được thiết lập với các đối tượng Theo mặc định, nhiều phương thức giao thức được yêu cầu trả về các đối tượng thuộc loại cụ thể. Các phương thức này được cấu hình sẵn với giá trị trả về mặc định, do đó chúng có thể được sử dụng mà không cần bạn phải làm bất cứ điều gì nếu bạn không quan tâm đến giá trị trả về. Bạn vẫn có thể đặt giá trị trả về theo cách thủ công nếu bạn muốn thay đổi mặc định. Phương pháp và mặc định của chúng:
Ví dụ: Hai 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)66 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)67, 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 Giá 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)69 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: Nếu giá trị trả về là một trình lặp, thì việc lặp lại nó một lần sẽ tiêu thụ nó và các lần lặp tiếp theo sẽ dẫn đến một danh sách trống: 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
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 Người trợ giúp trongSentinel¶Unittest.mock.sentinel¶sentinel¶Đối tượng 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 >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)90 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)91. Đô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. Trong ví dụ này, chúng tôi, khỉ monkey >>> 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 để 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)94: MẶC ĐỊNH¶Unittest.mock.default¶DEFAULT¶Đối tượng >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)96). Nó có thể được sử dụng bởi các hàm cuộc gọi¶unittest.mock.call (*args, ** kwargs) ¶call(*args, **kwargs)¶>>> 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 là một đối tượng trợ giúp để đưa ra các xác nhận đơn giản hơn, để so sánh với >>> values = {'a': 1, 'b': 2, 'c': 3} >>> def side_effect(arg): ... return values[arg] ... >>> mock.side_effect = side_effect >>> mock('a'), mock('b'), mock('c') (1, 2, 3) >>> mock.side_effect = [5, 4, 3, 2, 1] >>> mock(), mock(), mock() (5, 4, 3)98 cũng có thể được sử dụng với Đố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()05 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()06 đặc biệt hữu ích để đưa ra các khẳng định trên các cuộc gọi chuỗi xích. Một cuộc gọi có chuỗi là nhiều cuộc gọi trên một dòng mã. Điều này dẫn đến nhiều mục trong >>> 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()05 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: Một đố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()12 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()13 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 >>> 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()12 là hai phần của (args vị trí, từ khóa args) trong khi cá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()13, cùng với các đối tượng bạn tự xây dựng, là ba chữ cái (tên, args. 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: created_autospec¶unittest.mock.create_autospec (spec_set = false, instance = false, ** kwargs) ¶create_autospec(spec, spec_set=False, instance=False, **kwargs)¶Tạo một đối tượng giả bằng cách sử dụng một đối tượng khác như một thông số kỹ thuật. Các thuộc tính trên giả sẽ sử dụng thuộc tính tương ứng trên đối tượng Spec làm thông số kỹ thuật của chúng. Các chức năng hoặc phương pháp bị chế giễu sẽ kiểm tra đối số của chúng để đảm bảo rằng chúng được gọi với chữ ký chính xác. Nếu spec_set là 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()21. 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. Xem tự động để biết các ví dụ về cách sử dụng tự động hóa tự động với 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 Để 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 >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()28 cũng có thể được sử dụng để so sánh với các danh sách cuộc gọi như Filter_Dir¶Unittest.mock.filter_dir¶FILTER_DIR¶>>> 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()31. Mặc định là >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()33. Với việc lọc, Nhiều trong số những người không có ích (riêng tư đến >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()31 trên Ngoà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()39 (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()40 (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()41. 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()42. 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()42 đượ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 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()46, >>> 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()47 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()48 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()47 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()48 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()46 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')88 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()42 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: Vấ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()42, đó 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()55 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()56 được gọi). Các nhà quản lý bối cảnh chế giễu với Và để đọc các tập tin: Tự động phátAutospeccing dựa trên tính nă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')26 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. Đầu tiên là vấn đề cụ thể cho Bởi vì chế giễu các thuộc tính tạo tự động theo yêu cầu và cho phép bạn gọi chúng bằng các đối số tùy ý, nếu bạn viết sai một trong những phương thức khẳng định này thì khẳng định của bạn đã biến mất: Các bài kiểm tra của bạn có thể vượt qua âm thầm và không chính xác vì lỗi đánh máy. Vấn đề thứ hai là tổng quát hơn để chế giễu. Nếu bạn tái cấu trúc một số mã của mình, đổi tên thành viên, v.v., bất kỳ kiểm tra nào cho mã vẫn đang sử dụng API cũ nhưng sử dụng giả thay vì các đối tượng thực vẫn sẽ vượt qua. Điều này có nghĩa là tất cả các bài kiểm tra của bạn có thể vượt qua mặc dù mã của bạn bị hỏng. Lưu ý rằng đây là một lý do khác tại sao bạn cần kiểm tra tích hợp cũng như các bài kiểm tra đơn vị. Kiểm tra mọi thứ trong sự cô lập đều ổn và bảnh bao, nhưng nếu bạn không kiểm tra cách các đơn vị của bạn có dây với nhau thì vẫn còn rất nhiều chỗ cho các lỗi mà các bài kiểm tra có thể đã bắt được. >>> 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()66 đã 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 Thông số kỹ thuật chỉ áp dụng cho chính giả, vì vậy chúng tôi vẫn có cùng một vấn đề với bất kỳ phương thức nào trên Mock: Tự độ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')25 đế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')65 hoặc sử dụng hà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')25 cho Ở đây, một ví dụ về nó được sử dụng: Bạ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()74 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()74 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: Thông số kỹ thuật cũng áp dụng cho các lớp khởi tạo (nghĩa là giá trị trả về của giả đặc biệt): Cá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()76 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()74 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: Trong 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')25 vào các cuộc gọi Cũng như sử dụng autospec thông qua Tuy nhiên, đây không phải là những lời cảnh báo và hạn chế, đó là lý do tại sao nó không phải là hành vi mặc định. Để biết những thuộc tính nào có sẵn trên đối tượng Spec, Autospec phải hướng nội (thuộc tính truy cập) thông số kỹ thuật. Khi bạn đi qua các thuộc tính trên giả, một đường truyền tương ứng của đối tượng ban đầu đang xảy ra dưới mui xe. Nếu bất kỳ đối tượng cụ thể nào của bạn có thuộc tính hoặc mô tả có thể kích hoạt thực thi mã thì bạn có thể không sử dụng Autospec. Mặt khác, tốt hơn là thiết kế các đối tượng của bạn để hướng nội là an toàn 4. Một vấn đề nghiêm trọng hơn là các thuộc tính thường được tạo ra trong phương thức >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()82 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. Có một vài cách khác nhau để giải quyết vấn đề này. Cách dễ nhất, nhưng không nhất thiết là cách ít khó chịu nhất, chỉ đơn giản là đặt các thuộc tính cần thiết trên giả sau khi tạo. Chỉ vì autospec không cho phép bạn tìm nạp các thuộc tính mà don lồng tồn tại trên thông số kỹ thuật, nó không ngăn cản bạn thiết lập chúng: Có một phiên bản tích cực hơn của cả spec và autospec không ngăn cản bạn thiết lập các thuộc tính không tồn tại. Điều này rất hữu ích nếu bạn muốn đảm bảo mã của mình chỉ đặt các thuộc tính hợp lệ, nhưng rõ ràng nó ngăn chặn kịch bản cụ thể này: Có lẽ cách tốt nhất để giải quyết vấn đề là thêm các thuộc tính lớp làm giá trị mặc định cho các thành viên được khởi tạo trong >>> from unittest.mock import patch >>> @patch('module.ClassName2') ... @patch('module.ClassName1') ... def test(MockClass1, MockClass2): ... module.ClassName1() ... module.ClassName2() ... assert MockClass1 is module.ClassName1 ... assert MockClass2 is module.ClassName2 ... assert MockClass1.called ... assert MockClass2.called ... >>> test()82. 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()82 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à Nếu việc sửa đổi các lớp sản xuất của bạn để thêm mặc định là theo ý thích của bạn thì có nhiều tùy chọn hơn. Một trong số này chỉ đơn giản là sử dụng một thể hiện làm thông số kỹ thuật chứ không phải lớp. Cái khác là tạo một lớp con của lớp sản xuất và thêm mặc định vào lớp con mà không ảnh hưởng đến lớp sản xuất. Cả hai đều yêu cầu bạn sử dụng một đối tượng thay thế làm thông số kỹ thuật. Rất may Đ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. Nó 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()31 - đượ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ả. Mới trong phiên bản 3.7. |
