refactor(examples): enable pook engine per example file

examples/README.rst

@@ -3,11 +3,15 @@
 
 Run examples via:
 
+.. code:: python
+
     $ python examples/<example>.py
 
 
 Example:
 
+.. code:: python
+
     $ python examples/requests_client.py
 
 

examples/chainable_api.py

@@ -3,6 +3,9 @@
 import requests
 
 
+# Enable mock engine
+pook.on()
+
 (pook.post('httpbin.org/post')
     .json({'foo': 'bar'})
     .type('json')

examples/http_client_native.py

@@ -2,6 +2,9 @@
 import pook
 
 
+# Enable mock engine
+pook.on()
+
 mock = pook.get('http://httpbin.org/ip',
                 reply=404, response_type='json',
                 response_json={'error': 'not found'})

examples/json_matching.py

@@ -2,6 +2,8 @@
 import pook
 import requests
 
+# Enable mock engine
+pook.on()
 
 (pook.post('httpbin.org/post')
     .json({'foo': 'bar'})

examples/json_schema.py

@@ -10,6 +10,9 @@
     }
 }
 
+# Enable mock engine
+pook.on()
+
 (pook.post('httpbin.org/post')
     .jsonschema(schema)
     .reply(204)

examples/match_callback.py

@@ -6,6 +6,9 @@ def on_match(request, mock):
     print('On match:', request, mock)
 
 
+# Enable mock engine
+pook.on()
+
 pook.get('httpbin.org/ip',
          reply=403, response_type='json',
          response_headers={'pepe': 'lopez'},

examples/mocket_example.py

@@ -8,7 +8,7 @@
 # Use mocket library as underlying mock engine
 pook.set_mock_engine(MocketEngine)
 
-# Explicitly enable pook HTTP mocking (optional)
+# Explicitly enable pook HTTP mocking (required)
 pook.on()
 
 # Target server URL to mock out

examples/network_mode.py

@@ -2,6 +2,9 @@
 import requests
 
 
+# Enable mock engine
+pook.on()
+
 # Enable network mode
 pook.enable_network()
 

examples/nose_example.py

@@ -11,6 +11,7 @@ def test_simple_pook_request():
     assert res.status_code == 204
 
 
+@pook.on
 def test_enable_engine():
     pook.get('server.com/foo').reply(204)
     res = requests.get('http://server.com/foo')
@@ -30,6 +31,7 @@ def test_context_manager():
         assert res.status_code == 204
 
 
+@pook.on
 def test_no_match_exception():
     pook.get('server.com/bar', reply=204)
     try:

examples/persistent_mock.py

@@ -2,6 +2,9 @@
 import requests
 
 
+# Enable mock engine
+pook.on()
+
 (pook.get('httpbin.org')
     .headers({'Client': 'requests'})
     .persist()

examples/pytest_example.py

@@ -12,6 +12,7 @@ def test_simple_pook_request():
     assert res.status_code == 204
 
 
+@pook.on
 def test_enable_engine():
     pook.get('server.com/foo').reply(204)
     res = requests.get('http://server.com/foo')
@@ -32,6 +33,7 @@ def test_context_manager():
         assert res.status_code == 204
 
 
+@pook.on
 def test_no_match_exception():
     pook.get('server.com/bar', reply=204)
     with pytest.raises(Exception):

examples/regex.py

@@ -2,6 +2,9 @@
 import requests
 
 
+# Enable mock engine
+pook.on()
+
 # Mock definition based
 (pook.get(pook.regex('h[t]{2}pbin.*'))
     .path(pook.regex('/foo/[a-z]+/baz'))

examples/requests_client.py

@@ -2,6 +2,9 @@
 import requests
 
 
+# Enable mock engine
+pook.on()
+
 pook.get('httpbin.org/ip',
          reply=403, response_type='json',
          response_headers={'server': 'pook'},

examples/simulated_error.py

@@ -1,6 +1,10 @@
 import pook
 import requests
 
+
+# Enable mock engine
+pook.on()
+
 # Simulated error exception on request matching
 pook.get('httpbin.org/status/500', error=Exception('simulated error'))
 

examples/time_ttl_mock.py

@@ -1,6 +1,10 @@
 import pook
 import requests
 
+
+# Enable mock engine
+pook.on()
+
 # Declare mock
 (pook.get('httpbin.org')
     .times(2)

examples/unittest_example.py

@@ -5,7 +5,7 @@
 
 class TestUnitTestEngine(unittest.TestCase):
 
-    @pook.activate
+    @pook.on
     def test_request(self):
         pook.get('server.com/foo').reply(204)
         res = requests.get('http://server.com/foo')
@@ -17,6 +17,7 @@ def test_request_with_context_manager(self):
             res = requests.get('http://server.com/bar')
             self.assertEqual(res.status_code, 204)
 
+    @pook.on
     def test_no_match_exception(self):
         pook.get('server.com/bar', reply=204)
         try:

pook/engine.py

@@ -426,7 +426,12 @@ def match(self, request):
 
         # Validate that we have a mock
         if not self.should_use_network(request):
-            msg = 'Cannot match mock for request:\n{}'.format(request)
+            msg = 'pook error!\n\n'
+
+            msg += (
+                '=> Cannot match any mock for the '
+                'following request:\n{}'.format(request)
+            )
 
             # Compose unmatch error details, if debug mode is enabled
             if self.debug: