Contents

= XML SAX Machines

* http://github.com/shanna/xml-sax-machines/tree/master

== Description

Assorted XML SAX readers, filters and writers for nokogiri.

== Dependencies

Ruby::
* nokogiri ~> 1.2.2

== Install

* Via git: git clone git://github.com/shanna/xml-sax-machines.git
* Via gem: gem install shanna-xml-sax-machines -s http://gems.github.com

== Flow

=== XML::SAX::Filter
Pass through filter. Base class for creating chainable SAX filters.

=== XML::SAX::Pipeline
A linear sequence of SAX filters.

== Filters

=== XML::SAX::Handler
Base class for creating chainable SAX handlers.

=== XML::SAX::Debug
Debuging output for SAX events.

=== XML::SAX::Builder
Build in-memory document trees from SAX streams.

=== XML::SAX::FragmentBuilder
Process in-memory record based document fragments. Builds well balanced XML chunks matching an XPath into a partial
in-memory document tree for processing by a callback block.

== Recognition

This library is my interpretation of patterns introduced to me through Perl's <tt>XML::SAX::Machines</tt>. All credit
to Barrie Slaymaker and contributors.

* http://search.cpan.org/dist/XML-SAX-Machines

== TODO

* Tee filter.
* Json reader/writer?
* Any other Ruby parsers that can generate a SAX stream?
* Namespace handling in XML::SAX::Builder and XML::SAX::FragmentBuilder.

== Copyright

Copyright (c) 2009 "Shane Hanna". See LICENSE for details.

Version data entries

5 entries across 5 versions & 2 rubygems

Version	Path
shanna-xml-sax-machines-0.2.1	README.rdoc
xml-sax-machines-0.4.2	README.rdoc
xml-sax-machines-0.4.1	README.rdoc
xml-sax-machines-0.4.0	README.rdoc
xml-sax-machines-0.3.0	README.rdoc