wraxml

Lazy wrapper to HaXML, HXT, TagSoup via custom XML tree structure

http://code.haskell.org/~thielema/wraxml/

Version on this page:0.5
LTS Haskell 24.24:0.5@rev:2
Stackage Nightly 2025-12-16:0.5@rev:2
Latest on Hackage:0.5@rev:2

See all snapshots wraxml appears in

GPL-3.0-only licensed and maintained by Henning Thielemann
This version can be pinned in stack with:wraxml-0.5@sha256:7c9ca1e54458912b2d0979ef882b8f18f0ed3c80917e97d8e731621b3beffd2c,3964

Module documentation for 0.5

  • Data
    • Data.Tree
      • Data.Tree.BranchLeaf
      • Data.Tree.BranchLeafLabel
  • Text
    • Text.HTML
      • Text.HTML.WraXML
        • Text.HTML.WraXML.Document
        • Text.HTML.WraXML.Element
        • Text.HTML.WraXML.Entity
        • Text.HTML.WraXML.String
        • Text.HTML.WraXML.Table
        • Text.HTML.WraXML.Tree
          • Text.HTML.WraXML.Tree.HXT
    • Text.XML
      • Text.XML.WraXML
        • Text.XML.WraXML.Document
          • Text.XML.WraXML.Document.TagSoup
          • Text.XML.WraXML.Document.Tagchup
        • Text.XML.WraXML.Element
        • Text.XML.WraXML.Position
          • Text.XML.WraXML.Position.HaXml
        • Text.XML.WraXML.String
          • Text.XML.WraXML.String.HXT
          • Text.XML.WraXML.String.HaXml
        • Text.XML.WraXML.Tree
          • Text.XML.WraXML.Tree.HXT
          • Text.XML.WraXML.Tree.HaXml
          • Text.XML.WraXML.Tree.Literal
          • Text.XML.WraXML.Tree.TagSoup
          • Text.XML.WraXML.Tree.Tagchup
Used by 1 package in nightly-2024-01-16(full list with versions):
wraxml

This is a wrapper to HaXML and HXT (Haskell XML Toolbox). It's my work-around for the unfortunate situation that both toolboxes have different functionality, none is the superset of the other. Both of them rely on data structures, which look unnatural to me. Additionally they provide combinator functions that are actually weakly typed, they are all of type (a -> [a]), instead of being differentiated into (a -> Bool), (a -> a) and (a -> [a]). HXT is even weaker in type safety than HaXML since it allows complete XML trees even in attribute values. I didn't want to write another XML toolbox with parsers, HTML support and so on, however in the meantime I came close to it.

I decided to do some wrapping in order to use as much as possible functionality from HaXML and HXT. I provide my own XML tree data structure with according operations. Conversions between HaXML or HXT trees and my own ones are implemented. So I can use the parser and pretty printer of both HaXML and HXT while processing trees the way I find more natural. TagSoups can also be converted to XML trees. All conversions are lazy.

I have a special XML string structure. (Text.XML.WraXML.String) XML strings consist of ASCII characters and XML references. My XML tree is built on top of a very general tree structure, which distinguishs between leafs and inner branches. (Data.Tree.BranchLeafLabel) Each element of a tree is labeled with some information. Branches are then used for tags, leafs for XML strings and special tags, and the labels for pointers to positions in the source file. (Text.XML.WraXML.Tree)