1 mars  1.1 <?xml version="1.0" encoding="utf-8"?>
  2           <article>
  3           
  4           <title>hatatap</title>
  5           <para>(from the sound of a north-european trying to pronounce 'http')</para>
  6           <para>hatatap is a script-based HTTP testing tool. it allows the user to write scripts in XML to navigate web sites, verify content and record results. the primary design criteria is to make the scripts easy to write and understand, while not limiting the navigation and verification capabilities.</para>
  7           
  8           <section>
  9           <title>structure:</title>
 10           <para>hatatap consists of these components -</para>
 11           <itemizedlist>
 12           <listitem><para>an XML vocabulary for web site test scripts.</para></listitem>
 13           <listitem><para>an implementation that executes these scripts, generating XML results.</para></listitem>
 14           <listitem><para>results report and analysis tools.</para></listitem>
 15           </itemizedlist>
 16           </section>
 17           
 18           <section>
 19           <title>example:</title>
 20           <para>visit google and do a search by filling in the query form and hitting submit.</para>
 21           <informalexample>
 22 mars  1.1   <programlisting>
 23           <test:script xmlns:test="urn:hatatap">
 24             <test:click url="http://www.google.com"/>
 25             <test:form>
 26               <q>what is hatatap</q>
 27               <test:submit/>
 28             </test:form>
 29             <test:verify response-code="200"/>
 30           </test:script>
 31           </programlisting>
 32           </informalexample>
 33           <para>note: this is just an example, automated access to google is not allowed!</para>
 34           </section>
 35           
 36           <section>
 37           <title>features:</title>
 38           <itemizedlist>
 39           <listitem><para>stateful navigation</para></listitem>
 40           <listitem><para>HTML forms</para></listitem>
 41           <listitem><para>nested frames</para></listitem>
 42           <listitem><para>pop-up windows</para></listitem>
 43 mars  1.1 <listitem><para>cookies and headers</para></listitem>
 44           <listitem><para>GET, POST and PUT requests</para></listitem>
 45           <listitem><para>HTTPS support</para></listitem>
 46           <listitem><para>regular expressions</para></listitem>
 47           <listitem><para>DOM-based response navigation using XPath</para></listitem>
 48           <listitem><para>XML requests and responses (eg SOAP) for testing web services</para></listitem>
 49           <listitem><para>multipart forms and file uploads</para></listitem>
 50           <listitem><para>multipart MIME XML requests</para></listitem>
 51           <listitem><para>millisecond timings and concurrency for performance testing</para></listitem>
 52           <listitem><para>XML test results</para></listitem>
 53           <listitem><para>random value functions</para></listitem>
 54           <listitem><para>extensible test scripts</para></listitem>
 55           <listitem><para>JavaScript support</para></listitem>
 56           <listitem><para>basic HTTP authentication</para></listitem>
 57           <listitem><para>HTTP proxy settings with authentication</para></listitem>
 58           <listitem><para>automatic redirect and refresh</para></listitem>
 59           <listitem><para>SSL certificate management</para></listitem>
 60           <listitem><para>domain name aliasing</para></listitem>
 61           <listitem><para>multipart MIME server responses (todo)</para></listitem>
 62           </itemizedlist>
 63           </section>
 64 mars  1.1 
 65           <section>
 66             <title>implementation:</title>
 67           <para>the test scripts are converted into o:XML code, which is executed using ObjectBox. running hatatap scripts with ObjectBox requires Java and HttpUnit.</para>
 68           <!-- hatatap o:XML code uses HttpUnit for navigation and state-keeping, Neko for parsing HTML and Rhino for JavaScript support (Tidy???) -->
 69           </section>
 70           
 71           <section>

 72 mars  1.3 <title>documentation:</title>

 73 mars  1.1 <itemizedlist>
 74           <listitem><para><ulink url="usage.html">hatatap usage</ulink></para></listitem>
 75           <listitem><para><ulink url="scripts.html">hatatap scripts</ulink></para></listitem>
 76           <listitem><para><ulink url="output.html">hatatap output</ulink></para></listitem>
 77           <listitem><para><ulink url="examples.html">hatatap examples</ulink></para></listitem>

 78 mars  1.3 </itemizedlist>
 79           </section>
 80           
 81           <section>
 82           <title>resources:</title>
 83           <itemizedlist>

 84 mars  1.1 <listitem><para><ulink url="http://download.pingdynasty.com/hatatap/">hatatap download</ulink></para></listitem>

 85 mars  1.3 <listitem><para><ulink url="http://cvs.pingdynasty.com/viewcvs/hatatap/">hatatap CVS web access</ulink></para></listitem>
 86           <listitem><para><ulink url="http://lists.pingdynasty.com/mailman/listinfo/hatatap">hatatap mailing list</ulink></para></listitem>
 87           <listitem><para><ulink url="http://bugz.pingdynasty.com/buglist.cgi?product=hatatap">hatatap bug reports</ulink></para></listitem>
 88           <listitem><para><ulink url="http://freshmeat.net/projects/hatatap">hatatap freshmeat project page</ulink></para></listitem>

 89 mars  1.1 </itemizedlist>
 90           </section>
 91           
 92           <section>
 93           <title>references:</title>
 94           <itemizedlist>
 95           <listitem><para><ulink url="http://www.o-xml.org">o:XML web site</ulink></para></listitem>
 96           <listitem><para><ulink url="http://httpunit.sourceforge.net/">HttpUnit web site</ulink></para></listitem>
 97           </itemizedlist>
 98           </section>
 99           
100           <section>
101           <title>contact:</title>
102           <para>join the hatatap mailinglist - simply follow the instructions on the <ulink url="http://lists.pingdynasty.com/mailman/listinfo/hatatap">pingdynasty listserver</ulink>. the list is the first place to get announcements and project news, and is a also a forum for hatatap users and developers.</para>
103           <para>to post to the list send an email to: hatatap at lists.pingdynasty.com.</para>
104           </section>
105           
106           <section>
107           <title>about:</title>
108           <para>hatatap was created by martin klang and is published under the <ulink url="http://www.gnu.org/licenses/licenses.html#GPL">gnu general public licence</ulink>.</para>
109           </section>
110 mars  1.1 </article>