Chaos Toolkit Extension Template

Chaos Toolkit extension to manage lueur network proxy.

Install

This package requires Python 3.9+

To be used from your experiment, this package must be installed in the Python environment where chaostoolkit already lives.

pip install chaostoolkit-lueur

Usage

{
    "title": "Increase latency by 150ms",
    "description": "n/a",
    "method": [
        {
            "type": "action",
            "name": "run lueur proxy with a normal distribution latency",
            "provider": {
                "type": "python",
                "module": "chaoslueur.actions",
                "func": "run_proxy",
                "arguments": {
                    "proxy_args": "--with-latency --latency-mean 300 --latency-stddev 50 --upstream '*'"
                }
            },
            "background": true
        },
        {
            "type": "action",
            "name": "query remote upstream",
            "provider": {
                "type": "process",
                "path": "curl",
                "arguments": "-I -o /dev/null -s -w \"Connected IP: %{remote_ip}\nTotal time: %{time_total}s\" -x http://localhost:8080 https://www.google.com"
            }
        },
        {
            "type": "action",
            "name": "stop proxy",
            "provider": {
                "type": "python",
                "module": "chaoslueur.actions",
                "func": "stop_proxy"
            }
       }
    ]
}

That's it!

Please explore the code to see existing actions.

Test

To run the tests for the project execute the following:

pdm run test

Formatting and Linting

We use ruff to both lint and format this repositories code.

Before raising a Pull Request, we recommend you run formatting against your code with:

pdm run format

This will automatically format any code that doesn't adhere to the formatting standards.

As some things are not picked up by the formatting, we also recommend you run:

pdm run lint

To ensure that any unused import statements/strings that are too long, etc. are also picked up.

Contribute

If you wish to contribute more functions to this package, you are more than welcome to do so. Please, fork this project, make your changes following the usual code style, sprinkling with tests and submit a PR for review.

To contribute to this project, you will also need to install pdm.

Metadata

Release files for chaostoolkit-lueur 0.13.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chaostoolkit-lueur 0.13.3
File	Size	Uploaded
chaostoolkit_lueur-0.13.3.tar.gz	8.5 kB	Mar 28, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for chaostoolkit-lueur 0.13.3
File	Interpreter	ABI	Platform	Reset
chaostoolkit_lueur-0.13.3-py3-none-any.whl 9.1 kB Mar 28, 2025	Python 3	none	any	Details

Total release size: 17.7 kB

Release files / chaostoolkit_lueur-0.13.3.tar.gz

Download URL	chaostoolkit_lueur-0.13.3.tar.gz
Size	8.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`4fc9c12629c429fabc166badba259d1683a15c8885d8c385d28913014cc3eda2`
BLAKE2b-256 checksum How to use checksums	`a96992d051df6a2e94ea7830708f756f7b99eddbea3c426bf793747b7b2ab804`
Upload date	Mar 28, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/chaostoolkit-incubator/chaostoolkit-lueur
Publishing commit: github.com/chaostoolkit-incubator/chaostoolkit-lueur/tree/6ad90b74156149878d242f00466581ae20f2335e

Workflow

Publishing configuration: github.com/chaostoolkit-incubator/chaostoolkit-lueur/blob/6ad90b74156149878d242f00466581ae20f2335e/.github/workflows/release.yaml
Publishing logs: github.com/chaostoolkit-incubator/chaostoolkit-lueur/actions/runs/14131029518/attempts/1

Artifact

Subject: chaostoolkit_lueur-0.13.3.tar.gz
SHA-256 checksum: 4fc9c12629c429fabc166badba259d1683a15c8885d8c385d28913014cc3eda2 Verifying attestations

Release files / chaostoolkit_lueur-0.13.3-py3-none-any.whl

Download URL	chaostoolkit_lueur-0.13.3-py3-none-any.whl
Size	9.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`135d3d2ac881e07440eaf25222ca71895f2a3c7dc5841388bb6f0e86069d6ec8`
BLAKE2b-256 checksum How to use checksums	`fff245d22861aa95ed09b70a6f420a49367189ac32ca4615dd277266dee98625`
Upload date	Mar 28, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/chaostoolkit-incubator/chaostoolkit-lueur
Publishing commit: github.com/chaostoolkit-incubator/chaostoolkit-lueur/tree/6ad90b74156149878d242f00466581ae20f2335e

Workflow

Publishing configuration: github.com/chaostoolkit-incubator/chaostoolkit-lueur/blob/6ad90b74156149878d242f00466581ae20f2335e/.github/workflows/release.yaml
Publishing logs: github.com/chaostoolkit-incubator/chaostoolkit-lueur/actions/runs/14131029518/attempts/1

Artifact

Subject: chaostoolkit_lueur-0.13.3-py3-none-any.whl
SHA-256 checksum: 135d3d2ac881e07440eaf25222ca71895f2a3c7dc5841388bb6f0e86069d6ec8 Verifying attestations