From 5f8de423f190bbb79a62f804151bc24824fa32d8 Mon Sep 17 00:00:00 2001 From: "Matt A. Tobin" Date: Fri, 2 Feb 2018 04:16:08 -0500 Subject: Add m-esr52 at 52.6.0 --- python/mock-1.0.0/html/sentinel.html | 156 +++++++++++++++++++++++++++++++++++ 1 file changed, 156 insertions(+) create mode 100644 python/mock-1.0.0/html/sentinel.html (limited to 'python/mock-1.0.0/html/sentinel.html') diff --git a/python/mock-1.0.0/html/sentinel.html b/python/mock-1.0.0/html/sentinel.html new file mode 100644 index 000000000..5b28deb2c --- /dev/null +++ b/python/mock-1.0.0/html/sentinel.html @@ -0,0 +1,156 @@ + + + + + + + + + Sentinel — Mock 1.0.0 documentation + + + + + + + + + + + + + + + +
+
+
+
+ +
+

Sentinel

+
+
+sentinel
+

The sentinel object provides a convenient way of providing unique +objects for your tests.

+

Attributes are created on demand when you access them by name. Accessing +the same attribute will always return the same object. The objects +returned have a sensible repr so that test failure messages are readable.

+
+ +
+
+DEFAULT
+

The DEFAULT object is a pre-created sentinel (actually +sentinel.DEFAULT). It can be used by side_effect +functions to indicate that the normal return value should be used.

+
+ +
+

Sentinel Example

+

Sometimes when testing you need to test that a specific object is passed as an +argument to another method, or returned. It can be common to create named +sentinel objects to test this. sentinel provides a convenient way of +creating and testing the identity of objects like this.

+

In this example we monkey patch method to return +sentinel.some_object:

+
>>> real = ProductionClass()
+>>> real.method = Mock(name="method")
+>>> real.method.return_value = sentinel.some_object
+>>> result = real.method()
+>>> assert result is sentinel.some_object
+>>> sentinel.some_object
+sentinel.some_object
+
+
+
+
+ + +
+
+
+
+
+

Table Of Contents

+ + +

Previous topic

+

Helpers

+

Next topic

+

Mocking Magic Methods

+

This Page

+ + + +
+
+
+
+ + + + \ No newline at end of file -- cgit v1.2.3