PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

WebUnit

What's WebUnit

WebUnit is Ruby API for testing html/cgi without browser, and is idealy suited for automated unit testing of web sites when combined with a Ruby unit test framework such as RubyUnit. It was designed and implemented by Masaki Suketa.

I used HttpUnit with JUnit, however, I didn't like writing test in Java, when I write program in Ruby. Then, I made it.

Libraries Used

WebUnit uses these software follow. Now, these files of htmlrepair/htmlsplit and html-parser are included in WebUnit package, so, you don't have to install them. You have to install RubyUnit and NQXML, before using WebUnit.

Download and Install

Download webunit-20YYMMDD-*.tar.gz from <URL:http://xpenguin.biz/download/webunit/>, and, extract it to some directory, then, do ruby install.rb.

Example

Execute test/test_*.rb with test runner like runtest.rb, after make symbolic link cgi directory to accessable directory via httpd, with name "webunit".

% ln -s webunit/cgi $DOCUMENT_ROOT/tmp/webunit
% cp webunit/cgi/auth/.htpasswd /tmp
% URLBASE=http://localhost/tmp/ runtest.rb test_link.rb


require 'webunit/webunit'

# get start HTML page
url = 'test-1.html'
response = WebUnit::Response::get( url )

# test HTML page contents
assert_title( 'test-1', response )
assert_equals( 1, response.forms.size )

form = response.form

# test form of HTML page contents
assert_equals( 'ntext',     form.parameters[0].name )
assert_equals( 'npassword', form.parameters[1].name )

# execute CGI script, after setting parameters
form.parameters[0].value = "this is test"
form.parameters[1].value = '!@#$%'
response = form.submit

# test output from CGI script
assert_equals( 'result', response.title )
assert_equals( 1, response.links.size )
assert_equals( 'http://....', response.links[0] )

# read link
response = response.links[0].read

enable using "Test::Unit" for Testing Framework. (by Kouhei Sutou)
appends XML Parser support "REXML". (by Kouhei Sutou)
supports multipart formdata. ready file transfer test. (by Narushima Hironori)
changes document type sdf to rd. (by Narushima Hironori)
changes installer to setup.rb. (by Narushima Hironori)
fix Textarea#query_data and Parser#feed. (Thanks to Torsten Rueger)

20020330-alpha -> 20020410-alpha

XmlDocument -> DomWalker : rename
fix for 1.7 parser.(Thanks to Kazuhiro NISHIYAMA)
fix install.rb for "--program-suffix".(Thanks to Kazuhiro NISHIYAMA)

20011019-alpha -> 20020330-alpha

XmlDocument#size : new.
mail addres of author is changed.

20011019-alpha -> 20011022-alpha

XmlDocument#change_node : bug fix.

20011002-alpha -> 20011019-alpha

XmlDocument : new - class to test xml document.

20010919-alpha -> 20011002-alpha

Parser#do_input : support input tag without form tag. (Thanks to IKAGAWA, Kauztomo)
Response#init_http : append header(Content-Type) for POST method.
Response#init_http : catch IOError of HTTP::finish (for ruby 1.6.5)

20010912-alpha -> 20010919-alpha

Response#get,post,init_http : to use BasicAuth.
sample/cgi : remove space charactor between '#!' and '/usr/bin/env'

20010714-alpha -> 20010912-alpha

Responss : use Net::HTTP::new_implementation.
HtmlElem : fix inspect output when @tag is nil.( as toplevel )
sgml-parser.rb(line:257) : bug fix, fail when nested tags.
html-parser/install.rb : fix.

20010618-alpha -> 20010714-alpha

Parser : add link tag to SingleTags.
Parser#start_a : execute complete_url, unless the href begins '#'.
Link : append onClick attribute, and reader.
Response#init_http : retry, when Errno::EPIPE
Response::html : append <html> tag, when there is no <html> tag.

20010611-alpha -> 20010618-alpha

add sample

20010604-alpha -> 20010611-alpha

HtmlElem#name : new
Response#init_html : new, to use WebUnit without http access.
(code using Response#new) : change to Response#new.init_http
Response#init_http,feed, : divide initialize.
perse_url : correspond to relative url and 'file:' prefix.
perse_url : add '-' to regexp, will match to hostname.
assert_urls : add success case, use orthop_url for expected url.

20010521-alpha -> 20010604-alpha

include contrib/{html-parser,htmlrepair} : Thanks these authors. - html-parser : Takahiro Maebashi - htmlrepair : MoonWolf
installer supports to install contrib/{html-parser,htmlrepair}