https://github.com/jupiter-tools/stress-test

Tools to write stress tests and benchmarks with Junit5.
https://github.com/jupiter-tools/stress-test

Last synced: 2 months ago
JSON representation

Tools to write stress tests and benchmarks with Junit5.

• Host: GitHub
• URL: https://github.com/jupiter-tools/stress-test
• Owner: jupiter-tools
• Created: 2019-02-09T09:08:07.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-02-26T21:51:26.000Z (almost 2 years ago)
• Last Synced: 2023-07-28T00:27:42.246Z (over 1 year ago)
• Language: Java
• Homepage: http://jupiter-tools.com
• Size: 957 KB
• Stars: 6
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.adoc

Awesome Lists containing this project

README

        
:toc: preamble

# StressTest

image:https://travis-ci.com/jupiter-tools/stress-test.svg?branch=master["Build Status", link="https://travis-ci.com/jupiter-tools/stress-test"]

image:https://codecov.io/gh/jupiter-tools/stress-test/branch/master/graph/badge.svg[link ="https://codecov.io/gh/jupiter-tools/stress-test"]

Tools to write stress tests and benchmarking with Junit5.

## Getting started

You need to add the following dependency:

[source, xml]

----

    com.jupiter-tools

    stress-test

    0.1

    test

----

### REST API stress testing

Let's consider a simple web application :

image:./images/tasks.png[tasks application]

Here we can create tasks and sub-tasks with titles,

estimates, and weights(position in the list).

When we create a sub-task we need to evaluate weight

and set the next value for creating the task,

because exists a unique constraint on the SubTask table in the database.

If we don't synchronize API then multiple concurrent requests

might let us to ConstraintViolationException.

In this case, StressTestRunner provide you an ability to check synchronization of your API:

[source, java]

----

@Test

void concurrentThreadsSubTasks() {

    StressTestRunner.test()

                    .mode(ExecutionMode.TASK_EXECUTOR_MODE)  <1>

                    .timeout(5, TimeUnit.SECONDS) <2>

                    .threads(4)   <3>

                    .iterations(100)  <4>

                    .run(this::createSubTaskSingleTest); <5>

}

private void createSubTaskSingleTest() throws Exception {

    SubTask subTask = MvcRequester.on(mockMvc)

                                  .to("tasks/{id}/subtasks/create", TASK_ID)

                                  .withParam("title", "Make it safe!")

                                  .withParam("estimate", 30)

                                  .post()

                                  .expectStatus(HttpStatus.CREATED)

                                  .returnAs(SubTask.class);

    assertThat(subTask).isNotNull()

                       .extracting(SubTask::getTitle, SubTask::getEstimate)

                       .contains("Make it safe!", 30);

}

----

<1> test runner strategy (ThreadPoolExecutor based or Parallel Stream based)

<2> time limit for tests passing

<3> set threads count

<4> set count of runs.

<5> code of the one test iteration

## JUnit5 Benchmark Extension

When you need to compare a performance of multiple methods, you can use

TestBenchmark extension:

[source, java]

----

@EnableTestBenchmark  <1>

class EnableTestBenchmarkTest {

    @Fast <2>

    @TestBenchmark(measurementIterations = 15, warmupIterations = 10)  <3>

    void testFast() throws InterruptedException {

        Thread.sleep(30);

    }

    @TestBenchmark(measurementIterations = 15, warmupIterations = 10)

    void testSlow() throws InterruptedException {

        Thread.sleep(100);

    }

}

----

<1> enable test extension

<2> mark as Fast method which you expect will be faster

<3> set measurement and warm-up iterations

Example of the benchmarking:

image:./images/benchmark.gif[live benchmarking]

If you measuring very fast methods (less than one milliseconds)

you can use `MeasureUnit` annotation to set a unit of measurement profiling:

[source, java]

----

@EnableTestBenchmark

@MeasureUnit(unit = TimeUnit.NANOSECONDS)

class BenchmarkExtensionMeasureUnitTest {

    @Fast

    @TestBenchmark(measurementIterations = 15, warmupIterations = 10)

    void testFast() {

    }

    @TestBenchmark(measurementIterations = 15, warmupIterations = 10)

    void testSlow() throws InterruptedException {

        Thread.sleep(1);

    }

}

----