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.

Source Distribution

har-transformer-1.2.1.tar.gz (48.5 kB view details)

Uploaded Source

Built Distribution

har_transformer-1.2.1-py3-none-any.whl (57.9 kB view details)

Uploaded Python 3

File details

Details for the file har-transformer-1.2.1.tar.gz.

File metadata

  • Download URL: har-transformer-1.2.1.tar.gz
  • Upload date:
  • Size: 48.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/0.12.14 CPython/3.7.1 Linux/4.15.0-1028-gcp

File hashes

Hashes for har-transformer-1.2.1.tar.gz
Algorithm Hash digest
SHA256 418fff287dc1e57b02c206df9a0c451e61e9f1cc10d0f3607a7abfd3c4eb7e5a
MD5 806af0a632563828e824a179c268a40d
BLAKE2b-256 a60e0c52e47d8473ddba0a801704d242a7bdbe654ba4682612487291d8e53ac0

See more details on using hashes here.

File details

Details for the file har_transformer-1.2.1-py3-none-any.whl.

File metadata

  • Download URL: har_transformer-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 57.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/0.12.14 CPython/3.7.1 Linux/4.15.0-1028-gcp

File hashes

Hashes for har_transformer-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2282cc33202530460da9ad26c4200e7669d142c383b79de298b197aab4c37002
MD5 3b8185d6771d724abc6de7608150cfc7
BLAKE2b-256 4238bc839317a9be1630a3d185c17f8788b0710036a807e48a0b922094ccb02d

See more details on using hashes here.

Supported by

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