wraxml

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

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

LTS Haskell 24.28:	0.5@rev:2
Stackage Nightly 2026-01-18:	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:e34537f827b4bc8dd623d308ad166b967f86d2f9d96cadfe8b392a29fa8071a0,3978

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

Depends on 14 packages(full list with versions):

data-accessor, explicit-exception, HaXml, hxt, hxt-unicode, polyparse, tagchup, tagsoup, utility-ht, wraxml, xml-basic

Used by 1 package in nightly-2026-01-18(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)