Fitnesse and .NET - a basic tutorial

I've been working more with FIT and FITnesse, especially the .NET port. I tried to locate a quick tutorial to get someone up and running on it with a very basic project, but couldn't seem to come across one. Hopefully this will help you, or someone you love, get Fitnesse hooked into your .NET project for some Testing goodness.

Step 1 - Download and run Fitnesse

First, download the latest version of Fitnesse from http://www.fitnesse.org. The DotNet fitserver comes installed as part of the standard download.

Next, start the FIT server. Browse to it using ${browser.of.choice}. Create a page called MyFirstTest by appending MyFirstTest to your URL like: http://localhost:8080/MyFirstTest

Step 2 - Create a test page

Following the instructions from the DotNetFitServer page (http://www.fitnesse.org/FitNesse.DotNet.DotNetFitServer), edit your page and add the following lines:

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

This hooks your wiki to the FitServer runner.

Now, add a test. We'll use the normal division test. Add the following lines to your wiki page:


|Division| 
|numerator|denominator|quotient?|
|10       |2          |5        |
|12.6     |3          |4.2      |
|100      |4          |24       |

Now save it. It should look something like:



You'll notice that you don't see a "Test" button on the left hand side menu. This is because you need to tell Fitnesse this is a test page. Click on Properties, check "Test" under actions, and click "Save Properties". You'll now see the Test link show up on the left hand side menu. Click it! You should now see something like:



Which is Ok, because we haven't defined an assembly. In fact, we haven't done anything yet with .NET.

Step 3 - Create the .NET Class

So, our next step is to create a .NET project to run our code. Open Visual Studio.NET, and create a new class library project in a location that doesn't have any spaces, like C:\FitnesseTutorial.



Once that is open, delete the Class1.cs file. Next, add a reference to the fit.dll which is in the dotnet directory of your fitnesse install location. For me, that is c:\fitnesse\dotnet\fit.dll. Now add a new class, Division, which inherits from fit.ColumnFixture. Notice that is the same name as the first row from the table we put in our wiki. Your class should look like:

public class Division : fit.ColumnFixture
{
  public double numerator = 0.0;
  public double denominator = 0.0;

  public double quotient()
  {
    return 1.0;
  }
}

Save and build that project.

Step 4 - Hook Fitnesse to the .NET Class

Now we have to get the wiki to "see" our class. This is accomplished with the !path line, so edit your wiki page and add the line:

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

and save it. Now try running your test again. You should see something like:



Yay! Do a dance, or a jig. This means you have everything hooked up properly. If you are running into problems make sure:

• You don't have a namespace


• You've specified the full path to your output dll


• Your class extended fit.ColumnFixture

Step 5 - Get to Green

Now that you are here, modify your class to let this test pass:

public class Division : fit.ColumnFixture
{
  public double numerator = 0.0;
  public double denominator = 0.0;

  public double quotient()
  {
    return numerator/denominator;
  }
}

Assuming everything has worked up to this point, you should now see the following:



And that's it! You've now succesfully modified a Fitnesse page to use the DotNet fit server and talk to a project you created. Now, go forth and get busy with those customer tests!