Skip to main content

A tool to convert HAR files into a locustfile.

Project description

.. raw:: html

<div align="center">

.. image:: docs/_static/transformer.png
:alt: Transformer logo
:align: center

.. raw:: html

<br>

.. image:: https://travis-ci.org/zalando-incubator/Transformer.svg?branch=master
:alt: travis-ci status badge
:target: https://travis-ci.org/zalando-incubator/Transformer

.. image:: https://badgen.net/pypi/v/har-transformer
:alt: pypi version badge
:target: https://pypi.org/project/har-transformer

.. image:: https://api.codacy.com/project/badge/Grade/10b3feb4e4814429bf288b87443a6c72
:alt: code quality badge
:target: https://www.codacy.com/app/thilp/Transformer

.. image:: https://api.codacy.com/project/badge/Coverage/10b3feb4e4814429bf288b87443a6c72
:alt: test coverage badge
:target: https://www.codacy.com/app/thilp/Transformer

.. image:: https://badgen.net/badge/code%20style/black/000
:alt: Code style: Black
:target: https://github.com/ambv/black

.. raw:: html

</div>

Transformer
***********

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

.. _HAR: https://en.wikipedia.org/wiki/.har
.. _Locust: https://locust.io/

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

.. contents::
:local:

Installation
============

Install from PyPI::

pip install har-transformer

Usage
=====

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

Command-line
------------

.. code:: bash

transformer my_har_files_directory/ >locustfile.py

Library
-------

.. code:: python

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.

.. _documentation: https://transformer.readthedocs.io/

Authors
=======

- **Serhii Cherniavskyi** — `@scherniavsky <https://github.com/scherniavsky>`_

- **Thibaut Le Page** — `@thilp <https://github.com/thilp>`_

- **Brian Maher** — `@bmaher <https://github.com/bmaher>`_

- **Oliwia Zaremba** — `@tortila <https://github.com/tortila>`_

See also the list of contributors_ to this project.

.. _contributors: https://transformer.readthedocs.io/en/latest/Contributors.html

License
=======

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

.. _LICENSE.md: https://github.com/zalando-incubator/Transformer/blob/master
/LICENSE.md

Project details


Download files

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

Files for har-transformer, version 1.0.2.dev20190305144206
Filename, size File type Python version Upload date Hashes
Filename, size har_transformer-1.0.2.dev20190305144206-py3-none-any.whl (188.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size har-transformer-1.0.2.dev20190305144206.tar.gz (47.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page