Tag Archives: FitNesse

FitNesse with Maven

Доброго времени суток.

Вот и завершилась, как уже кажется, безконечная череда праздников и все возвращается на “круги своя”. И как было обещано в предыдущем посте, в этот раз я поделюсь небольшими навыками с интеграции FitNesse в Maven build  lifecycle.

На первый взгляд, мне так тоже казалось, что тут нет ничего сложного и все уже есть. Проштудировав документацию + internet на предмет наличия интеграции FitNesse с Maven, я кое что нашел. Тут доступен fitnesse-maven-plugin plugin для Maven, который должен обеспечить вас возможностью выполнять ваши FitNesse тесты и создавать репорты. Но что бы выполнить тесты, FitNesse сервер должен быть запущен. Для этих целей я подходящего ничего не нашел, к тому же это все должно происходить во время выполнения билда.

Для запуска FitNesse сервера я написал plugin для Maven, исходники можно найти тут.  Далее привожу пример конфигурации плагина:

<plugin>
	<groupId>name.webdizz</groupId>
	<artifactId>maven-fitnesse-server</artifactId>
        <version>0.0.1-SNAPSHOT</version>
	<executions>
		<execution>
			<phase>pre-integration-test</phase>
			<id>start-fitnesse-server</id>
			<goals>
				<goal>start-server</goal>
			</goals>
			<configuration>
				<background>true</background>
				<port>9292</port>
				<baseDir>${basedir}/src/test</baseDir>
				<root>fitnesse</root>
				<omitUpdates>true</omitUpdates>
			</configuration>
		</execution>
	</executions>
	<dependencies>
		<dependency>
			<groupId>org.fitnesse</groupId>
			<artifactId>fitnesse</artifactId>
			<version>20091121</version>
		</dependency>
		<dependency>
			<!-- Тут идут ваши зависимости - т.е. фитнесс-тесты -->
		</dependency>
	</dependencies>
</plugin>

Запуск сервера настроен на pre-integration-test фазу, так как сами тесты выполняются в integration-test фазе.

Со стартом мы определились, теперь же нужно разобраться с запуском непосредственно тестов. Привожу свою конфигурацию плагина для выполнения тестов.

<plugin>
	<groupId>org.codehaus.mojo</groupId>
	<artifactId>fitnesse-maven-plugin</artifactId>
        <version>1.0-custom</version>
	<configuration>
		<classPathProvider>maven</classPathProvider>
		<!-- FitNesse servers list -->
		<fitnesses>
			<fitnesse>
				<hostName>localhost</hostName>
				<port>9292</port>
				<!-- The should be a suite to run all tests -->
				<pageName>FitNesse.UserGuide.SlIm.ScriptTable</pageName>
				<type>test</type>
			</fitnesse>
		</fitnesses>
	</configuration>
	<executions>
		<execution>
			<id>integration-test-fitnesse</id>
			<phase>integration-test</phase>
			<goals>
				<goal>run</goal>
			</goals>
		</execution>
	</executions>
</plugin>

Но на этапе запуска возникла проблема с выполнением тестов. Как оказалось fitnesse-maven-plugin немного устарел – последнее обновление было аж “04/06/2008” и запуск тестов валился с ошибкой неверных коммандных атрибутов. Проблема была с параметром “-html” – версия FitNesse, которую я использовал, уже не поддерживала такой аттрибут. Пришлось править код – заменил этот “-html” на “-xml” – заработало :).

На этом мне еще не удалось выполнить тест, так как появилась новая проблема – результат выполнения тестов сохранялся в виде XML, плагин же ожидает его в HTML. В итоге пришлось еще немного допилить пару классов, как результат – все заработало. Модифицированные исходники можно взять отсюда.

Теперь, используя стандартную команду

mvn clean install

будет стартовать FitNesse сервер и выполняться тесты.

На этом все, спасибо за внимание и удачного тестирования…

FitNesse или еще один подход приемочного тестирования

Как я уже писал, хотел сказать выше, но в нашем контексте это не очень соотвествует реальности, поэтому говорю ниже – с недавних пор я на новом проекте и продолжаю получать впечатления определенного характера;)

Еще одним из таковых является Acceptance Tests. В качестве движка для этого на проекте используется FitNesse – как написано на официальном сайте – “The fully integrated standalone wiki, and acceptance testing framework.“. Рассказывать что такое приемочное тестирование и FitNesse я не буду (можно пройтись по ссылкам и получить достаточное количество знаний), а хочу описать способ применения этого фреймворка на нашем проекте.

Итак, мы используем возможность, предоставляющую фреймворком – создавать Fixture для приемочных тестов в виде таблиц. Но я бы не писал об этом, если это бы это было простое использование FitNesse. Наши тесты используют так называемую Narrative идеологию. То есть каждый тест состоит из набора предусловий, действий и проверок и выглядит очень читаемым для участников проекта, не принимающих участие в разработке и тестировании – то бишь менеджмент. Ниже приведу пример теста:

| Given that | Actor | Able to do something | – Предусловие, что пользователь может что-то делать. Например залогиниться в приложение.

| When | Actor | Attempts to click on view story button | – Действие, пользователь приложение нажимает или делает что-то с элементами интерфейса.

| Then | Displayed story is | id “some id” | – Проверка, что после действий пользователь интерфейс изменился и состояние соотвествует определенным значением. В данном случае это ID истории должен быть равен “some id”.

Получается очень даже читабельно и удобно.

В нашем случае тестированию подлегает интерфейс приложения, web-приложения. Технически это выглядит следующим образом. FitNesse выполняет код Narrative фикстур, а фикстуры в свою очередь используют WebDriver для работы с DOM моделью браузера.

Одним из дополнительных способов использования такого подхода я вижу – обучающие тесты. То есть фикстуры делают паузы и подсвечивают элементы, показывают подсказки над элементами интерфейса. Прадва тут нужна возможность паузы и прокрутки тестов с нужного шага.

На жтом все. В следующем топике хочу поделиться своим опытом использования FitNesse с Maven.