Text.XML.Hexml.Lens

Nodes

_children :: Fold Node Node

Fold over the element children

_contents :: Fold Node (Either ByteString Node)

Fold over all the children (text and element)

class ChildNode s where

Folds for element nodes

Minimal complete definition

node

Methods

node :: s -> Fold Node Node

Instances

ChildNode Int

A fold for accessing a child node by its index

Methods

node :: Int -> Fold Node Node

ChildNode String

A fold for accessing named children nodes This is a more efficient version of

node foo = _children . filtered (\n -> name n == foo)

Methods

node :: String -> Fold Node Node

ChildNode ByteString

A fold for accessing named children nodes This is a more efficient version of

node foo = _children . filtered (\n -> name n == foo)

Methods

node :: ByteString -> Fold Node Node

ChildNode String

A fold for accessing named children nodes This is a more efficient version of

node foo = _children . filtered (\n -> name n == foo)

Methods

node :: String -> Fold Node Node

ChildNode Text

A fold for accessing named children nodes This is a more efficient version of

node foo = _children . filtered (\n -> name n == foo)

Methods

node :: Text -> Fold Node Node

class TextContents s where

Fold for accessing the text contents of a node

Minimal complete definition

textContents

Methods

textContents :: Fold Node s

Instances

TextContents String

Methods

textContents :: Fold Node String

TextContents ByteString

Methods

textContents :: Fold Node ByteString

TextContents String

Methods

textContents :: Fold Node String

TextContents Text

Methods

textContents :: Fold Node Text

Attributes

class Attributes s where

Optics for accessing attributes

Minimal complete definition

iattributes

Methods

_Attribute :: s -> Getter Node (Maybe s)

Fold for accessing attributes by name.

iattributes :: IndexedFold String Node s

Name-Indexed fold over the attribute values

Instances

Attributes String

Methods

_Attribute :: String -> Getter Node (Maybe String)

iattributes :: IndexedFold String Node String

Attributes ByteString

Methods

_Attribute :: ByteString -> Getter Node (Maybe ByteString)

iattributes :: IndexedFold String Node ByteString

Attributes String

Methods

_Attribute :: String -> Getter Node (Maybe String)

iattributes :: IndexedFold String Node String

Attributes Text

Methods

_Attribute :: Text -> Getter Node (Maybe Text)

iattributes :: IndexedFold String Node Text

Parsing

class AsXML s where

Methods

_XML :: Prism' s Node

A prism for parsing and unparsing XML.

unparsing is provided by outer.

>>> "<?xml version=\"1.0\"?><foo/>" ^? _XML
Just Node "<?xml version=\"1.0\"?><foo/>"

Nameless nodes are inserted for trees with >1 root.

>>> "<?xml version=\"1.0\"?><foo/>" ^? _XML.to name
Just ""

>>> "<?xml version=\"1.0\"?><foo/>" ^? _XML.node(0::Int)
Just Node "<?xml version=\"1.0\"?>"

>>> "<?xml version=\"1.0\"?><foo/>" ^? _XML.node(1::Int)
Just Node "<foo/>"

If the tree has only 1 root, no nameless nodes are inserted.

>>> "<foo/>" ^? _XML.re(_XML @String)._XML.to name
Just "foo"

The law x ^? re _XML . _XML == x doesn't hold for the nameless nodes injected by parse.

>>> parse "<foo/>" ^? _Right.to name
Just ""
>>> parse "<foo/>" ^? _Right.re(_XML @String)._XML.to name
Just "foo"

Instances

AsXML String

Methods

_XML :: Prism' String Node

AsXML ByteString

Methods

_XML :: Prism' ByteString Node

AsXML Text

Methods

_XML :: Prism' Text Node