Development Environment - mathieuboniface/gatling GitHub Wiki

As we chose to push Gatling on Github, it is likely that other people will want to see how we did it, and hopefully help us; the aim of this page is to ease the "get-into-developing-gatling" process. To know how you can contribute to Gatling, visit Contributing.

• Java Development Kit 6.
• Git 1.7 or later.
• Eclipse 4.2 (Juno).
• Scala IDE plugin: http://scala-ide.org. Beware of grabbing the right Scala version: Gatling 1 uses Scala 2.9 while Gatling 2 uses Scala 2.10.
• Maven Integration for Scala Plugin (grab m2e AND m2e-scala there). Update Site: http://alchim31.free.fr/m2e-scala/update-site

You might want to properly tune the JVM in eclipse.ini to get eclipse run properly. Here's a set up example:

-Xmn256m
-Xmx2048m
-Xss2m
-XX:MaxPermSize=256m
-XX:+HeapDumpOnOutOfMemoryError
-XX:+AggressiveOpts
-XX:+OptimizeStringConcat
-XX:+UseFastAccessorMethods
-XX:+UseParNewGC
-XX:+UseConcMarkSweepGC
-XX:+CMSParallelRemarkEnabled
-XX:SurvivorRatio=8
-XX:MaxTenuringThreshold=1
-XX:CMSInitiatingOccupancyFraction=75
-XX:+UseCMSInitiatingOccupancyOnly
-XX:+CMSClassUnloadingEnabled

Once every software is installed, you can import Gatling project into Eclipse. Doing so is really easy:

1. Open Eclipse
2. Click on File > Import... > Maven > Existing Maven Project
3. Select gatling folder
4. Finish the import
5. Repeat the process for gatling-highcharts
6. All Done !

Gatling is made to run as a standalone program, thus most users will want to download a tarball containing all the binaries required to execute Gatling.

As a developer, you'll want to run Gatling from Eclipse, sparing the long process of tarball creation. These are the steps required:

1. Build Gatling once via command line: mvn clean install
2. Build Gatling-highcharts via command line: mvn clean install
3. In Eclipse, create a new Maven project, from the archetype named gatling-highcharts-maven-archetype
4. The created project should have all the gatling modules as dependencies.

• If not, enable workspace resolution in the project's Maven configuration.

5. Now you can run Gatling via two files:

• Engine.scala
• Recorder.scala

6. Your project should now have the following structure :

Another set of tools can be appreciated if you want to test things and, for example, package Gatling as an archive.

• Scala. Installing Scala on your computer will allow you to use the REPL. This is the Scala interpreter, you can use it to test pieces of code and so on.
• Maven. Having the maven integration plugin in Eclipse is enough to import the project and manage dependencies; but if you want to package Gatling or test that the mvn clean install process actually works, you'll need it installed on your computer as well.
• Git tools. To help you working with Git, you can use different software.
  • EGit is an integration of Git in Eclipse, it is included in Eclipse Juno's Update Site.
  • There are also tools from Github for Windows and Mac OS X.