wsgi_intercept

This software review will focus on wsgi_intercept, a library that streamlines testing for WSGI applications. Typically, testing WSGI applications involves starting a server at a local host and port, and directing your test code to that address. However, with wsgi_intercept, you can intercept calls to any specific host/port combination and redirect them into a WSGI application importable by your test program instead. This approach allows you to avoid spawning multiple processes or threads to test your Web app, thus rendering the whole process much simpler.

So, how does it work? wsgi_intercept replaces httplib.HTTPConnection with a subclass known as wsgi_intercept.WSGI_HTTPConnection. This class redirects specific server/port combinations into a WSGI application by emulating a socket. If there is no intercept registered for the host and port requested, those requests are passed on to the standard handler for processing.

With wsgi_intercept, you can use the functions add_wsgi_intercept(host, port, app_create_fn, script_name='') and remove_wsgi_intercept(host,port) to specify which URLs should be redirected to what applications. It is important to note particularly that app_create_fn must be a function object returning a WSGI application. Additionally, script_name becomes SCRIPT_NAME in the WSGI app's environment if it is set.

Overall, wsgi_intercept is a valuable tool for developers looking to simplify the testing of WSGI applications. Its ability to redirect calls to any specific host/port combination and its straightforward interface make it an excellent choice for anyone looking to streamline their development process.