Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

Empty cells should display the value of a field or property. If a cell contains "blank" or "null" then treat it as blank ("") or truly null.

public class BlankAndNullKeywordFixture : ColumnFixture
{
	public string Field;
	public bool IsFieldNull() {return Field == null;}
	public bool IsFieldBlank() {return Field != null && Field.Length == 0;}
}

public class BlankAndNullKeywordRowFixture : RowFixture
{
	public override object[] Query()
	{
		BlankAndNullKeywordColumnFixture domainObject1 = new BlankAndNullKeywordColumnFixture();
		domainObject1.Field = null;
		BlankAndNullKeywordColumnFixture domainObject2 = new BlankAndNullKeywordColumnFixture();
		domainObject2.Field = "";
		BlankAndNullKeywordColumnFixture domainObject3 = new BlankAndNullKeywordColumnFixture();
		domainObject3.Field = "joe";
		return new object[]{domainObject1, domainObject2, domainObject3};
	}

	public override Type GetTargetClass()
	{
		return typeof(BlankAndNullKeywordColumnFixture);
	}
}

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

FitNesse treats "y" or "yes" (case insensitive) as true and "n" or "no" as false for bools.

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

Use the "error" keyword when you expect an error. In this case, an error turns the cell a nice shade of green!

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

In addition to the "error" keyword, you can use the "exception" keyword to specify that an exception with a specific message and/or of a specific class is thrown.

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

This is primarily necessary to test Fitnesse itself. We need the ability to show that Fitnesse will correctly fail a test when comparing different expected and actual values, but we need that test to turn GREEN so we don't have failing tests!

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

You can save values in arbitary symbols and recall them later

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

You can easily create and load your own custom handlers.

public class IntegralRangeHandler : DefaultCellHandler
{
	public override bool Match(string searchString, Type type)
	{
		return type == typeof (int) && Regex.IsMatch(searchString, "^-?[0-9]*\\.\\.-?[0-9]*$");
	}

	public override void HandleCheck(Fixture fixture, Parse cell, Accessor accessor)
	{
		if (IsInRange(Actual(accessor, fixture), LowEnd(Args(cell)), HighEnd(Args(cell))))
		{
			fixture.Right(cell);
		}
		else
		{
			fixture.Wrong(cell, accessor.Get(fixture).ToString());
		}
	}

	private string[] Args(Parse cell)
	{
		return cell.Text().Split('.');
	}

	private int Actual(Accessor accessor, Fixture fixture)
	{
		return (int) accessor.Get(fixture);
	}

	private int HighEnd(string[] args)
	{
		return Convert.ToInt32(args[args.Length - 1]);
	}

	private int LowEnd(string[] args)
	{
		return Convert.ToInt32(args[0]);
	}

	private bool IsInRange(int actual, int low, int high)
	{
		return actual >= low && actual <= high;
	}

public class CustomFixture : ColumnFixture {
	public CustomFixture {
		CellOperation.LoadHandler(new IntegralRangeHandler());
	}
	...
}

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

You can manipulate the list of loaded cell handlers using the CellHandlerLoaderFixture.

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

You can assert that a numeric value is within a given range using the optional IntegralRangeHandler.

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

You can assert that a returned value contains a given substring, or specifically starts or ends with that substring.

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

The DotNet FitServer treats "()", "?" and "!" as indications that you are trying to access information (for fields, properties and methods).

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

An ActionFixture allows you to set values, get values and call methods repeatedly within the same fixture. The first row has one cell with "Action Fixture". The subsequent rows can have 2 or 3 cells:

public class CountFixture : Fixture {
	private int counter = 0;

	public void Count() {
		counter++;
	}

	public int Counter {
		set { counter = value; }
		get { return counter; }
	}
}

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

Column Fixtures have a virtual Execute() method which is called before the first output operation in a given row. You can override this method to handle some processing after input/before output.

	public class ExecuteExampleFixture : ColumnFixture
	{
		public int IntField;

		public override void Execute()
		{
			IntField = IntField*2;
		}
	}

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

In a row fixture or column fixture, any cells in the first row after the cell with the name of the fixture, are treated as arguments against parameters defined within the fixture.

using fit;

namespace fitnesse.acceptanceTests
{
	public class ParameterizedColumnFixture : ColumnFixture
	{
		public string StringField;
		public int IntField;
		public bool BoolField;
		public Person PersonField;

		public override void Execute()
		{
			StringField = (string) new TypeAdapter(typeof(string)).Parse(Args[0]);
			IntField = (int) new TypeAdapter(typeof(int)).Parse(Args[1]);
			BoolField = (bool) new TypeAdapter(typeof(bool)).Parse(Args[2]);
			PersonField = (Person) new TypeAdapter(typeof(Person)).Parse(Args[3]);
		}
	}

using System;
using System.Collections;
using fit;

namespace fitnesse.acceptanceTests
{
	public class ParameterizedRowFixture : RowFixture
	{
		public override object[] Query()
		{
			ArrayList list = new ArrayList();
			list.Add(new ValueWrapper(new TypeAdapter(typeof(string)).Parse(Args[0])));
			list.Add(new ValueWrapper(new TypeAdapter(typeof(int)).Parse(Args[1])));
			list.Add(new ValueWrapper(new TypeAdapter(typeof(bool)).Parse(Args[2])));
			list.Add(new ValueWrapper(new TypeAdapter(typeof(Person)).Parse(Args[3])));
			return list.ToArray();
		}

