| Copyright | © 2016–2017 Stack Buliders |
|---|---|
| License | BSD 3 clause |
| Maintainer | Mark Karpov <markkarpov@openmailbox.org> |
| Stability | experimental |
| Portability | portable |
| Safe Haskell | None |
| Language | Haskell2010 |
Text.Microstache.Type
Description
Types used by the package. You don't usually need to import the module, because Text.Microstache re-exports everything you may need, import that module instead.
Synopsis
- data Template = Template {
- templateActual :: PName
- templateCache :: Map PName [Node]
- data Node
- = TextBlock Text
- | EscapedVar Key
- | UnescapedVar Key
- | Section Key [Node]
- | InvertedSection Key [Node]
- | Partial PName (Maybe Word)
- newtype Key = Key {
- unKey :: [Text]
- showKey :: Key -> Text
- newtype PName = PName {
- unPName :: Text
- data MustacheException
- = MustacheParserException ParseError
- | MustacheRenderException PName Key
- displayMustacheException :: MustacheException -> String
- data MustacheWarning
- displayMustacheWarning :: MustacheWarning -> String
Documentation
Mustache template as name of “top-level” template and a collection of all available templates (partials).
Template is a Semigroup. This means that you can combine Templates
(and their caches) using the ( operator, the resulting <>)Template
will have the same currently selected template as the left one. Union of
caches is also left-biased.
Constructors
| Template | |
Fields
| |
Instances
| Semigroup Template Source # | |||||
| Data Template Source # | |||||
Defined in Text.Microstache.Type Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> Template -> c Template gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c Template toConstr :: Template -> Constr dataTypeOf :: Template -> DataType dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c Template) dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c Template) gmapT :: (forall b. Data b => b -> b) -> Template -> Template gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> Template -> r gmapQr :: forall r r'. (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> Template -> r gmapQ :: (forall d. Data d => d -> u) -> Template -> [u] gmapQi :: Int -> (forall d. Data d => d -> u) -> Template -> u gmapM :: Monad m => (forall d. Data d => d -> m d) -> Template -> m Template gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> Template -> m Template gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> Template -> m Template | |||||
| Generic Template Source # | |||||
Defined in Text.Microstache.Type Associated Types
| |||||
| Show Template Source # | |||||
| Eq Template Source # | |||||
| Ord Template Source # | |||||
Defined in Text.Microstache.Type | |||||
| type Rep Template Source # | |||||
Defined in Text.Microstache.Type type Rep Template = D1 ('MetaData "Template" "Text.Microstache.Type" "microstache-1.0.3-5YGPlZHMTft3AMOGB27Qa5" 'False) (C1 ('MetaCons "Template" 'PrefixI 'True) (S1 ('MetaSel ('Just "templateActual") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 PName) :*: S1 ('MetaSel ('Just "templateCache") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Map PName [Node])))) | |||||
Structural element of template.
Constructors
| TextBlock Text | Plain text contained between tags |
| EscapedVar Key | HTML-escaped variable |
| UnescapedVar Key | Unescaped variable |
| Section Key [Node] | Mustache section |
| InvertedSection Key [Node] | Inverted section |
| Partial PName (Maybe Word) | Partial with indentation level ( |
Instances
| Data Node Source # | |||||
Defined in Text.Microstache.Type Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> Node -> c Node gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c Node dataTypeOf :: Node -> DataType dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c Node) dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c Node) gmapT :: (forall b. Data b => b -> b) -> Node -> Node gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> Node -> r gmapQr :: forall r r'. (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> Node -> r gmapQ :: (forall d. Data d => d -> u) -> Node -> [u] gmapQi :: Int -> (forall d. Data d => d -> u) -> Node -> u gmapM :: Monad m => (forall d. Data d => d -> m d) -> Node -> m Node gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> Node -> m Node gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> Node -> m Node | |||||
| Generic Node Source # | |||||
Defined in Text.Microstache.Type Associated Types
| |||||
| Show Node Source # | |||||
| Eq Node Source # | |||||
| Ord Node Source # | |||||
| type Rep Node Source # | |||||
Defined in Text.Microstache.Type type Rep Node = D1 ('MetaData "Node" "Text.Microstache.Type" "microstache-1.0.3-5YGPlZHMTft3AMOGB27Qa5" 'False) ((C1 ('MetaCons "TextBlock" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Text)) :+: (C1 ('MetaCons "EscapedVar" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Key)) :+: C1 ('MetaCons "UnescapedVar" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Key)))) :+: (C1 ('MetaCons "Section" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Key) :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 [Node])) :+: (C1 ('MetaCons "InvertedSection" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Key) :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 [Node])) :+: C1 ('MetaCons "Partial" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 PName) :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe Word)))))) | |||||
Identifier for values to interpolate.
The representation is the following:
[]— empty list means implicit iterators;[text]— single key is a normal identifier;[text1, text2]— multiple keys represent dotted names.
Instances
| NFData Key Source # | |||||
Defined in Text.Microstache.Type | |||||
| Monoid Key Source # | |||||
| Semigroup Key Source # | |||||
| Data Key Source # | |||||
Defined in Text.Microstache.Type Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> Key -> c Key gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c Key dataTypeOf :: Key -> DataType dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c Key) dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c Key) gmapT :: (forall b. Data b => b -> b) -> Key -> Key gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> Key -> r gmapQr :: forall r r'. (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> Key -> r gmapQ :: (forall d. Data d => d -> u) -> Key -> [u] gmapQi :: Int -> (forall d. Data d => d -> u) -> Key -> u gmapM :: Monad m => (forall d. Data d => d -> m d) -> Key -> m Key gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> Key -> m Key gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> Key -> m Key | |||||
| Generic Key Source # | |||||
Defined in Text.Microstache.Type Associated Types
| |||||
| Show Key Source # | |||||
| Eq Key Source # | |||||
| Ord Key Source # | |||||
| type Rep Key Source # | |||||
Defined in Text.Microstache.Type type Rep Key = D1 ('MetaData "Key" "Text.Microstache.Type" "microstache-1.0.3-5YGPlZHMTft3AMOGB27Qa5" 'True) (C1 ('MetaCons "Key" 'PrefixI 'True) (S1 ('MetaSel ('Just "unKey") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 [Text]))) | |||||
showKey :: Key -> Text Source #
Pretty-print a key, this is helpful, for example, if you want to display an error message.
Identifier for partials. Note that with the OverloadedStrings
extension you can use just string literals to create values of this type.
Instances
| NFData PName Source # | |||||
Defined in Text.Microstache.Type | |||||
| Data PName Source # | |||||
Defined in Text.Microstache.Type Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> PName -> c PName gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c PName dataTypeOf :: PName -> DataType dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c PName) dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c PName) gmapT :: (forall b. Data b => b -> b) -> PName -> PName gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> PName -> r gmapQr :: forall r r'. (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> PName -> r gmapQ :: (forall d. Data d => d -> u) -> PName -> [u] gmapQi :: Int -> (forall d. Data d => d -> u) -> PName -> u gmapM :: Monad m => (forall d. Data d => d -> m d) -> PName -> m PName gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> PName -> m PName gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> PName -> m PName | |||||
| IsString PName Source # | |||||
Defined in Text.Microstache.Type Methods fromString :: String -> PName | |||||
| Generic PName Source # | |||||
Defined in Text.Microstache.Type Associated Types
| |||||
| Show PName Source # | |||||
| Eq PName Source # | |||||
| Ord PName Source # | |||||
| type Rep PName Source # | |||||
Defined in Text.Microstache.Type type Rep PName = D1 ('MetaData "PName" "Text.Microstache.Type" "microstache-1.0.3-5YGPlZHMTft3AMOGB27Qa5" 'True) (C1 ('MetaCons "PName" 'PrefixI 'True) (S1 ('MetaSel ('Just "unPName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Text))) | |||||
data MustacheException Source #
Exception that is thrown when parsing of a template has failed or referenced values were not provided.
Constructors
| MustacheParserException ParseError | Template parser has failed. This contains the parse error. |
| MustacheRenderException PName Key | Deprecated: Not thrown anymore, will be removed in the next major version of microstache A referenced value was not provided. The exception provides info
about partial in which the issue happened |
Instances
| Exception MustacheException Source # | |||||
Defined in Text.Microstache.Type Methods toException :: MustacheException -> SomeException fromException :: SomeException -> Maybe MustacheException displayException :: MustacheException -> String backtraceDesired :: MustacheException -> Bool | |||||
| Generic MustacheException Source # | |||||
Defined in Text.Microstache.Type Associated Types
Methods from :: MustacheException -> Rep MustacheException x to :: Rep MustacheException x -> MustacheException | |||||
| Show MustacheException Source # | |||||
Defined in Text.Microstache.Type Methods showsPrec :: Int -> MustacheException -> ShowS show :: MustacheException -> String showList :: [MustacheException] -> ShowS | |||||
| Eq MustacheException Source # | |||||
Defined in Text.Microstache.Type Methods (==) :: MustacheException -> MustacheException -> Bool (/=) :: MustacheException -> MustacheException -> Bool | |||||
| type Rep MustacheException Source # | |||||
Defined in Text.Microstache.Type type Rep MustacheException = D1 ('MetaData "MustacheException" "Text.Microstache.Type" "microstache-1.0.3-5YGPlZHMTft3AMOGB27Qa5" 'False) (C1 ('MetaCons "MustacheParserException" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 ParseError)) :+: C1 ('MetaCons "MustacheRenderException" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 PName) :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Key))) | |||||
displayMustacheException :: MustacheException -> String Source #
Since: 1.0.1
data MustacheWarning Source #
Since: 1.0.1
Constructors
| MustacheVariableNotFound Key | The template contained a variable for which there was no data counterpart in the current context |
| MustacheDirectlyRenderedValue Key | A complex value such as an Object or Array was directly rendered into the template |
Instances
| Exception MustacheWarning Source # | |||||
Defined in Text.Microstache.Type Methods toException :: MustacheWarning -> SomeException fromException :: SomeException -> Maybe MustacheWarning displayException :: MustacheWarning -> String backtraceDesired :: MustacheWarning -> Bool | |||||
| Generic MustacheWarning Source # | |||||
Defined in Text.Microstache.Type Associated Types
Methods from :: MustacheWarning -> Rep MustacheWarning x to :: Rep MustacheWarning x -> MustacheWarning | |||||
| Show MustacheWarning Source # | |||||
Defined in Text.Microstache.Type Methods showsPrec :: Int -> MustacheWarning -> ShowS show :: MustacheWarning -> String showList :: [MustacheWarning] -> ShowS | |||||
| Eq MustacheWarning Source # | |||||
Defined in Text.Microstache.Type Methods (==) :: MustacheWarning -> MustacheWarning -> Bool (/=) :: MustacheWarning -> MustacheWarning -> Bool | |||||
| type Rep MustacheWarning Source # | |||||
Defined in Text.Microstache.Type type Rep MustacheWarning = D1 ('MetaData "MustacheWarning" "Text.Microstache.Type" "microstache-1.0.3-5YGPlZHMTft3AMOGB27Qa5" 'False) (C1 ('MetaCons "MustacheVariableNotFound" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Key)) :+: C1 ('MetaCons "MustacheDirectlyRenderedValue" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Key))) | |||||
displayMustacheWarning :: MustacheWarning -> String Source #
Since: 1.0.1