{- |

Module : $Header$

Description : Abstract syntax for CSL

Copyright : (c) Dominik Dietrich, DFKI Bremen 2010

License : GPLv2 or higher, see LICENSE.txt

Maintainer : dominik.dietrich@dfki.de

Stability : experimental

Portability : portable

This file contains the abstract syntax for CSL as well as pretty printer for it.

-}

module CSL.AS_BASIC_CSL

( EXPRESSION (..) -- datatype for numerical expressions (e.g. polynomials)

, EXTPARAM (..) -- datatype for extended parameters (e.g. [I=0])

, BASIC_ITEM (..) -- Items of a Basic Spec

, BASIC_SPEC (..) -- Basic Spec

, SYMB_ITEMS (..) -- List of symbols

, SYMB (..) -- Symbols

, SYMB_MAP_ITEMS (..) -- Symbol map

, SYMB_OR_MAP (..) -- Symbol or symbol map

, OP_ITEM (..) -- operator declaration

, VAR_ITEM (..) -- variable declaration

, Domain (..) -- domains for variable declarations

, GroundConstant (..) -- constants for domain formation

, CMD (..) -- Command datatype

, mkOp -- Simple Operator constructor

, OpInfo (..) -- Type for Operator information

, BindInfo (..) -- Type for Binder information

, operatorInfo -- Operator information for pretty printing

-- and static analysis

, lookupOpInfo

, lookupBindInfo

, APInt, APFloat -- arbitrary precision numbers

) where

import Common.Id as Id

import Common.Doc

import Common.DocUtils

import Common.AS_Annotation as AS_Anno

import qualified Data.Map as Map

-- Arbitrary precision numbers

type APInt = Integer

-- TODO: use an arbitrary precision float here:

-- The use of Other floats (such as Double) requires an instance for

-- ShATermConvertible in Common.ATerm.ConvInstances

type APFloat = Double

-- | A simple operator constructor from given operator name and arguments

mkOp :: String -> [EXPRESSION] -> EXPRESSION

mkOp s el = Op s [] el nullRange

-- | operator symbol declaration

data OP_ITEM = Op_item [Id.Token] Id.Range

deriving Show

-- | variable symbol declaration

data VAR_ITEM = Var_item [Id.Token] Domain Id.Range

deriving Show

newtype BASIC_SPEC = Basic_spec [AS_Anno.Annoted (BASIC_ITEM)]

deriving Show

data GroundConstant = GCI APInt | GCR APFloat deriving (Eq, Ord, Show)

-- | A finite set or an interval. True = closed, False = opened

data Domain = Set [GroundConstant]

| IntVal (GroundConstant, Bool) (GroundConstant, Bool)

deriving (Eq, Ord, Show)

-- | basic items: an operator or variable declaration or an axiom

data BASIC_ITEM =

Op_decl OP_ITEM

| Var_decls [VAR_ITEM]

| Axiom_item (AS_Anno.Annoted CMD)

deriving Show

-- | Extended Parameter Datatype

data EXTPARAM = EP Id.Token String APInt deriving (Eq, Ord, Show)

-- | Datatype for expressions

data EXPRESSION =

Var Id.Token

-- token instead string Id vs Token:

| Op String [EXTPARAM] [EXPRESSION] Id.Range

| List [EXPRESSION] Id.Range

