skhvan / nbomber Goto Github PK

Very simple load testing framework for Pull and Push scenarios. It's 100% written in F# and targeting .NET Core and full .NET Framework.

To install NBomber via NuGet, run this command in NuGet package manager console:

PM> Install-Package NBomber

Documentation is located here.

• Request-response scenario
• Pub/Sub scenario
• Sequential flow
• Test runner support: [XUnit; NUnit]
• Cluster support
• Reporting: [Plain text; HTML]

• Supported runtimes: .NET Framework (4.6+), .NET Core (2.0+), Mono, CoreRT
• Supported languages: C#, F#, Visual Basic
• Supported OS: Windows, Linux, macOS

Would you like to help make NBomber even better? We keep a list of issues that are approachable for newcomers under the good-first-issue label.

The main reasons are:

• To be technology agnostic as much as possible (no dependency on any protocol: HTTP, WebSockets, SSE).
• To be able to test .NET implementation of specific driver. During testing, it was identified many times that the performance could be slightly different because of the virtual machine(.NET, Java, PHP, Js, Erlang, different settings for GC) or just quality of drivers. For example there were cases that drivers written in C++ and invoked from NodeJs app worked faster than drivers written in C#/.NET. Therefore, it does make sense to load test your app using your concrete driver and runtime.

NBomber is not really a framework but rather a foundation of building blocks which you can use to describe your test scenario, run it and get reports.

// simple C# example
var scenario = ScenarioBuilder.CreateScenario("Test MongoDb", mongoQuery);
NBomberRunner.RegisterScenarios(scenario)
             .RunInConsole();

// simple F# example
Scenario.create("Test MongoDb", [mongoQuery])
|> NBomberRunner.registerScenario
|> NBomberRunner.runInConsole