Safe Haskell	Safe
Language	Haskell2010

Data.Tree.Render.Text

Description

Configurable text rendering of trees.

Synopsis

data ParentLocation
data ChildOrder
- = FirstToLast
- | LastToFirst
data BranchPath
- = BranchUp
- | BranchDown
- | BranchJoin
- | BranchContinue
- | BranchEmpty
renderTreeM :: Monad m => RenderOptionsM m string label -> Tree label -> m ()
data RenderOptionsM m string label = RenderOptions {
- oParentLocation :: ParentLocation
- oChildOrder :: ChildOrder
- oVerticalPad :: Int
- oPrependNewLine :: Bool
- oFromString :: String -> string
- oWrite :: string -> m ()
- oShowNodeLabel :: label -> string
- oGetNodeMarker :: label -> string
- oShowBranchPath :: BranchPath -> string
}
tracedRenderOptionsM :: (String -> string) -> (string -> m ()) -> (label -> string) -> RenderOptionsM m string label
tracedRenderOptionsAsciiM :: (String -> string) -> (string -> m ()) -> (label -> string) -> RenderOptionsM m string label
renderTree :: RenderOptions String label -> Tree label -> String
type RenderOptions = RenderOptionsM (Writer (DList Char))
tracedRenderOptions :: (label -> String) -> RenderOptions String label
tracedRenderOptionsAscii :: (label -> String) -> RenderOptions String label

Documentation

data ParentLocation Source #

Describes where a parent node is rendered, relative to its children.

Constructors

ParentBeforeChildren
ParentAfterChildren
ParentBetweenChildren

Instances

Eq ParentLocation Source #
Instance details Defined in Data.Tree.Render.Text Methods (==) :: ParentLocation -> ParentLocation -> Bool # (/=) :: ParentLocation -> ParentLocation -> Bool #
Ord ParentLocation Source #
Instance details Defined in Data.Tree.Render.Text Methods compare :: ParentLocation -> ParentLocation -> Ordering # (<) :: ParentLocation -> ParentLocation -> Bool # (<=) :: ParentLocation -> ParentLocation -> Bool # (>) :: ParentLocation -> ParentLocation -> Bool # (>=) :: ParentLocation -> ParentLocation -> Bool # max :: ParentLocation -> ParentLocation -> ParentLocation # min :: ParentLocation -> ParentLocation -> ParentLocation #
Show ParentLocation Source #
Instance details Defined in Data.Tree.Render.Text Methods showsPrec :: Int -> ParentLocation -> ShowS # show :: ParentLocation -> String # showList :: [ParentLocation] -> ShowS #

data ChildOrder Source #

Describes the render order of a node's children.

Constructors

FirstToLast
LastToFirst

Instances

Eq ChildOrder Source #
Instance details Defined in Data.Tree.Render.Text Methods (==) :: ChildOrder -> ChildOrder -> Bool # (/=) :: ChildOrder -> ChildOrder -> Bool #
Ord ChildOrder Source #
Instance details Defined in Data.Tree.Render.Text Methods compare :: ChildOrder -> ChildOrder -> Ordering # (<) :: ChildOrder -> ChildOrder -> Bool # (<=) :: ChildOrder -> ChildOrder -> Bool # (>) :: ChildOrder -> ChildOrder -> Bool # (>=) :: ChildOrder -> ChildOrder -> Bool # max :: ChildOrder -> ChildOrder -> ChildOrder # min :: ChildOrder -> ChildOrder -> ChildOrder #
Show ChildOrder Source #
Instance details Defined in Data.Tree.Render.Text Methods showsPrec :: Int -> ChildOrder -> ShowS # show :: ChildOrder -> String # showList :: [ChildOrder] -> ShowS #

data BranchPath Source #

A part of a path along a rendered tree.

Constructors

