README.rst

Transformer

A command-line tool and Python library to convert web browser sessions (HAR files) into Locust load test scenarios ("locustfiles").

Use it to replay HAR files (storing recordings of interactions with your website) in load tests with Locust.

• Installation
• Usage
  • Command-line
  • Library
• Documentation
• Authors
• License

Installation

Install from PyPI:

pip install har-transformer

Note that the new major version of Locust (1.0 and up) is not yet supported. Please make sure you have a compatible Locust to run your locustfiles:

pip install locustio==0.14.6

We hope to lift this restriction very soon!

Usage

Example HAR files are included in the examples/ directory, try them out.

Command-line

transformer my_har_files_directory/ >locustfile.py

Library

import transformer

with open("locustfile.py", "w") as f:
    transformer.dump(f, ["my_har_files_directory/"])

Documentation

Take a look at our documentation for more details, including how to generate HAR files, customize your scenarios, use or write plugins, etc.

Authors

• Serhii Cherniavskyi — @scherniavsky
• Thibaut Le Page — @thilp
• Brian Maher — @bmaher
• Oliwia Zaremba — @tortila

See also the list of contributors to this project.

License

This project is licensed under the MIT license — see the LICENSE.md file for details.