You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by di...@apache.org on 2002/01/22 13:55:29 UTC
cvs commit: jakarta-commons/latka/doc proposal.xml
dion 02/01/22 04:55:29
Added: latka/doc proposal.xml
Log:
Conversion from html
Revision Changes Path
1.1 jakarta-commons/latka/doc/proposal.xml
Index: proposal.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<!--
Author: Morgan Delagrange
Author: Doug Sale
Author: Rodney Waldhoff
Version: $Id: proposal.xml,v 1.1 2002/01/22 12:55:29 dion Exp $
-->
<chapter id="proposal">
<chapterinfo>
<authorgroup>
<author><firstname>Morgan</firstname><surname>Delagrange</surname>
<affiliation><address><email>mdelagra@yahoo.com</email></address></affiliation>
</author>
<author><firstname>Doug</firstname><surname>Sale</surname>
<affiliation><address><email>dsale@us.britannica.com</email></address></affiliation>
</author>
<author><firstname>Rodney</firstname><surname>Waldhoff</surname>
<affiliation><address><email>rwaldhof@us.britannica.com</email></address></affiliation>
</author>
</authorgroup>
</chapterinfo>
<title>Proposal for Latka Package</title>
<section>
<title>(0) Rationale</title>
<para>Testing websites is a pain. Many regression tests for a website can
be verified automatically, speeding up the quality assurance process and
allowing the engineers to focus on the more important issues. Additionally
developers may want to monitor their development, QA and production environment,
so that they can be sure that everything is running as they expect.</para>
<para>Latka is an HTTP functional testing suite for automated QA. Latka
suites are XML documents, which can be written and/or modified without writing
Java code. Latka tests can be created quickly and modified easily, even by
engineers without Java experience.</para>
</section>
<section>
<title>(1) Scope of the Package</title>
<para>The <emphasis>Latka</emphasis> project shall develop an
XML-based syntax for HTTP-based functional tests. Latka will support, at the
least, SSL communication and cookies.</para>
<para>Included within Latka are classes that simulate a user agent.
While the backend HTTP communication is handled by the HttpClient Commons
component, the Latka interfaces simulate some of the behaviour of an actual web
browser, including automatically passing cookies from request to request in a
session. We hope to integrate these classes into a "useragent" package in
HttpClient at some point, since they are a useful abstraction and not tied to
Latka in any way, nor do they modify the core HttpClient classes.</para>
<para>Latka also includes several validations that can be performed
on the HTTP responses, including checking the status code, byte length, or
request timing. In addition you will be able to customize Latka with your own
validators by writing a couple of simple classes.</para>
</section>
<section>
<title>(1.5) Interaction With Other Packages</title>
<para><emphasis>Latka</emphasis> relies on:</para>
<itemizedlist>
<listitem><para>Java Development Kit (Version 1.3 or later)</para></listitem>
<listitem><para>A JAXP 1.1 implementation</para></listitem>
<listitem><para>A SAX 2.0 parser conforming to the JAXP 1.1 APIs</para></listitem>
<listitem><para>An XSLT parser conforming to JAXP 1.1</para></listitem>
<listitem><para>HttpClient from Commons - for HTTP communcation</para></listitem>
<listitem><para>Logging component from Commons (not yet implemented)</para></listitem>
<listitem><para>JUnit - for testing</para></listitem>
<listitem><para>JSSE - SSL support (optional at runtime)</para></listitem>
<listitem><para>Jakarta-Regexp - regular expression tests and XML preprocessing (for variable support)</para></listitem>
<listitem><para>JDOM - for building XML reports</para></listitem>
</itemizedlist>
</section>
<section>
<title>(2) Initial Source of the Package</title>
<para>The initial source has been committed to the Sandbox, and includes
almost all of the functionality described above.</para>
</section>
<section>
<title>(3) Required Jakarta-Commons Resources</title>
<itemizedlist>
<listitem>
<para>CVS Repository - New directory <emphasis>latka
</emphasis> in the <emphasis>jakarta-commons</emphasis> CVS repository.</para>
</listitem>
<listitem><para>Mailing List - Discussions will take place on
the general <emphasis>jakarta-commons@jakarta.apache.org</emphasis> mailing
list. To help list subscribers identify messages of interest, it is suggested
that the message subject of messages about this component be prefixed with
[Latka].</para></listitem>
<listitem><para>Bugzilla - New component "Latka" under the
"Commons" product category, with appropriate version identifiers as needed.
</para></listitem>
<listitem><para>Jyve FAQ - New category "commons-latka" (when
available).</para></listitem>
</itemizedlist>
</section>
<section>
<title>(4) Initial Committers</title>
<para>The initial committers on the Latka component shall be:</para>
<itemizedlist>
<listitem><para>Morgan Delagrange</para></listitem>
<listitem><para>Doug Sale</para></listitem>
<listitem><para>Rodney Waldhoff</para></listitem>
<listitem><para>TBD</para></listitem>
</itemizedlist>
</section>
</chapter>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>