Text.XML.Unresolved

DOM-based XML parsing and rendering.

In this module, attribute values and content nodes can contain either raw text or entities. In most cases, these can be fully resolved at parsing. If that is the case for your documents, the Text.XML module provides simplified datatypes that only contain raw text.

Non-streaming functions

writeFile :: RenderSettings -> FilePath -> Document -> IO ()

readFile :: ParseSettings -> FilePath -> IO Document

Lazy bytestrings

renderLBS :: RenderSettings -> Document -> ByteString

parseLBS :: ParseSettings -> ByteString -> Either SomeException Document

parseLBS_ :: ParseSettings -> ByteString -> Document

Text

parseText :: ParseSettings -> Text -> Either SomeException Document

parseText_ :: ParseSettings -> Text -> Document

sinkTextDoc :: MonadThrow m => ParseSettings -> ConduitT Text o m Document

Byte streams

sinkDoc :: MonadThrow m => ParseSettings -> ConduitT ByteString o m Document

Streaming functions

toEvents :: Document -> [Event]

Render a document into events.

elementToEvents :: Element -> [Event]

Render a document element into events.

Since: 1.3.5

fromEvents :: MonadThrow m => ConduitT EventPos o m Document

Parse a document from a stream of events.

elementFromEvents :: MonadThrow m => ConduitT EventPos o m (Maybe Element)

Try to parse a document element (as defined in XML) from a stream of events.

Since: 1.3.5

renderBuilder :: Monad m => RenderSettings -> Document -> ConduitT i Builder m ()

renderBytes :: PrimMonad m => RenderSettings -> Document -> ConduitT i ByteString m ()

renderText :: (MonadThrow m, PrimMonad m) => RenderSettings -> Document -> ConduitT i Text m ()

Exceptions

data InvalidEventStream

Constructors

ContentAfterRoot EventPos

MissingRootElement

InvalidInlineDoctype EventPos

MissingEndElement Name (Maybe EventPos)

UnterminatedInlineDoctype

Instances

Show InvalidEventStream

Defined in Text.XML.Unresolved

Methods

showsPrec :: Int -> InvalidEventStream -> ShowS

show :: InvalidEventStream -> String

showList :: [InvalidEventStream] -> ShowS

Exception InvalidEventStream

Defined in Text.XML.Unresolved

Methods

toException :: InvalidEventStream -> SomeException

fromException :: SomeException -> Maybe InvalidEventStream

displayException :: InvalidEventStream -> String

Settings

def :: Default a => a

The default value for this type.

Parse

data ParseSettings

Instances

Default ParseSettings

Defined in Text.XML.Stream.Parse

Methods

def :: ParseSettings

psDecodeEntities :: ParseSettings -> DecodeEntities

psRetainNamespaces :: ParseSettings -> Bool

Whether the original xmlns attributes should be retained in the parsed values. For more information on motivation, see:

https://github.com/snoyberg/xml/issues/38

Default: False

Since 1.2.1

Render

data RenderSettings

Instances

Default RenderSettings

Defined in Text.XML.Stream.Render

Methods

def :: RenderSettings

rsPretty :: RenderSettings -> Bool

rsNamespaces :: RenderSettings -> [(Text, Text)]

Defines some top level namespace definitions to be used, in the form of (prefix, namespace). This has absolutely no impact on the meaning of your documents, but can increase readability by moving commonly used namespace declarations to the top level.