-- this means interval (interval

| Interval APFloat APFloat Id.Range

| Int APInt Id.Range

| Double APFloat Id.Range

deriving (Eq, Ord, Show)

data CMD = Ass EXPRESSION EXPRESSION

| Cmd String [EXPRESSION]

| Sequence [CMD] -- program sequence

| Cond [(EXPRESSION, [CMD])]

| Repeat EXPRESSION [CMD] -- constraint, statements

deriving (Show, Eq, Ord)

-- | symbol lists for hiding

data SYMB_ITEMS = Symb_items [SYMB] Id.Range

-- pos: SYMB_KIND, commas

deriving (Show, Eq)

-- | symbol for identifiers

newtype SYMB = Symb_id Id.Token

-- pos: colon

deriving (Show, Eq)

-- | symbol maps for renamings

data SYMB_MAP_ITEMS = Symb_map_items [SYMB_OR_MAP] Id.Range

-- pos: SYMB_KIND, commas

deriving (Show, Eq)

-- | symbol map or renaming (renaming then denotes the identity renaming)

data SYMB_OR_MAP = Symb SYMB

| Symb_map SYMB SYMB Id.Range

-- pos: "|->"

deriving (Show, Eq)

data BindInfo = BindInfo { bindingVarPos :: [Int] -- ^ argument positions of

-- binding variables

, boundBodyPos :: [Int] -- ^ argument positions of

-- bound terms

} deriving (Eq, Ord, Show)

data OpInfo = OpInfo { prec :: Int -- ^ precedence between 0 and 9

, infx :: Bool -- ^ True = infix

, bind :: Maybe BindInfo -- ^ More info for binders

} deriving (Eq, Ord, Show)

-- Pretty Printing;

instance Pretty Domain where

pretty = printDomain

instance Pretty OP_ITEM where

pretty = printOpItem

instance Pretty VAR_ITEM where

pretty = printVarItem

instance Pretty BASIC_SPEC where

pretty = printBasicSpec

instance Pretty BASIC_ITEM where

pretty = printBasicItems

instance Pretty EXPRESSION where

pretty = printExpression

instance Pretty SYMB_ITEMS where

pretty = printSymbItems

instance Pretty SYMB where

pretty = printSymbol

instance Pretty SYMB_MAP_ITEMS where

pretty = printSymbMapItems

instance Pretty SYMB_OR_MAP where

pretty = printSymbOrMap

instance Pretty CMD where

pretty = printCMD

-- | Mapping of operator names to arity-'OpInfo'-maps (an operator may

-- behave differently for different arities).

operatorInfo :: Map.Map String (Map.Map Int OpInfo)

operatorInfo =

let -- arity (-1 means flex), precedence, infix

toSgl i p fx = Map.fromList [(i, OpInfo p fx Nothing)]

toSglBind i p fx bv bb =

Map.fromList [(i, OpInfo p fx $ Just $ BindInfo [bv] [bb])]

-- arityflex simple ops

aflex s = (s, toSgl (-1) 0 False)

-- arity0 simple ops

a0 s = (s, toSgl 0 0 False)

-- arity1 simple ops

a1 s = (s, toSgl 1 0 False)

-- arity2 simple ops

a2 s = (s, toSgl 2 0 False)

-- arity2 binder

a2bind bv bb s = (s, toSglBind 2 0 False bv bb)

-- arity2 infix with precedence

a2i p s = (s, toSgl 2 p True)

in Map.fromList

$ [a0 "Pi"]

++ map a1 [ "cos", "sin", "tan", "sqrt", "fthrt", "--", "abs"

, "simplify", "rlqe", "factorize" ]

++ map (a2i 2) [ "ex", "all", "and", "or", "impl" ]

++ map (a2i 3) [ "=", ">", "<=", ">=", "!=", "<"]

++ [a2i 4 "+"]

++ map (a2i 5) ["/", "*"]

++ map (a2i 6) ["^", "**"]

++ map a2 [ "int", "divide", "solve", "convergence" ]

++ map aflex [ "min", "max" ]

++ map (a2bind 1 0) [ "Maximum", "ArgAtMaximum" ]

-- special handling for overloaded "-"

++ [("-", Map.fromList [ (1, OpInfo 0 False Nothing)

, (2, OpInfo 4 True Nothing)])]

-- | For the given name and arity we lookup an 'OpInfo', where arity=-1

-- means flexible arity. If an operator is registered for the given

-- string but not for the arity we return: Left True.

lookupOpInfo :: String -- ^ operator name

-> Int -- ^ operator arity

-> Either Bool OpInfo

lookupOpInfo op arit =

case Map.lookup op operatorInfo of

Just oim ->

case Map.lookup arit oim of

Just x -> Right x

Nothing ->

case Map.lookup (-1) oim of

Just x -> Right x

_ -> Left True

_ -> Left False

-- | For the given name and arity we lookup an 'BindInfo', where arity=-1

-- means flexible arity.

lookupBindInfo :: String -- ^ operator name

-> Int -- ^ operator arity

-> Maybe BindInfo

lookupBindInfo op arit =

case Map.lookup op operatorInfo of

Just oim ->

case Map.lookup arit oim of

Just x -> bind x

_ -> Nothing

_ -> Nothing

printCMD :: CMD -> Doc

printCMD (Ass c def)

= printExpression c <+> text ":=" <+> printExpression def

printCMD c@(Cmd s exps) -- TODO: remove the case := later

| s==":=" = error $ "printCMD: use Ass for assignment representation! "

++ show c

| s=="constraint" = printExpression (exps !! 0)

| otherwise = (text s) <> (parens (sepByCommas (map printExpression exps)))

printCMD (Repeat e stms) =

text "re" <> (text "peat" $+$ vcat (map ((text "." <+>) . printCMD) stms))

$+$ text "until" <+> printExpression e

printCMD (Sequence stms) =

text "se" <> (text "quence" $+$ vcat (map ((text "." <+>) . printCMD) stms))

$+$ text "end"

printCMD (Cond l) = vcat (map (uncurry printCase) l) $+$ text "end"

printCase :: EXPRESSION -> [CMD] -> Doc

printCase e l = text "ca"

<> (text "se" <+> printExpression e <> text ":"

$+$ vcat (map ((text "." <+>) . printCMD) l))

getPrec :: EXPRESSION -> Int

getPrec (Op s _ exps _)

| length exps == 0 = 8 -- check maximum given prec in operatorInfo,

-- this value must be higher

| otherwise =

case lookupOpInfo s $ length exps of

Right oi -> prec oi

Left True -> error $

concat [ "getPrec: registered operator ", s, " used "

, "with non-registered arity ", show $ length exps ]

_ -> 0

getPrec _ = 9

printExtparam :: EXTPARAM -> Doc

printExtparam (EP p op i) =

pretty p <> text op <> (text $ if op == "-|" then "" else show i)

printExtparams :: [EXTPARAM] -> Doc

printExtparams [] = empty

printExtparams l = brackets $ sepByCommas $ map printExtparam l

printInfix :: EXPRESSION -> Doc

printInfix e@(Op s _ exps _) =

-- we mustn't omit the space between the operator and its arguments for text-

-- operators such as "and", "or", but it would be good to omit it for "+-*/"

(if (outerprec<=(getPrec (exps!!0))) then (printExpression $ (exps !! 0))

else (parens (printExpression $ (exps !! 0))))

<+> text s <+> (if outerprec<= getPrec (exps!!1)

then printExpression $ exps !! 1

else parens (printExpression $ exps !! 1))

where outerprec = getPrec e

printInfix _ = error "printInfix: Impossible case"

printExpression :: EXPRESSION -> Doc

printExpression (Var token) = text $ tokStr token

printExpression e@(Op s epl exps _)

| length exps == 0 = text s <> printExtparams epl

| otherwise =

let asPrfx = text s <> printExtparams epl

<> parens (sepByCommas $ map printExpression exps)

in case lookupOpInfo s $ length exps of

Right oi

| infx oi -> printInfix e

| otherwise -> asPrfx

_ -> asPrfx

printExpression (List exps _) = sepByCommas (map printExpression exps)

printExpression (Int i _) = text (show i)

printExpression (Double d _) = text (show d)

printExpression (Interval l r _) =

brackets $ sepByCommas $ map (text . show) [l, r]

printOpItem :: OP_ITEM -> Doc

printOpItem (Op_item tokens _) =

text "operator" <+> sepByCommas (map pretty tokens)

printVarItem :: VAR_ITEM -> Doc

printVarItem (Var_item vars dom _) =

hsep [sepByCommas $ map pretty vars, text "in", pretty dom]

printDomain :: Domain -> Doc

printDomain (Set l) = braces $ sepByCommas $ map printGC l

printDomain (IntVal (c1, b1) (c2, b2)) =

hcat [ getIBorder True b1, sepByCommas $ map printGC [c1, c2]

, getIBorder False b2]

getIBorder :: Bool -> Bool -> Doc

getIBorder False False = lbrack

getIBorder True True = lbrack

getIBorder _ _ = rbrack

printGC :: GroundConstant -> Doc

printGC (GCI i) = text (show i)

printGC (GCR d) = text (show d)

printBasicSpec :: BASIC_SPEC -> Doc

printBasicSpec (Basic_spec xs) = vcat $ map pretty xs

printBasicItems :: BASIC_ITEM -> Doc

printBasicItems (Axiom_item x) = pretty x

printBasicItems (Op_decl x) = pretty x

printBasicItems (Var_decls x) = text "vars" <+> (sepBySemis $ map pretty x)

printSymbol :: SYMB -> Doc

printSymbol (Symb_id sym) = pretty sym

printSymbItems :: SYMB_ITEMS -> Doc

printSymbItems (Symb_items xs _) = fsep $ map pretty xs

printSymbOrMap :: SYMB_OR_MAP -> Doc

printSymbOrMap (Symb sym) = pretty sym

printSymbOrMap (Symb_map source dest _) =

pretty source <+> mapsto <+> pretty dest

printSymbMapItems :: SYMB_MAP_ITEMS -> Doc

printSymbMapItems (Symb_map_items xs _) = fsep $ map pretty xs

-- Instances for GetRange

instance GetRange OP_ITEM where

getRange = Range . rangeSpan

rangeSpan x = case x of

Op_item a b -> joinRanges [rangeSpan a, rangeSpan b]

instance GetRange VAR_ITEM where

getRange = Range . rangeSpan

rangeSpan x = case x of

Var_item a _ b -> joinRanges [rangeSpan a, rangeSpan b]

instance GetRange BASIC_SPEC where

getRange = Range . rangeSpan

rangeSpan x = case x of

Basic_spec a -> joinRanges [rangeSpan a]

instance GetRange BASIC_ITEM where

getRange = Range . rangeSpan

rangeSpan x = case x of

Op_decl a -> joinRanges [rangeSpan a]

Var_decls a -> joinRanges [rangeSpan a]

Axiom_item a -> joinRanges [rangeSpan a]

instance GetRange CMD where

getRange = Range . rangeSpan

rangeSpan (Ass c def) = joinRanges (map rangeSpan [c, def])

rangeSpan (Cmd _ exps) = joinRanges (map rangeSpan exps)

-- parsing guruantees l <> null

rangeSpan (Repeat c l) = joinRanges [rangeSpan c, rangeSpan $ head l]

-- parsing guruantees l <> null

rangeSpan (Sequence l) = rangeSpan $ head l

rangeSpan (Cond l) = rangeSpan $ head l

instance GetRange SYMB_ITEMS where

getRange = Range . rangeSpan

rangeSpan (Symb_items a b) = joinRanges [rangeSpan a, rangeSpan b]

instance GetRange SYMB where

getRange = Range . rangeSpan

rangeSpan (Symb_id a) = joinRanges [rangeSpan a]

instance GetRange SYMB_MAP_ITEMS where

getRange = Range . rangeSpan

rangeSpan (Symb_map_items a b) = joinRanges [rangeSpan a, rangeSpan b]

instance GetRange SYMB_OR_MAP where

getRange = Range . rangeSpan

rangeSpan x = case x of

Symb a -> joinRanges [rangeSpan a]

Symb_map a b c -> joinRanges [rangeSpan a, rangeSpan b, rangeSpan c]

instance GetRange EXPRESSION where

getRange = Range . rangeSpan

rangeSpan x = case x of

Var token -> joinRanges [rangeSpan token]

Op _ _ exps a -> joinRanges $ [rangeSpan a] ++ (map rangeSpan exps)

List exps a -> joinRanges $ [rangeSpan a] ++ (map rangeSpan exps)

Int _ a -> joinRanges [rangeSpan a]

Double _ a -> joinRanges [rangeSpan a]

Interval _ _ a -> joinRanges [rangeSpan a]