JBehave

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

Using

Canonical information for JBehave:

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

Contributing and Developing

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.

Depended-on Technologies

JDK required: 5.0 (or above) Maven required (2.2.1 or above, 3.0 or above for reporting).

Encoding

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

IDE Integration

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

Building

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

Maven Build Profiles

• 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

Maven Build Profiles used during release cycle

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

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

Example Profile Usages

Build Core and all Examples

mvn install -Pexamples

Build with Reporting and Distribution

mvn install -Preporting,distribution 

Building a Release with Maven

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

Related

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.

License

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