Executable specifications for Java
Java GAP HTML Xtend Python JavaScript Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
examples update junit runner plugin Nov 18, 2014
features begin migration to xtend 2.7 Sep 2, 2014
plugins update junit runner plugin Nov 18, 2014
release_notes consolidate release notes into single file Jul 16, 2013
releng update junit runner plugin Nov 18, 2014
tests update junit runner plugin Nov 18, 2014
website fix classpath Oct 28, 2014
.gitignore regenerate spec, feature and suite lang with latest xtend features Jun 19, 2014
README.md Fix markdown markup for headings Apr 24, 2018
generate-reports.sh improved reporting and simplified plugin invocation Nov 26, 2012
pom.xml new version 1.1.0-SNAPSHOT Jul 14, 2014
prepare-release.sh manually push tags Jul 14, 2014
release.sh rename org.jnario.maven.standalone -> org.jnario.standalone Jul 14, 2014
release_notes.md update release notes Jul 14, 2014
test.sh new version 0.5.0 Apr 28, 2013


Build Status


Jnario is a framework for writing executable specifications for Java. It provides all the goodness of Xtend while being specifically tailored to writing acceptance and unit tests. It is easy to integrate as Jnario specifications are compiled to plain Java Junit tests. Head over to Jnario.org for more information.

See the release notes for the current version.

Dependencies & Installation

  • Jnario requires at least Eclipse 3.6 with Xtext 2.6 and Xtend 2.6. You can install both from this update site http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/.
  • The latest snapshot verion of Jnario can be installed from the following update site http://www.jnario.org/updates/snapshot/.


Acceptance Specification

Feature: Addition

  In order to avoid silly mistakes
  As a math idiot
  I want to be told the sum of two numbers
  Scenario: Add two numbers
    Calculator calculator = new Calculator()
    Given I have entered "50" into the calculator
    And I have entered "70" into the calculator
    When I press "add"
    Then the result should be "120" on the screen
      calculator.result => args.first

Unit Specifications

package example

import java.util.Stack
import java.util.EmptyStackException

describe Stack{
  context "empty stack"{
    fact subject.size should be 0
    fact subject.pop throws EmptyStackException
  context "one element"{ 
    before subject.add("element")
    fact subject.size should be 1
    fact "pop decreases size"{
      subject.size => 0 
    fact "pop removes last element"{
      subject.pop => "element"
      subject.contains("element") => true

Setting up a development environment

  • If you haven't got an Eclipse installation, download the Xtend Distribution.
  • Install the latest Xtext 2.6.1 release from: http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/ (this is not required if you have downloaded the Xtend distribution).
  • Install the latest Jnario snapshot: http://www.jnario.org/updates/snapshot/.
  • Clone the jnario repository:
$ git clone git://github.com/bmwcarit/Jnario.git
  • Start Eclipse and import all projects from jnario/* into your Eclipse workspace
  • Open the target definition tools/org.jnario.target/juno.target and click Set as Target Plattform in the upper right corner
  • If you want to change the grammar import org.eclipse.xtend.core and org.eclipse.xtext.xbase into your workspace via import->Plug-in Development->Plug-ins and Fragments with Import As->Projects with source folder. This is necessary for the workflow to find the custom source classes of Xtend and Xbase.


Build with Maven 3 and Tycho. Run the following command in the repository root:

mvn clean install