Metadata-Version: 2.1
Name: har-transformer
Version: 3.0.0rc1
Summary: A tool to convert HAR files into a locustfile.
Home-page: https://transformer.readthedocs.io/
License: MIT
Keywords: load testing,locust,har
Author: Serhii Cherniavskyi
Author-email: serhii.cherniavskyi@zalando.de
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Testing :: Traffic Generation
Provides-Extra: docs
Requires-Dist: chevron (>=0.13,<0.14)
Requires-Dist: docopt (>=0.6.2,<0.7.0)
Requires-Dist: ecological (>=1.6,<2.0)
Requires-Dist: pendulum (>=2.0,<3.0)
Requires-Dist: requests (>=2.21)
Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
Requires-Dist: sphinx-issues; extra == "docs"
Requires-Dist: sphinx; extra == "docs"
Project-URL: Repository, https://github.com/zalando-incubator/transformer
Description-Content-Type: text/x-rst


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

