Skip to main content

Record activity from a WSGI application, and generate WebTest tests from that record

Project description

This package lets you record all the requests and responses of an application, and then create a doctest from that. (There’s no real reason it couldn’t be a unit test… just haven’t written that yet.)

The recorder is a piece of middleware. You use it like this:

from webtestrecorder import record_file

app = ... instantiate app ...
app = record_file(app, '/tmp/record.txt')

All requests and responses will be written to this file. You can read them out like so:

from webtestrecorder import get_records

records = get_records(open('/tmp/record.txt', 'rb'))

records is a list of requests, and each request has a .response attribute. You can then create a test:

from webtestrecorder import write_doctest

write_doctest(records, open('/tmp/doctest.txt', 'wb'))

You can also use this like a shell script:

$ python -m webtestrecorder < /tmp/record.txt > /tmp/doctest.txt

Apache Logs

You can read requests and responses from Apache logs via webtestrecorder.apachelog.parse_apache_log(). A constraint of this is that request bodies won’t be present, and responses just have a status code and Content-Length, the Content-Type is unknown and the body is padded with null bytes.

Rerunning requests

The module webtestrecorder.http can take a list of requests/responses and send them to a server, effectively replaying requests. This is also a command-line program usable like:

$ python -m webtestrecorder.http apache_access.log --host localhost:8000

You can filter or rewrite these requests with a custom filter function. See python -m webtestrecorder.http -h for more.



  • Packaging fixes


  • Initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

WebTestRecorder-0.1.1.tar.gz (13.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page