Check remote calls via request
Project description
A tool to check for remote calls via the requests module.
Find out which external apis your code is calling.
- Optionally:
Find where calls are taking place.
Capture the responses and response status codes.
Filter by domain
Run as a server for parallel tests
- 2.x Notes:
Now mocks the send() method on requests’ HTTPAdapter class.
Now monitor-requests instead of MonitorRequests
Installation
pip install monitor-requestsUsage
import unittest
import monitor_requests
from example import example_method
class ExampleTestCase(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.monitor = monitor_requests.Monitor()
@classmethod
def tearDownClass(cls):
print('External calls for example:')
# Optionally pass tracebacks=False to skip outputing tracebacks
# Report will call .stop() by default.
cls.monitor.report(tracebacks=False)
def test_example_method(self):
result = example_method()
self.assertEqual(result.status_code, 200)
if __name__ == 'main':
unittest.main()To filter what domains are captured:
# Only capture facebook and google requests:
monitor = monitor_requests.Monitor(
domains=['facebook\.com', 'google\.com']
)To set this up inside a django test runner: (This will only work at the suite level if running tests in serial. Depending on your setup you may need to run with –parallel=1). Alternatively there are instructions further down on how to use Server Moder to push data asynchronously to an included tornado data server.
def run_suite(self, suite, **kwargs):
monitor = monitor_requests.Monitor()
test_result = super(ReelioTestRunner, self).run_suite(suite, **kwargs)
monitor.report()
return test_resultTo set up inside a py.test session fixture:
@pytest.fixture(scope='session')
def session_fixture():
monitor = monitor_requests.Monitor()
yield
monitor.report()To write to a file:
@classmethod
def tearDownClass(cls):
with open('output.txt', 'w') as f:
cls.monitor.report(output=f)For finer tuned control over output:
Use debug=True to show urls, responses, and tracebacks.
Use urls=True to show urls.
Use tracebacks=True or respones=True to show tracebacks or responses (urls will be shown as well, as both tracebacks and responses are organized by url).
*Server Mode*
If you want to activate monitor_requests for an entire test suite running parallel, you can run the included tornado server to persist request data:
monitor_requests_server --port=9003def run_suite(self, suite, **kwargs):
# Make sure to turn off mocking at the suit or session level.
monitor = monitor_requests.Monitor(server_port=9003, mocking=False)
test_result = super(ReelioTestRunner, self).run_suite(suite, **kwargs)
monitor.report()
return test_resultYou will need to do additional calls in your TestCase classes:
class ExampleTestCase(unittest.TestCase):
@classmethod
def setUpClass(cls):
# Same port, and same domain filtering if applicable.
cls.monitor = monitor_requests.Monitor(server_port=9003)
@classmethod
def tearDownClass(cls):
# Make sure to stop the mocking in the tear down.
cls.monitor.stop()Note that here there is no tearDownClass and no call to either stop() or report(). That only happens at the session level.
Example Output
With debug=True:
__________URLS__________
__________URL________
URL: http://facebook.com?param=test
Methods: GET
Requests: 1
______Tracebacks_____
File "example.py", line 22, in <module>
run()
File "example.py", line 18, in run
get_function_fb()
File "example.py", line 12, in get_function_fb
return requests.get('http://facebook.com?param=test')
_______Responses______
<StatusCode>200</StatusCode>
<Content><!DOCTYPE html>
<html lang="en" id="facebook" class="no_js">Etc/Etc</html></Content>
__________URL________
URL: http://google.com
Methods: GET
Requests: 1
______Tracebacks_____
File "example.py", line 22, in <module>
run()
File "example.py", line 17, in run
get_function()
File "example.py", line 7, in get_function
return requests.get('http://google.com')
_______Responses______
<StatusCode>200</StatusCode>
<Content><!doctype html><html itemscope="" itemtype="http://schema.org/WebPage" lang="en">Etc/Etc</html></Content>
___________Analysis__________
Total Requests: 2
Time (Seconds): 1.16714
URL Count: 2
Domain Count: 2
Domains: facebook.com, google.comWith debug=False:
___________Analysis__________
Total Requests: 2
Time (Seconds): 1.08454
URL Count: 2
Domain Count: 2
Domains: facebook.com, google.com
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for monitor_requests-2.1.1-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | bc218cce72405477cfa9804fc85bbb033b8c5261b432ca11dcbc1996f75c31fa |
|
| MD5 | 32a11870bc084c08de6c78ed553b20d3 |
|
| BLAKE2b-256 | 0f1026c6f5192c6eab929851738597478bcc45002aec655d8a0fd45a2d7a738f |
