Text.XML.Expat.Lens.Generic

A Hexpat lens module for generic tags.

Lenses provide power to do very concise XML tree diving. This module provides a less general interface to the Hexpat datatypes via lenses.

Basic inspection

name :: Traversal' (NodeG f tag text) tag

Traverses the name of an Element. This is as an Affine, or 0-or-1 target, Traversal. In regex terms, you can think of it like the ? suffix modifier.

attributes :: Traversal' (NodeG f tag text) (Attributes tag text)

Traverses to the list of attributes of an Element. This is as an Affine, or 0-or-1 target, Traversal. In regex terms, you can think of it like the ? suffix modifier.

text :: Prism' (NodeG f tag text) text

Prismatic access to the text of a Text node. This is more powerful than name, children, and attributes since it can be Reviewed.

Recursive inspection

children :: Traversal' (NodeG f tag text) (f (NodeG f tag text))

Traverses the children of an Element. This is as an Affine, or 0-or-1 target, Traversal. In regex terms, you can think of it like the ? suffix modifier.

allNodes :: Traversable c => NodeG c tag text -> [NodeG c tag text]

Produces a list of all UNodes in a XML tree. Synonym for universe.

(./) :: Plated i => Traversal' s i -> Traversal' i a -> Traversal' s a

Glue two Traversals together as relations. This is much like XPath's *slash*.

Filters

named :: (Eq a, Applicative f, Choice p) => a -> Optic' p f (NodeG f1 a text) (NodeG f1 a text)

Traverses Elements which have a particular name.

parameterized :: (Eq (IxValue a), Applicative f, Choice p, Ixed a) => Index a -> IxValue a -> Optic' p f a a

parameterized k v traverses Elements which match the value v at the key k in their attributes.