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.



  • 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.


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 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" />


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


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


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" />