https://github.com/zalando-incubator/transformer

A tool to transform/convert web browser sessions (HAR files) into Locust load testing scenarios (locustfile).
https://github.com/zalando-incubator/transformer

load-testing locust testing

Last synced: 1 day ago
JSON representation

A tool to transform/convert web browser sessions (HAR files) into Locust load testing scenarios (locustfile).

• Host: GitHub
• URL: https://github.com/zalando-incubator/transformer
• Owner: zalando-incubator
• License: mit
• Created: 2019-01-29T10:08:53.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-03-15T13:56:31.000Z (over 1 year ago)
• Last Synced: 2024-04-26T15:46:49.390Z (7 months ago)
• Topics: load-testing, locust, testing
• Language: Python
• Homepage: https://transformer.readthedocs.io/
• Size: 4.09 MB
• Stars: 98
• Watchers: 12
• Forks: 13
• Open Issues: 17
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-locust - transformer - A command-line tool and Python library to transform/convert web browser sessions (HAR files) into Locust load testing scenarios (locustfile). (Tools / Miscellaneous)

README

        

.. image:: docs/_static/transformer.png

   :alt: Transformer logo

   :align: center

|

.. 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

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

Install Locust to run your locustfiles::

   pip install locust

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 `_

- **Thibaut Le Page** — `@thilp `_

- **Brian Maher** — `@bmaher `_

- **Oliwia Zaremba** — `@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