JBehave is a BDD framework for Java and Groovy, mirrored at Github, definitive repo at Codehaus.

Canonical information for JBehave:

1. News.
2. Documentation.
3. User mail-list
4. Jars in Maven Repositories

Please report issues, feature requests on the Codehaus issue tracker or discuss them on the dev mail-list.

Keep an eye on the Bamboo Continuous Integration server for JBehave builds.

JDK required: 5.0 (or above) Maven required (2.2.1 or above).

Configure IDE to use UTF-8 for all files Configure Maven by adding "-Dfile.encoding=UTF-8" to $MAVEN_OPTS

Maven is supported in Intellij IDEA out-of-the-box Maven is supported in Eclipse via m2eclipse plugin

The first time you run the Maven build (Maven 2.2.1 or above required), do:

mvn install -s settings.xml

After that, it is necessary to only do the following:

mvn install

• default: builds all releasable modules
• examples: builds all headless examples
• gui: builds examples that require a GUI (i.e. non-headless) mode (separated as they do not run on Bamboo CI )
• nt: no-test, builds skipping unit-test behaviors

• reporting: builds reports
• distribution: builds distribution (documentation)

Note: profiles are additive and the default profile is always active.

mvn install -Pexamples

mvn install -Preporting,distribution 

mvn release:prepare -Preporting,distribution 
mvn release:perform -Preporting,distribution

See also the jbehave-web sister project for web extensions to JBehave, and jbehave-tutorial for a decent example of JBehave testing of a web application.

See LICENSE.txt in the source root (BSD).