Skip to content
This repository

Executable specifications for Java

README.md

Build Status

Overview

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.4 and Xtend 2.4. 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/.

Examples

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
      calculator.enter(args.first)
    And I have entered "70" into the calculator
    When I press "add"
      calculator.press(args.first)
    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.pop
      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.4 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

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

mvn clean install
Something went wrong with that request. Please try again.