Gatling FTP Plugin

A Gatling plugin that adds FTP protocol support for performance testing (compatible with Gatling 3.15.x).

Getting Started

This plugin is currently available for Scala 2.13, Java 17, Kotlin

You may add plugin as dependency in project with your tests.

SBT

Write this to your build.sbt:

libraryDependencies += "io.github.fherbreteau" %% "gatling-ftp" % "<version>" % Test

Maven

Write this to your dependencies block in your pom.xml:

<dependency>
    <groupId>io.github.fherbreteau</groupId>
    <artifactId>gatling-ftp</artifactId>
    <version>${version}</version>
    <scope>test</scope>
</dependency>

Gradle

Write this to your dependencies block in your build.gradle:

gatling("io.github.fherbreteau:gatling-ftp:<version>")

Example Scenarios

• Scala -- Sample Simulations
• Java -- Sample Simulations
• Kotlin -- Sample Simulations

Testing

Unit tests use ScalaTest with Mockito for mocking the Apache Commons Net FTPClient. Integration tests use MockFtpServer to verify operations against an embedded FTP server.

Run the unit and integration tests with Maven:

mvn -B test

To run the example simulations against a real FTP server, start the Docker container first:

docker-compose up -d
mvn -B gatling:test
docker compose down