chargelink fault
================

Inject protocol faults from the supported fault catalog.

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

   usage: chargelink fault [-h] {inject} ...

   positional arguments:
     {inject}

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

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

   * - Subcommand
     - Purpose
   * - ``inject``
     - Inject one fault from the fault catalog.

inject
------

Inject one fault from the fault catalog.

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

   usage: chargelink fault inject [-h] [--protocol PROTOCOL] [--step-id STEP_ID]
                                  [--message MESSAGE] [--delay-ms DELAY_MS]
                                  [--budget-ms BUDGET_MS]
                                  [--artifact-root ARTIFACT_ROOT]
                                  {authorization_timeout,delayed_response_timeout,invalid_message_order,malformed_exi_payload,tls_negotiation_failure}

   positional arguments:
     {authorization_timeout,delayed_response_timeout,invalid_message_order,malformed_exi_payload,tls_negotiation_failure}

   options:
     -h, --help            show this help message and exit
     --protocol PROTOCOL
     --step-id STEP_ID
     --message MESSAGE
     --delay-ms DELAY_MS
     --budget-ms BUDGET_MS
     --artifact-root ARTIFACT_ROOT

Production examples
~~~~~~~~~~~~~~~~~~~
**Inject an invalid message order fault.**

.. code-block:: bash

   chargelink fault inject 'invalid_message_order' --protocol 'iso15118-20' --artifact-root 'artifacts/faults/invalid_message_order'

**Inject a delayed response timeout fault with an explicit delay.**

.. code-block:: bash

   chargelink fault inject 'delayed_response_timeout' --protocol 'iso15118-2' --delay-ms 250 --budget-ms 100 --artifact-root 'artifacts/faults/delayed_response_timeout'