parsers-0.12.8: Parsing combinators

Copyright | (c) Edward Kmett 2011-2012
License | BSD3
Maintainer | ekmett@gmail.com
Stability | provisional
Portability | non-portable
Safe Haskell | Trustworthy
Language | Haskell2010

Text.Parser.Token.Style

Contents

- Comment and white space styles
  - Lenses
  - Common Comment Styles
- Identifier Styles
- Operator Styles

Description

A toolbox for specifying comment and identifier styles

This must be imported directly as it is not re-exported elsewhere

Synopsis

- data CommentStyle = CommentStyle {
  - _commentStart :: String
  - _commentEnd :: String
  - _commentLine :: String
  - _commentNesting :: Bool
  }
- commentStart :: Functor f => (String -> f String) -> CommentStyle -> f CommentStyle
- commentEnd :: Functor f => (String -> f String) -> CommentStyle -> f CommentStyle
- commentLine :: Functor f => (String -> f String) -> CommentStyle -> f CommentStyle
- commentNesting :: Functor f => (Bool -> f Bool) -> CommentStyle -> f CommentStyle
- emptyCommentStyle :: CommentStyle
- javaCommentStyle :: CommentStyle
- scalaCommentStyle :: CommentStyle
- haskellCommentStyle :: CommentStyle
- buildSomeSpaceParser :: forall m. CharParsing m => m () -> CommentStyle -> m ()
- emptyIdents :: TokenParsing m => IdentifierStyle m
- haskellIdents :: TokenParsing m => IdentifierStyle m
- haskell98Idents :: TokenParsing m => IdentifierStyle m
- emptyOps :: TokenParsing m => IdentifierStyle m
- haskellOps :: TokenParsing m => IdentifierStyle m
- haskell98Ops :: TokenParsing m => IdentifierStyle m

# Comment and white space styles

data CommentStyle Source #

How to deal with comments.

Constructors

CommentStyle |

Fields

- _commentStart :: String

  String that starts a multiline comment

- _commentEnd :: String

  String that ends a multiline comment

- _commentLine :: String

  String that starts a single line comment

- _commentNesting :: Bool

  Can we nest multiline comments?

Instances

Eq CommentStyle Source # |
Methods (==) :: CommentStyle -> CommentStyle -> Bool # (/=) :: CommentStyle -> CommentStyle -> Bool #
Data CommentStyle Source # |

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CommentStyle -> c CommentStyle #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CommentStyle #

toConstr :: CommentStyle -> Constr #

dataTypeOf :: CommentStyle -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CommentStyle) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CommentStyle) #

gmapT :: (forall b. Data b => b -> b) -> CommentStyle -> CommentStyle #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CommentStyle -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CommentStyle -> r #

gmapQ :: (forall d. Data d => d -> u) -> CommentStyle -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> CommentStyle -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CommentStyle -> m CommentStyle #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CommentStyle -> m CommentStyle #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CommentStyle -> m CommentStyle #

Ord CommentStyle Source # |
Methods compare :: CommentStyle -> CommentStyle -> Ordering # (<) :: CommentStyle -> CommentStyle -> Bool # (<=) :: CommentStyle -> CommentStyle -> Bool # (>) :: CommentStyle -> CommentStyle -> Bool # (>=) :: CommentStyle -> CommentStyle -> Bool # max :: CommentStyle -> CommentStyle -> CommentStyle # min :: CommentStyle -> CommentStyle -> CommentStyle #
Read CommentStyle Source # |
Methods readsPrec :: Int -> ReadS CommentStyle # readList :: ReadS [CommentStyle] # readPrec :: ReadPrec CommentStyle # readListPrec :: ReadPrec [CommentStyle] #
Show CommentStyle Source # |
Methods showsPrec :: Int -> CommentStyle -> ShowS # show :: CommentStyle -> String # showList :: [CommentStyle] -> ShowS #

## Lenses

commentStart :: Functor f => (String -> f String) -> CommentStyle -> f CommentStyle Source #

This is a lens that can edit the string that starts a multiline comment.

    commentStart :: Lens' CommentStyle String

commentEnd :: Functor f => (String -> f String) -> CommentStyle -> f CommentStyle Source #

This is a lens that can edit the string that ends a multiline comment.

    commentEnd :: Lens' CommentStyle String

commentLine :: Functor f => (String -> f String) -> CommentStyle -> f CommentStyle Source #

This is a lens that can edit the string that starts a single line comment.

    commentLine :: Lens' CommentStyle String

commentNesting :: Functor f => (Bool -> f Bool) -> CommentStyle -> f CommentStyle Source #

This is a lens that can edit whether we can nest multiline comments.

    commentNesting :: Lens' CommentStyle Bool

## Common Comment Styles

emptyCommentStyle :: CommentStyle Source #

No comments at all

javaCommentStyle :: CommentStyle Source #

Use java-style comments

scalaCommentStyle :: CommentStyle Source #

Use scala-style comments

haskellCommentStyle :: CommentStyle Source #

Use haskell-style comments

buildSomeSpaceParser :: forall m. CharParsing m => m () -> CommentStyle -> m () Source #

Use this to easily build the definition of whiteSpace for your MonadParser given a comment style and an underlying someWhiteSpace parser

# Identifier Styles

emptyIdents :: TokenParsing m => IdentifierStyle m Source #

A simple identifier style based on haskell with no reserve words

haskellIdents :: TokenParsing m => IdentifierStyle m Source #

A simple identifier style based on haskell with the reserved words from Haskell 98 and some common extensions.

haskell98Idents :: TokenParsing m => IdentifierStyle m Source #

A simple identifier style based on haskell with only the reserved words from Haskell 98.

# Operator Styles

emptyOps :: TokenParsing m => IdentifierStyle m Source #

A simple operator style based on haskell with no reserved operators

haskellOps :: TokenParsing m => IdentifierStyle m Source #

A simple operator style based on haskell with the operators from Haskell 98.

haskell98Ops :: TokenParsing m => IdentifierStyle m Source #

A simple operator style based on haskell with the operators from Haskell 98.