Imprimatur


Imprimatur is designed to be the simplest web application functional testing tool that could possibly work. It sends HTTP requests to the application, and then validates the responses using regular expressions. The tests are written in an XML file. Imprimatur supports:
  • GET, POST, PUT, HEAD and DELETE methods.
  • HTTP authentication.
  • Setting and checking of HTTP headers.
  • File uploads.
  • HTTPS.

News


Installation

  • Download the latest version of Imprimatur.
  • Imprimatur is a Java application so make sure you have a recent version of Java installed.
  • Unpack the Imprimatur archive file.

Running


Imprimatur is a command line application. In the imprimatur folder type:

java -jar imprimatur.jar tests/google.xml

This should perform a short test on the google.com homepage.

Writing test scripts


To get started, it's probably best to copy one of the sample scripts below and then modify it.

The reference for the XML scripts is the imprimatur-009.dtd. For writing regular expressions there's the reqular expression reference and various tutorials.

Running within Ant


As a command line java app, Imprimatur can be run within Ant with something like:
<java jar="${imprimatur.jar}" fork="true" failonerror="true">
<arg value="${test.home}/imprimatur1.xml" />
</java>

Feedback


Please email me, Tony Locke <email.png> with any comments. Or if you prefer, visit our SourceForge project page.
stamp.png

Contribute


I use Eclipse for Ubuntu with the EGit plugin to work with Imprimatur. Tomcat7 is used for testing. The build.properties file in the home directory and used by Ant, should contain something like:

manager.username=xxx
manager.password=xxx

Here's a sample tomcat-users.xml:

<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<user username="admin" password="admin" roles="manager-gui,manager-script"/>
 
<role rolename="darkness-reader"/>
<user username="conrad" password="kurtz" roles="darkness-reader" />