Stormwind.Accuracy 0.3.0 - GRAB WHILE IT'S HOT

Hey my three readers? How have you guys been? Hope you're good! :)

It's that time again! The time when I come back from a long "non-writing" period. Usually when I'm not writing blog posts it means I'm working on something. This time I've been working in a couple things, though.

The one that matters for this post is Stormwind.Accuracy, our shiny and fancy Acceptance Testing Framework.

Release 0.3.0

After delaying this release way more than I should, I've finally reached a point where releasing it makes sense. It's stable enough (we've been using it in some projects and I received some e-mails of people using it), it has a bunch of new features, and improved speed.

First let me put here the Release Notes (which you can read here):

Release Notes - Stormwind Accuracy - Version 0.3.0.0

Bug

• [STORMWINDACCURACY-6] - I.Fill.Textbox is not compliant with the rest of the fluent interface
• [STORMWINDACCURACY-18] - The IsVisible method in WatinBrowser driver only checks for Display:None, it does not check for Visibility:Hidden
• [STORMWINDACCURACY-31] - Fill Textbox should clear it first
• [STORMWINDACCURACY-36] - Clicking an element (not just buttons) should call ie.WaitForComplete()
• [STORMWINDACCURACY-37] - DoNotSeeSpanContainsTextAction
• [STORMWINDACCURACY-44] - Register Radiobutton should resolve the Id and not force you to use the correct one
• [STORMWINDACCURACY-45] - Get.RadioButton should be using the WebFormsElementIdComparer instead of Find.ByName
• [STORMWINDACCURACY-46] - Type Text in Watin should be TypeText instead of AppendText and it should have a Thread.Sleep of 100

Improvement

• [STORMWINDACCURACY-1] - Allow extensibility for the fluent interface
• [STORMWINDACCURACY-2] - CLONE -Allow extensibility for the fluent interface
• [STORMWINDACCURACY-38] - Rename the Action base class to be AbstractAction in order to not conflict with System.Action
• [STORMWINDACCURACY-39] - Allowing for a locator pattern in order to find dynamic controls (as an example)
• [STORMWINDACCURACY-43] - Include which pages were registered if page not found in I.GoTo
• [STORMWINDACCURACY-49] - Implement ClearCache in the browser drivers and add the call to AccuracyAwareTestFixture

New Feature

• [STORMWINDACCURACY-3] - Change Actions to have an ActionResult in the OnActionExecute method instead of void
• [STORMWINDACCURACY-4] - Create the I.DoNot structure
• [STORMWINDACCURACY-5] - I.Click("Some").Image
• [STORMWINDACCURACY-7] - I.DoNot.See("Some").TextBox.ContainsText("Some Text")
• [STORMWINDACCURACY-8] - I.DoNot.See("Some").Button.IsLabeled("Some Text")
• [STORMWINDACCURACY-9] - I.DoNot.See("Some").CheckBox.IsLabeled("Some Text")
• [STORMWINDACCURACY-15] - I.Select("Users").DropDownList.ItemWithIndexOf(1)
• [STORMWINDACCURACY-16] - I.See("Some").Span
• [STORMWINDACCURACY-17] - I.DoNot.See("Some").Span
• [STORMWINDACCURACY-19] - I.See("Some").Div
• [STORMWINDACCURACY-20] - I.DoNot.See("Some").Div
• [STORMWINDACCURACY-21] - I.See("Some").Label
• [STORMWINDACCURACY-22] - I.DoNot.See("Some").Label
• [STORMWINDACCURACY-23] - I.See("Some").Span.ContainsText("Some text")
• [STORMWINDACCURACY-25] - I.See("Some").Div.ContainsText("Some text")
• [STORMWINDACCURACY-26] - I.See("Some").Label.ContainsText("some Text")
• [STORMWINDACCURACY-27] - I.See("Some").CheckBox.IsEnabled
• [STORMWINDACCURACY-29] - Add OnFailed methods for BrowserDriver
• [STORMWINDACCURACY-32] - I.See("Some Big Message").Alert.When(SomeAction)
• [STORMWINDACCURACY-35] - ClickCheckBoxAction should actually click the checkbox instead of just setting checked to some value
• [STORMWINDACCURACY-42] - Allow usage of querystrings in I.GoTo
• [STORMWINDACCURACY-48] - I.Click("Some").Link

Task

• [STORMWINDACCURACY-47] - Update Watin version

Now that you got the release notes you know what I've been working in. The most interesting bit is the last one: "Update WatiN version".

Updating WatiN Version and a Blazing Fast Accuracy

This was very interesting, since the new WatiN introduces some breaking changes, and now all the elements have interfaces (IButton, ICheckBox, you get the idea). This is a LOT better, since then I can have my BrowserDriver working with interfaces.

The main upgrade Accuracy got was in speed of execution. When changing the way WatinBrowserDriver used WatiN, I decided to do a major refactor on the way that WatinBrowserDriver was designed. This allowed me to fine tune a lot of the pain points that I had with WatiN and apparently the whole framework is more stable now (no more failing builds after the refactoring!!!).

This comes to prove that you should optimize any time you feel the pain, but ONLY THEN, never before. I might never have gotten to the point that Accuracy is now if I tried to over-optimize in the beginning.

Fluent Interface - I.Can.Do.A.Lot.Of.Stuff

Yeah, yeah, I know you guys only care about new features, so as you can see in the Tickets there are a lot of newly added syntaxes. I'm pretty sure that we are still light-years away from covering most scenarios. So if you have one scenario that we haven't covered and would like to create a new action for it, please DO, and then send us the patch! :)

Just so you guys know, here's the upcoming features for 0.4.0 (something you want might already have a ticket, so you might as well vote in it):

Release Notes - Stormwind Accuracy - Version 0.4.0.0

Bug

• [STORMWINDACCURACY-50] - Restore File functions
• [STORMWINDACCURACY-51] - Restore See Default Controls
• [STORMWINDACCURACY-52] - Restore See Alert

Improvement

• [STORMWINDACCURACY-40] - Refactor error messaging
• [STORMWINDACCURACY-41] - Show the Id of the control whenever an operation goes wrong (the resolved ID)

New Feature

• [STORMWINDACCURACY-10] - I.DoNot.See("Some").RadioButton
• [STORMWINDACCURACY-11] - I.See("Some").<ElementType>.HasStyle("SomeStyle")
• [STORMWINDACCURACY-12] - I.See("Some").<ElementType>.HasStyle("SomeStyle").WithValueOf("Some Value")
• [STORMWINDACCURACY-13] - I.DoNot.See("Some").<ElementType>.HasStyle("SomeStyle")
• [STORMWINDACCURACY-14] - I.DoNot.See("Some").<ElementType>.HasStyle("SomeStyle").WithValueOf("Some Value")
• [STORMWINDACCURACY-28] - I.See("Some").CheckBox.IsDisabled
• [STORMWINDACCURACY-30] - Implement a [BrowserDriver] attribute that takes the browser driver to use for the given test fixture
• [STORMWINDACCURACY-33] - I.See("Some Big Message").Prompt.When(SomeAction).Then(PromptAction.Ok)
• [STORMWINDACCURACY-34] - I.See("Some").<ElementType>.IsEmpty

If you don't feel like implementing something you need and would like help from us, WE ARE GAME! Just create a new ticket in JIRA and we'll try our best to help you out!

The Goodies

As usual, the release comes with updated binaries, references and source.

So, if you are using, would like to use, or just wanna see what all the fuzz is about, GO GRAB THE LATEST VERSION here!

See ya guys,