During the recording phase, Retrace captures all I/O interactions and the program’s structure, storing everything needed to enable deterministic replay.

Using a custom proxy system, Retrace ensures that the program can be re-executed with the recorded I/O, faithfully reproducing its original behavior.

 

 

Implement our Record-Replay library in any Python application in just five minutes.
With a few lines of code you can start recording your application's interactions and replaying them for detailed analysis. Here's how to get started:

Step 1: Set Up Your Environment

To begin using Retrace, you'll need to set some environment variables in your project directory. Open a terminal and run the following commands:

PYTHONPATH: Set this to the directory containing the retrace-record-replay repository. This will vary depending on where you have installed it on your system. For example:

RETRACE_MODE: Set this to record for recording. For example:

Step 2: Start Recording

With the environment variables set, you're ready to start recording your application. Simply use the command you normally use to start your application. For example, if you're using Django, run:

Retrace will now capture all interactions and save them for later replay.

Step 3: Replay Your Recorded Session

When you're ready to replay a recorded session, it's just as simple. First, set Retrace to replay mode by running:

Then, use the same command you used during recording. For example: python manage.py runserver

Retrace will read the recorded data from the trace directory and reproduce the application's execution, providing detailed logs along the way.

That's it! With these three simple steps, you can harness the power of Retrace's Record-Replay functionality to streamline your debugging and testing process. Say goodbye to time-consuming bug hunts and hello to efficient, reproducible debugging sessions.