chargelink fuzz
===============

Run protocol-family fuzzing passes and store their results as artifacts.

Reference syntax
----------------
.. code-block:: text

   usage: chargelink fuzz [-h] {run} ...

   positional arguments:
     {run}

   options:
     -h, --help  show this help message and exit

Subcommands
-----------
.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - Subcommand
     - Purpose
   * - ``run``
     - Run a fuzz pass for a protocol family.

run
---

Run a fuzz pass for a protocol family.

CLI help
~~~~~~~~
.. code-block:: text

   usage: chargelink fuzz run [-h] [--iterations ITERATIONS] [--seed SEED]
                              [--artifact-root ARTIFACT_ROOT]
                              protocol

   positional arguments:
     protocol

   options:
     -h, --help            show this help message and exit
     --iterations ITERATIONS
     --seed SEED
     --artifact-root ARTIFACT_ROOT

Production examples
~~~~~~~~~~~~~~~~~~~
**Run a short ISO 15118-2 fuzz pass.**

.. code-block:: bash

   chargelink fuzz run 'iso15118-2' --iterations 10 --artifact-root 'artifacts/fuzz/iso15118_2'

**Run an ISO 15118-20 fuzz pass with a fixed seed.**

.. code-block:: bash

   chargelink fuzz run 'iso15118-20' --iterations 20 --seed 42 --artifact-root 'artifacts/fuzz/iso15118_20'