BranchUp	Describes a turn going up toward the left. e.g. `╭─`
BranchDown	Describes a turn going down toward the left. e.g. `╰─`
BranchJoin	Describes a T-join of a path going up and down toward the left. e.g. `├─`
BranchContinue	Describes a path going up and down. e.g. `│`
BranchEmpty	Describes a part that does NOT contain a path piece. e.g.

Instances

Eq BranchPath Source #
Instance details Defined in Data.Tree.Render.Text Methods (==) :: BranchPath -> BranchPath -> Bool # (/=) :: BranchPath -> BranchPath -> Bool #
Ord BranchPath Source #
Instance details Defined in Data.Tree.Render.Text Methods compare :: BranchPath -> BranchPath -> Ordering # (<) :: BranchPath -> BranchPath -> Bool # (<=) :: BranchPath -> BranchPath -> Bool # (>) :: BranchPath -> BranchPath -> Bool # (>=) :: BranchPath -> BranchPath -> Bool # max :: BranchPath -> BranchPath -> BranchPath # min :: BranchPath -> BranchPath -> BranchPath #
Show BranchPath Source #
Instance details Defined in Data.Tree.Render.Text Methods showsPrec :: Int -> BranchPath -> ShowS # show :: BranchPath -> String # showList :: [BranchPath] -> ShowS #

renderTreeM :: Monad m => RenderOptionsM m string label -> Tree label -> m () Source #

Renders a pretty printed tree within a monadic context.

data RenderOptionsM m string label Source #

Options used for rendering a 'Tree label'.

Constructors

RenderOptions

Fields

oParentLocation :: ParentLocation
Controls where parent nodes are rendered.
oChildOrder :: ChildOrder
Controls the order a node's children are rendered.
oVerticalPad :: Int
The amount of vertical spacing between nodes.
oPrependNewLine :: Bool
If True, a newline is prepended to the rendered output.
oFromString :: String -> string
Promotes a String to a string.
oWrite :: string -> m ()
Writes a string.
oShowNodeLabel :: label -> string
Shows a rootLabel.
oGetNodeMarker :: label -> string
Get the marker for a node. Although this takes as input a node's label, this should not render the label itself.
The label is passed as an argument to allow things such as: * Rendering a node marker differently for labels that fail to pass a test. * Highlighting a node currently being visited.
Simple use cases would use a constant function ignoring the label value.
oShowBranchPath :: BranchPath -> string
Shows a BranchPath. The returned values should contain no newlines and should all be of the same printed width when rendered as text.

tracedRenderOptionsM Source #

Arguments

:: (String -> string)	Promotes a `String` to a `string`.
-> (string -> m ())	Writes a `string`.
-> (label -> string)	Shows a `rootLabel`.
-> RenderOptionsM m string label

Options for producing a line-traced tree using unicode drawing characters.

This uses: BranchUp -> "╭─" BranchDown -> "╰─" BranchJoin -> "├─" BranchContinue -> "│ " BranchEmpty -> " "

tracedRenderOptionsAsciiM Source #

Arguments

:: (String -> string)	Promotes a `String` to a `string`.
-> (string -> m ())	Writes a `string`.
-> (label -> string)	Shows a `rootLabel`.
-> RenderOptionsM m string label

Options for producing a line-traced tree using ASCII characters.

This uses: BranchUp -> ",-" BranchDown -> "`-" BranchJoin -> "|-" BranchContinue -> "| " BranchEmpty -> " "

renderTree :: RenderOptions String label -> Tree label -> String Source #

Renders a Tree a pretty printed tree asa a String.

type RenderOptions = RenderOptionsM (Writer (DList Char)) Source #

An alias of RenderOptionsM for producing pure String renders.

tracedRenderOptions Source #

Arguments

:: (label -> String)	Shows a `rootLabel`.
-> RenderOptions String label

Simplified tracedRenderOptionsM when using RenderOptionsM.

tracedRenderOptionsAscii Source #

Arguments

:: (label -> String)	Shows a `rootLabel`.
-> RenderOptions String label

Simplified tracedRenderOptionsAsciiM when using RenderOptionsM.