FitNesse

Speaking at XP days in november

Michel Grootjans — Wed, 02 Sep 2009 21:14:26 GMT

Yippee, I will be speaking at the upcoming XP days in Mechelen. This is a first for me, and I'm really excited about this.

Pascal Mestdach and myself have submitted a session on Agile Acceptance testing with FitNesse. It just got approved.

My first FitNesse test

Michel Grootjans — Tue, 25 Nov 2008 21:39:16 GMT

After my previous post, I've got a FitNesse server running and configured. It's now time to write some tests. Of course, since this is a demo, this will be a simple, self-explanatory test. I'll implement a simple calculator, capable of adding two integers.

Let's write that in FitNesse. First, I'll create a test suite called "DemoSuite". So I go to http://localhost:8888/DemoSuite. Since that page doesn't exist yet, FitNesse proposes a new page. I just accept it.

Then I go to a subpage, that I call http://localhost:8888/DemoSuite.CalculatorTest. Again, FitNesse doesn't recognize this page and proposes a new one. I now replace the content with this:

!1 Let's run a simple calculator
!|CalculatorRunner|
|Arg1|Arg2|Sum?|
|0|0|0|

This gets rendered like this:

Notice what is expressed here: The test is a CalculatorRunner, that's what the top of the column says. Then I provide two arguments: Arg1=0 and Arg2=0. The Sum of both arguments should be 0. How do I tell FitNesse that the Sum should be checked? Simple: I've appended a "?" after Sum. That's enough to tell FitNesse that this is an assertion.

This test won't run of course. We now need to create a test fixture to accept the test. These are the steps to follow:

create a new project
add a reference to "fit.dll", located in the dotnet2 directory in the fit directory

There we create a new class that has to match exactly the name of our test. That will be "CalculatorRunner"

using fit;

namespace MyBlogPosts.FitNesse
{
    public class CalculatorRunner : ColumnFixture
    {
        public int Arg1 { get; set; }
        public int Arg2 { get; set; }

        public int Sum()
        {
            return Arg1 + Arg2;
        }
    }
}

Get it? Each column in the FitNesse test above matches a property or a method in my testclass.

Ok, if I now run the test, it will still fail! Why? Because it can't find the assembly it's in. Lets fix that, shall we. Hit "edit" on the testpage (or navigate to http://localhost:8888/DemoSuite.CalculatorTest?edit)

Add the following on top of the page:

!path C:\...\bin\Debug\*.dll

This will tell FitNesse to scan that directory for assemblies too. It's kinda like having a reference in a project.

On last thing before you hit "Save" (you hit it already, didn't you?). Add the following too:

!|import|
|MyBlogPosts.FitNesse|

This is the namespace to import during this test. Kind of a "using" declaration in C#. Now run the test. Did it work? For me, this is the result:

Looks OK to me. Lets expand the tests a little, shall we?

I'm editing the page like this:

!|CalculatorRunner|
|Arg1|Arg2|Sum?|
|0|0|0|
|1|1|3|
|-1|1|0|
|-100|1|-99|

Lets run it again:

Oops, looks like I missed one... but hey. That's exactly what tests are for, no?

By the way, this is what a ColumnFixture in FitNesse is. Three more testtypes coming up, plus a little refactoring.

How to set up a FitNesse server

Michel Grootjans — Mon, 24 Nov 2008 18:30:41 GMT

What is FitNesse?

Fitnesse is a tool that, if used wisely (big assumption), can turn requirements into functional tests.

Examples can elaborate requirements. Examples can become tests. Tests can verify requirements.

I'm not going to elaborate on the pro's and contra's of FitNesse. Others have done that before me.

Installing the server

Setting up FitNesse is a piece of cake. You just need to know the steps.

First of all, go download fitnesse. Extract the downloaded content to a directory of your choosing. We'll call this the "fit directory" from now on.

Go and download the .net 2.0 testrunner. Extract this content to a new subdirectory called "dotnet2" under the fit directory. The fit directory should now look like the image to the right.

Preparing the server

Since all of us are running IIS on port 80, FitNesse wont run on it. You will have to edit run.bat, and add the port number to it.

We run on port 8888. To do this, you need to edit "run.bat" like this

java -cp fitnesse.jar fitnesse.FitNesse %1 %2 %3 %4 %5 –p 8888

When you run 'run.bat', you have your server up and running. Just go to http://localhost:8888 and go "Ooooh...".

Next step is editing the base markup variables. Go to http://localhost:8888/?edit and add the following lines to the page.

!path dotnet2\*.dll

!define COMMAND_PATTERN {%m %p}
!define TEST_RUNNER {dotnet2\FitServer.exe}
!define PATH_SEPARATOR {;}

This declares some specifics for running .net tests, as well as pointing to the .net 2.0 test runner we downloaded separately.

That's it for the moment. Next will be the tests.

External links:

FitNesse	http://fitnesse.org/FitNesse.DownLoad
.net 2.0 runner	http://sourceforge.net/projects/fitnessedotnet/
Gojko's web site	http://gojko.net/ http://gojko.net/tag/fitnesse/