Cucumber-JVM is a pure Java implementation of Cucumber that supports the following programming languages:
- Python (Jython interpreter)
- Ruby (JRuby interpreter)
Cucumber-JVM provides the following mechanisms for running Cucumber Features:
- Command Line
- JUnit (via IDE, Maven, Ant or anything that knows how to run JUnit)
Cucumber-JVM also integrates with the following Dependency Injection containers:
Downloading / Installation
<repository> <id>sonatype-snapshots</id> <url>https://oss.sonatype.org/content/repositories/snapshots</url> </repository>
Now you can grab jars with the following dependency in your POM:
<dependency> <groupId>info.cukes</groupId> <artifactId>cucumber-core</artifactId> <version>1.0.0-SNAPSHOT</version> </dependency>
If you are not using Maven you can download the SNAPSHOT jars manually from https://oss.sonatype.org/content/repositories/snapshots/info/cukes/
<ibiblio name="sonatype-snapshots" m2compatible="true" usepoms="true" pattern="[organisation]/[module]/[revision]/[artifact]-[revision](-[classifier]).[ext]" root="https://oss.sonatype.org/content/repositories/snapshots"/>
<dependency org="info.cukes" name="cucumber-core" rev="1.0.0-SNAPSHOT" changing="true"/>
There isn't any documentation yet apart from API docs. Documentation will be published when the first release candidate for 1.0.0 is ready. If you are adventurous, check out the examples, read the code and ask specific questions on the Cucumber mailing list.
- http://cukes.info/cucumber/jvm/api/1.0.0-SNAPSHOT/apidocs/ (URL subject to change)
You will find an example in Git under examples/java-calculator. You should be able to run
basic_arithmetic.feature by running the
cucumber.examples.java.calculator.basic_arithmetic_Test JUnit test from your IDE. -Or simply by running it with Maven:
mvn clean install -P examples once to build it all. Then
cd examples/java-calculator followed by
mvn test each time you make a change. Try to make the feature fail!
To hack on Cucumber-JVM you need a JDK, Maven and Git to get the code. You also need to set your IDE/text editor to use:
- UTF-8 file encoding
- LF (UNIX) line endings
- 4 Space indent (no tabs)
- 2 Space indent (no tabs)
Please do not add @author tags - this project embraces collective code ownership. If you want to know who wrote some code, look in git. When you are done, send a pull request. If we get a pull request where an entire file is changed because of insignificant whitespace changes we cannot see what you have changed, and your contribution might get rejected.
You'll need Ant installed
export ANT_OPTS=-XX:MaxPermSize=128m ant clean publish-artifacts
- Sign jars:
- Upload jars
- Tag git
- Fix stepdefs.json (it's empty)
- Run the cucumber-tck tests (still use maven, to test it works with maven)
- Doc how to set up IDEA
Running cross-platform Cucumber features
All Cucumber implementations (cucumber-ruby, cucumber-jvm, cucumber-js) share a common set of Cucumber features to ensure all implementations support the same basic features. To run these you need to clone the cucumber-tck repo into your cucumber-jvm working copy:
git submodule update --init
Now you can run the cross-platform Cucumber features:
gem install bundler bundle install rake
StepDefinition APIs in all of Gherkin's supported i18n languages are generated using Ruby.
The i18n Java annotations (except English) are not added to the Git repo because Git on both OS X and Windows handles UTF-8 file names badly.
In order to compile
cucumber-java with all I18n annotations, you have to generate them yourself.
With Ruby installed and on your path, install some gems that are needed for code generation:
Try this first
gem install bundler bundle install
Now you can generate the code:
On Windows it might be tricky to install all the gems. (The listed gems are used for both code generation and for running the cross-platform features). If you only want to generate code, you can get away with:
gem install gherkin rake generate SKIP_BUNDLER=true
Below are some common problems you might encounter while hacking on Cucumber-JVM - and solutions.
IntelliJ Idea fails to compile the generated I18n Java annotations
This can be solved by changing the Compiler settings:
Preferences -> Compiler -> Java Compiler:
- Use compiler:
Javac in-process (Java6+ only)
- Additional command line parameters:
-target 1.6 -source 1.6 -encoding UTF-8
Fork the repository on Github, clone it and send a pull request when you have fixed something. Please commit each feature/bugfix on a separate branch as this makes it easier for us to decide what to merge and what not to merge.
- Reports exception when Before hook fails
- Skips steps when before hook fails