lilbaek/loadit

Load testing tool providing the best .NET developer experience for API performance testing.

Loadit

Load testing tool providing the best .NET developer experience for API performance testing.

⚠️ Help the project by voting for: C# language proposal.

What it is

Loadit is an open-source load testing tool built for making performance testing a productive and enjoyable experience.

See the Quick start guide for more details.

Features

• Write your tests in C#. No DSL, XML or untyped language.
• Simple and lightweight using .NET 5
• Everything as code
• CLI tool for easy testing
• Debugger included

Use case

• Load testing
  • Create load tests with high load to find performance regressions and bottlenecks
• Continues monitoring
  • Continuously monitor the performance of your environment to catch performance regressions before your users do

Install

On Linux/Mac/Windows invoke the dotnet tool command:

dotnet tool install -g loadit

Install .NET 5 first

Getting started

See the Quick start guide

Test example (Simple version - HTTP)

using Loadit;

return await Execute.Run<Http>(async (http, token) =>
{
    using var res = await http.GetAsync("https://test.loadit.dev/", token);
});

Test example (Full version with more features)

using System;
using System.Threading;
using System.Threading.Tasks;
using Loadit;

return await Execute.Run<Test2>();

public class Test2 : LoadTest
{
    private readonly Http _http;

    public Test2(Http http)
    {
        _http = http;
    }

    public override async Task Run(CancellationToken token)
    {
        using var res = await _http.GetAsync("https://test.loadit.dev/", token);
    }
}

Build from source

Loadit is written in C# targeting .NET 5. To build from source you need Git and .NET 5.

loadit's Issues

Opening a load it project in Visual Studio code make Omnisharp/Roslyn fail

Omnisharp/Roslyn does not like the dynamic include/exclude of files.
Investigate were it fails and submit a patch to omnisharp to better support loadit.

Create plugin for Rider

To get IDE integration with Jetbrains Rider a plugin will need to be created.
It should listen to document/run setting changes and update the user file.

Enhance InfluxDB integration

Automatically try and create the DB set.
Include URL stats in tags (This will require a new tag system)

More commandline arguments for run

--vus
--iterations
--duration

Should overwrite any options set in the specific test.
Duration should use some kind of parsing lib for allowing 5s, 5m etc?

Create dedicated plugin for Visual Studio

Currently the integration leverages msbuild tasks. However, it does not always get invoked leading to the code not running until a re-build is done. A real plugin should be made instead.