Is easyb Easy?

Once you have the story written, we need to run these. easyb can be invoked via:

    * the command line
    * Ant
    * Maven
    * IntelliJ

I am a big fan of automation, so I chose the easy way;Ant.

It’s quite easy to run easyb from Ant. Here is what you need to do:

1. Define a task:

<taskdef name="easyb" classname="org.disco.easyb.ant.BehaviorRunnerTask">
		      <classpath>
		         <path refid="easyb.classpath" />
		      </classpath>
</taskdef> 

 2. Run the task:

<easyb>
	      <classpath>
	         <path refid="easyb.classpath" />
			 <pathelement path="${test.classes.dir}" />
	      	<pathelement path="${build.classes.dir}" />
	      </classpath>
	     <report location="build/story.txt" format="txtstory" />
	     <behaviors dir="stories">
	     </behaviors>
</easyb>

3. Verify the output:

Buildfile: /Users/meerasubbarao/Development/easyb-samples/build.xml
init:
run.easyb.stores:
    [easyb] easyb is preparing to process 1 file(s)
    [easyb] Running login service test story (LoginServiceTest.story)
    [easyb] Scenarios run: 3, Failures: 0, Pending: 0, Time Elapsed: 0.486 sec
    [easyb] 3 total behaviors run with no failures
    [easyb] easyb execution passed
BUILD SUCCESSFUL
Total time: 1 second

 

4. Story Printing:

In the Ant task in 2, we created a report element with its format attribute set to txtstory as follows:

<report location="build/story.txt" format="txtstory" />

If you open up the story.txt file within the build folder, it conatins a report of the scenarios run as shown below:

3 scenarios (including 0 pending) executed successfully

  Story: login service test

    scenario User enters valid credentials
      given user account already exists
      when user logins
      then the system returns a valid account

    scenario User enters invalid credentials
      given user account already exists
      when user logins with invalid password
      then  a null account should be returned

    scenario Invalid login with a null password
      given user account already exists
      when user logins with null password
      then an exception should be thrown

The report above looks like something even a 5th grader could understand, right?

If you want to use easyb from within Maven, or from the Command Line, or even IntelliJ, refer to the easyb web site which has examples for all of them.