Path: | README |
Last Update: | Wed Jan 25 08:59:19 CET 2006 |
Version: 0.1.5
Author: Henrik Mårtensson
© 2006 by Henrik Mårtensson
Test::Unit::XML extends the Test::Unit framework with an assertion for testing well-formed XML documents.
Using Test::Unit::XML is easy. All you have to do is to require testunitxml, and you will then have an assert_xml_equal assertion available in the Test::Unit::TestCase class.
In addition to the API documentation included in the package, you can get information about how to use Test::Unit::XML from the following sources:
The easiest way to install Test::Unit::XML is to make a remote installation via the RubyGem package manager:
gem install testunitxml
If you have downloaded a gem package from Rubyforge, you can do a local installation:
cd download_directory_path
gem install testunitxml -l
If you do not have RubyGem installed, you can download a Zip file or tarball and install from it instead:
1: | Unpack the Zip or tarball archive. |
2: | cd to the directory you just unpacked. |
3: | Run the command: ruby setup.rb install |
It is hard to define exactly what equal means in the context of XML documents. I have tried to follow W3C XML recommendations as far as possible. There are a few things worthy of note:
There are a few things in the pipeline:
I plan to implement these features as I need them in other projects, so there is no time plan, and no guarantee as to the order in which I’ll implement anything.
See the MIT-LICENSE file.
You can email bug reports, opinions and questions to self@henrikmartensson.org. You may also wish to visit my home page, www.henrikmartensson.org, for more information about Test::Unit::XML and other projects. I will write about Test::Unit::XML at the the Kallokain blog. You are welcome to visit, and comment.
If you find Test::Unit::XML useful, please do tell me about it. I would like to list projects that use it on the Test::Unit::XML web site.
If you find Test::Unit::XML lacking in some respect, or buggy, I am even more interested. I can’t fix bugs I do not know about.
Finally, if you write about Test::Unit::XML, I’d like to link to the article on my web site, or at least mention it if you write for a magazine, so please tell me.