Add Locust Integration for load testing

[mcumming]

Related to an existing integration?

No

Existing integration

No response

Overview

Many projects could benefit from automated load and performance testing. The Locust project provides a way to automate the testing of your web applications and api's easily.

Usage example

if (builder.Environment.IsDevelopment())
{
    builder.AddLocust("locust")
        .WithLocustDefaults()
        .WithTestsPath(Path.Combine(Directory.GetCurrentDirectory(), "..", "..", "test", "Load")
        .WithHostEndpoint(api.GetEndpoint("https"))
        .WithReference(api)
        .WaitFor(api)
        .WithExplicitStart()
    ;
}

Breaking change?

No

Alternatives

if (builder.Environment.IsDevelopment())
{
    // Add Locust load testing container
    var locustfilePath = Path.Combine(Directory.GetCurrentDirectory(), "..", "..", "test", "Load");
    builder.AddLocust("locust")
        .WithConfiguration(config =>
        {
            config.Host = api.GetEndpoint("https").Property(EndpointProperty.Url);
            config.Locustfile = locustfilePath;

            // Set sensible defaults for load testing that will be used in the start test dialog
            // Host will be dynamically determined from the API endpoint reference at runtime
            config.Users = 10;           // Default number of concurrent users
            config.SpawnRate = 2.0;      // Default spawn rate (users per second)
            config.RunTime = "300s";     // Default 5-minute test run
            config.Processes = -1;       // Use auto process count
        })
        .WithReference(api)
        .WaitFor(api)
        .WithExplicitStart()
    ;
}

Additional context

No response

Help us help you

Yes, I'd like to be assigned to work on this item

[mcumming]

@aaronpowell Was there a question I needed to answer?

[github-actions]

We have noticed this issue has not been updated within 21 days. If there is no action on this issue in the next 14 days, we will automatically close it. You can use /stale-extend to extend the window.

[aaronpowell]

@aaronpowell Was there a question I needed to answer?

Sorry @mcumming I missed your message. I don't see any questions, start a PR and we can help review there

[github-actions]

We have noticed this issue has not been updated within 21 days. If there is no action on this issue in the next 14 days, we will automatically close it. You can use /stale-extend to extend the window.

[github-actions]

This issue has been stale for 5 weeks and has been automatically closed.