FitNesse.NET tips and tricks Gojko Adzic

FitNesse.NET allows you to save lots of time by writing fixture code efficiently and by not writing fixture code when you don’t really need it.

Simple Sample Domain

Example: define + list links Define Links NameUrl Googlehttp:// Yahoohttp:// List Links NameUrl Googlehttp:// Yahoohttp://

Automatic collection wrapping Instead of creating your own row/array fixtures, use a flow fixture and just return an array out from a method - it gets mapped to array fixture Works in do/sequence flow mode Works on IEnumerable

Automatic collection wrapping public class FlowCollections: DoFixture { private ILinkRepository repo = new MemoryLinkRepository(); public Fixture DefineLinks() { return new LinkSetupFixture(repo); } public IEnumerable ListLinks() { return repo.FindAll(); }

System under test If the call does not map to anything in the fixture, flow fixtures check a “system under test” Set the system under test and map domain service/repository/factory calls directly to tables Perhaps best on Sequence fixtures

System under test public class FlowSystemUnderTest : DoFixture { private ILinkRepository repo = new MemoryLinkRepository(); public FlowSystemUnderTest() { SetSystemUnderTest(repo); } public Fixture DefineLinks() { return new LinkSetupFixture(repo); }

System under test info.fitnesse.FlowSystemUnderTest Define Links NameUrl Googlehttp:// Yahoohttp:// Find All NameUrl Googlehttp:// Yahoohttp://

With keyword Set the system under test from the test page |with|method call| |with|new|class name| |with|new|class name|constr arg1|arg2|…| Use this to switch between systems under test dynamically

With Keyword info.fitnesse.WithSystemUnderTest withnewinfo.fitnesse.MemoryLinkRepository Define Links NameUrl Googlehttp:// Yahoohttp:// Find All NameUrl Googlehttp:// Yahoohttp://

With Keyword public class WithSystemUnderTest : DoFixture { public Fixture DefineLinks() { return new LinkSetupFixture((ILinkRepository) this.mySystemUnderTest); }

Naming SUTs |name|foo|with|… with phrase| |name|bar|with|… with phrase| |use|foo| … |use|bar|

Naming SUTs namegooglewithnewLinkGooglehttp:// nameyahoowithnewLinkYahoohttp:// usegoogle checkvalidtrue useyahoo checkvalidtrue

System under test in other fixtures From recently, you can use system under test for other fixtures as well! Eg for a column fixture as a much more flexible target object! Allows you to define only test-specific methods in fixtures!

Column fixture SUT public class LinkValidityCheck:fit.ColumnFixture { public LinkValidityCheck() { SetSystemUnderTest(new Link()); } public String comment; }

Column fixture SUT Link validity check nameurlvalid?comment googlehttp:// set, correct blankhttp:// not set googleblankfalseurl not set googlewww.google.comfalseurl not in correct format

Alternating system under test Switch SUT in runtime to load up other objects Use Reset() to clean up before new row This is a very efficient way to implement a subset fixture for huge data sets

Alternating SUT Define Links NameUrlId? Googlehttp:// Yahoohttp:// Microsofthttp:// Check Links IdName?Url? <<googleGooglehttp://

Alternating SUT public class LinkCheckFixture : ColumnFixture { private ILinkRepository repo; public LinkCheckFixture(ILinkRepository repo) { this.repo = repo; } public int Id { set { SetSystemUnderTest(repo.FindById(value));} }

Automatic domain object wrapping Don’t use a fixture – use your domain class in the table header FitNesse.NET automatically creates a DoFixture and sets the system under test to a new instance of your class

Cell Handlers Tell FitNesse how to interpret a set of cells –Match by cell content –Match by object type Extend AbstractCellHandler Load by using Cell Handler Loader loadSavedFixtureHandlerFitLibrary loadSavedFixtureHandlerFit

Example: Regex public class RegExHandler: AbstractCellHandler { public override bool Match(string searchString, System.Type type) { return searchString.StartsWith("/") && searchString.EndsWith("/") && typeof(string).Equals(type); } public override bool HandleEvaluate(Fixture fixture, Parse cell, Accessor accessor) { object actualValue=accessor.Get(fixture); if (actualValue == null) return false; Regex expected =new Regex(cell.Text.Substring(1,cell.Text.Length-2)); return expected.IsMatch(actualValue.ToString()); }

Regex to the rescue Named SUTs can’t be used as parameters –This isn’t possible: –|name|google|with|new|…| –|save|google| But that would be really cool! So let’s implement it using a cell handler!

Saved fixture handler public class SavedFixtureHandler:AbstractCellHandler { public override bool Match(string searchString, System.Type type) { return searchString.StartsWith("\"") && searchString.EndsWith("\""); } public override void HandleInput(Fixture fixture, Parse cell, Accessor accessor) { String innerText=cell.Text.Substring(1, cell.Text.Length-2); accessor.Set(fixture, ((FlowFixtureBase) fixture).NamedFixture(innerText)); }

We can now use it like this! namegooglewithnewLinkGooglehttp:// nameyahoowithnewLinkYahoohttp:// save"google" save"yahoo" find all nameurl Googlehttp:// Yahoohttp:// info.fitnesse.MemoryLinkRepository

Suite config files Extract all technical information into a file Keep test pages nice and tidy, easily readable Set up with !define COMMAND_PATTERN=%m –c mySuite.config %p See all options on

Suite config files D:\work\netfit2\fixtures\fixtures\bin\debug\fixtures.dll info.fitnesse info.fitnesse.SavedFixtureHandler info.fitnesse.SavedFixtureHandler

Now we can do this! Memory Link Repository namegooglewithnewLinkGooglehttp:// nameyahoowithnewLinkYahoohttp:// save"google" save"yahoo" find all nameurl Googlehttp:// Yahoohttp://

We can write tests with no fixture code! But “can” is not the same as “should”!

FitNesse Pages tell us “what” Fixtures tell us “how”

Bridging the Communication Gap learn how to improve communication between business people and software implementation teams find out how to build a shared and consistent understanding of the domain in your team learn how to apply agile acceptance testing to produce software genuinely fit for purpose discover how agile acceptance testing affects your work whether you are a programmer, business analyst or a tester learn how to build in quality into software projects from the start, rather than control it later

Upcoming events Games in the cloud: March 5 th Next.NET event: March 23rd Web Tech Exchange: May 11-15

Where next?