CLiki: cl-xmlspam

cl-xmlspam

XML Stream PAttern Matcher - concise, regexp-like pattern matching on streaming XML.

Cl-xmlspam [common-lisp.net], an "XML Stream PAttern Matcher", (also known as xspam) is a library adjunct to cxml to allow simple on-the-fly parsing of streaming XML based on a non-backtracking regular-expression-like parser. It provides a compact syntax for matching, borrowing terminology from RELAX-NG, and also for regular-expression-based parsing of text elements, inspired by Rob Pike's structural regular expressions.

Here is a simple example of its use:

* (with-xspam-source "&lt;?xml version=\"1.0\"?> &lt;a> &lt;b&gt;hello there&lt;/b&gt; &lt;b&gt;goodbye&lt;/b&gt;&lt;e/&gt; &lt;p&gt;345x675 234x754 786x532&lt;/p&gt; &lt;q when=\"23-11-2008\"/&gt;&lt;/a&gt;"
    (element :a
      (group
        (one-or-more
          (element :b (text (matches "[^ ]+" (format t "word ~s~%" _)))))
        (element :p
          (text
            (matches "([0-9]+)x([0-9]+)"
              (format t "got point [~s ~s]~%" (_ 0) (_ 1)))))
        (element :q
          (attribute :when
            (match "([0-9]+)-([0-9]+)-([0-9]+)"
              (format t "got date ~s/~s/~s~%" (_ 0) (_ 1) (_ 2))))))))
word "hello"
word "there"
word "goodbye"
got point ["345" "675"]
got point ["234" "754"]
got point ["786" "532"]
got date "23"/"11"/"2008"
NIL
*

Some preliminary documentation can be found here, and one or two examples here.

Cl-xmlspam is currently in a young state - although it has been used to do useful work on real-world XML data, it has so far only been tested under SBCL, and the interface is subject to change. Feedback is much appreciated.

Unofficial Github Mirror: Github