		public override Type GetTargetClass()
		{
			return typeof(ValueWrapper);
		}
	}

	public class ValueWrapper
	{
		private object value;

		public ValueWrapper(object value)
		{
			this.value = value;	
		}

		public object Value
		{
			get { return value.ToString(); }
		}
	}

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

The DotNet FitServer will look for your Fixture in any of the namespaces defined in an Import table.

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

Convenient access to table cells.

• The (row,column) coordinates are zero based,
• with (0,0) being the upper left cell.

protected abstract void DoStaticTable(int rows)

protected Parse GetCell(int row, int column)

protected String GetText(int row, int column)

protected int GetInt(int row, int column)

protected boolean Blank(int row, int column)

protected void Right(int row, int column)

protected void Wrong(int row, int column)

protected void Wrong(int row, int column, string actual)

protected void Ignore(int row, int column)

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

If you want a string value to include leading or trailing whitespace, use the syntax for escaping literals:

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

The .NET Fit server will handle arrays of primitive and custom types

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

The .NET Fit server will instantiate an instance of any class that exports a static Parse method that accepts a string and overrides ToString().

public class PeopleFixture : ColumnFixture
{
	public Person Field;

	public Person Property
	{
		get { return Field; }
		set { Field = value; }
	}

	public Person Get() {
		return Field;
	}

	public void Set(Person value) {
		Field = value;
	}
}

public class Person
{
	private string firstName;
	private string lastName;

	public static Person Parse(string name)
	{
		string[] names = name.Split(' ');
		return new Person(names[0], names[1]);
	}

	public Person(string firstName, string lastName)
	{
		this.firstName = firstName;
		this.lastName = lastName;
	}

	public override string ToString()
	{
		return firstName + " " + lastName;
	}
}

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

public enum Color
{
	Red,
	Blue
}

public class ColorInspectorFixture : RowFixture
{
	public override object[] Query()
	{
		Array colorsArray = Enum.GetValues(typeof(Color));
		ArrayList colorsList = new ArrayList(colorsArray);
		return colorsList.ToArray();
	}

	public override Type GetTargetClass()
	{
		return typeof(Color);
	}

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

The .NET Fit server will handle any numeric or boolean primitive types.

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

FitNesse will handle any type that implements a static Parse(string) method and overrides ToString().

string str = "some meaningful string representation of a domain object";
DomainObject instance = DomainObject.Parse(str);
Assert.AreEqual(str, instance.ToString());

public class Person
{
	private string firstName;
	private string lastName;

	public static Person Parse(string name)
	{
		string[] names = name.Split(' ');
		return new Person(names[0], names[1]);
	}

	public Person(string firstName, string lastName)
	{
		this.firstName = firstName;
		this.lastName = lastName;
	}

	public override string ToString()
	{
		StringBuilder builder = new StringBuilder(firstName);
		if (builder.Length > 0 && lastName != null && lastName.Length > 0)
		{
			builder.Append(" ");
		}
		return builder.Append(lastName).ToString();
	}
}

public class PersonFixture : ColumnFixture
{
	public Person Field;
	private Person propertyValue;
	private Person methodValue;

	public Person Property
	{
		set { propertyValue = value; }
		get { return propertyValue; }
	}

	public void Set(Person value)
	{
		methodValue = value;
	}

	public Person Get()
	{
		return methodValue;
	}

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

The DotNet FitServer allows you to assign values to public fields, properties or setter methods (methods that accept one argument and return void), and retrieve values from public fields, properties or getter methods (methods that return a non-void value and accept no arguments).

public class StringFixture : ColumnFixture
{
	public string Field;

	public string Property
	{
		get { return propertyValue; }
		set { propertyValue = value; }
	}

	public void Set(string value)
	{
		methodValue = value;
	}

	public string Get()
	{
		return methodValue;
	}

	private string propertyValue;
	private string methodValue;

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

The DotNet FitServer allows you to name fixtures gracefully, so you can type "add employee" rather than "namespace.AddEmployeeFixture".

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture

 Set Up: .FitNesse.DotNet.SuiteAcceptanceTests.SetUp

Import

fitnesse.acceptanceTests

The DotNet FitServer allows you to name class members (fields, properties and methods) gracefully ("calculate tax!" rather than "CalculateTax!")

 Tear Down: .FitNesse.DotNet.SuiteAcceptanceTests.TearDown

fitnesse.acceptanceTests.ResetNamespacesFixture