hydra-0.12.0: src/main/haskell/Hydra/Sources/Kernel/Terms/Lexical.hs
{-# LANGUAGE OverloadedStrings #-}
module Hydra.Sources.Kernel.Terms.Lexical where
-- Standard imports for term-level kernel modules
import Hydra.Kernel
import Hydra.Sources.Libraries
import qualified Hydra.Dsl.Accessors as Accessors
import qualified Hydra.Dsl.Ast as Ast
import qualified Hydra.Dsl.Coders as Coders
import qualified Hydra.Dsl.Compute as Compute
import qualified Hydra.Dsl.Core as Core
import qualified Hydra.Dsl.Grammar as Grammar
import qualified Hydra.Dsl.Graph as Graph
import qualified Hydra.Dsl.Json as Json
import qualified Hydra.Dsl.Lib.Chars as Chars
import qualified Hydra.Dsl.Lib.Equality as Equality
import qualified Hydra.Dsl.Lib.Flows as Flows
import qualified Hydra.Dsl.Lib.Lists as Lists
import qualified Hydra.Dsl.Lib.Literals as Literals
import qualified Hydra.Dsl.Lib.Logic as Logic
import qualified Hydra.Dsl.Lib.Maps as Maps
import qualified Hydra.Dsl.Lib.Math as Math
import qualified Hydra.Dsl.Lib.Optionals as Optionals
import Hydra.Dsl.Phantoms as Phantoms
import qualified Hydra.Dsl.Lib.Sets as Sets
import Hydra.Dsl.Lib.Strings as Strings
import qualified Hydra.Dsl.Mantle as Mantle
import qualified Hydra.Dsl.Module as Module
import qualified Hydra.Dsl.TTerms as TTerms
import qualified Hydra.Dsl.TTypes as TTypes
import qualified Hydra.Dsl.Terms as Terms
import qualified Hydra.Dsl.Topology as Topology
import qualified Hydra.Dsl.Types as Types
import qualified Hydra.Dsl.Typing as Typing
import Hydra.Sources.Kernel.Types.All
import Prelude hiding ((++))
import qualified Data.Int as I
import qualified Data.List as L
import qualified Data.Map as M
import qualified Data.Set as S
import qualified Data.Maybe as Y
import qualified Hydra.Sources.Kernel.Terms.Monads as Monads
import qualified Hydra.Sources.Kernel.Terms.Rewriting as Rewriting
import qualified Hydra.Sources.Kernel.Terms.Show.Core as ShowCore
module_ :: Module
module_ = Module (Namespace "hydra.lexical") elements
[Monads.module_, Rewriting.module_, ShowCore.module_]
kernelTypesModules $
Just ("A module for lexical operations over graphs.")
where
elements = [
el dereferenceElementDef,
el elementsToGraphDef,
el emptyGraphDef,
el extendGraphWithBindingsDef,
el fieldsOfDef,
el getFieldDef,
el lookupElementDef,
el lookupPrimitiveDef,
el matchEnumDef,
el matchRecordDef,
el matchUnionDef,
el matchUnitFieldDef,
el requireElementDef,
el requirePrimitiveDef,
el requireTermDef,
el resolveTermDef,
el schemaContextDef,
el stripAndDereferenceTermDef,
el typeOfPrimitiveDef,
el withEmptyGraphDef,
el withSchemaContextDef]
define :: String -> TTerm a -> TBinding a
define = definitionInModule module_
dereferenceElementDef :: TBinding (Name -> Flow Graph (Maybe Binding))
dereferenceElementDef = define "dereferenceElement" $
lambda "name" $ Flows.map
(lambda "g" $ ref lookupElementDef @@ var "g" @@ var "name")
(ref Monads.getStateDef)
elementsToGraphDef :: TBinding (Graph -> Maybe Graph -> [Binding] -> Graph)
elementsToGraphDef = define "elementsToGraph" $
lambda "parent" $ lambda "schema" $ lambda "elements" $ lets [
"toPair" >: lambda "el" $ pair (Core.bindingName $ var "el") (var "el")]
$ Graph.graph
(Maps.fromList (Lists.map (var "toPair") $ var "elements"))
(Graph.graphEnvironment $ var "parent")
(Graph.graphTypes $ var "parent")
(Graph.graphBody $ var "parent")
(Graph.graphPrimitives $ var "parent")
(var "schema")
emptyGraphDef :: TBinding Graph
emptyGraphDef = define "emptyGraph" $
doc "An empty graph; no elements, no primitives, no schema, and an arbitrary body." $
Graph.graph
Maps.empty
Maps.empty
Maps.empty
(Core.termLiteral $ Core.literalString "empty graph")
Maps.empty
nothing
extendGraphWithBindingsDef :: TBinding ([Binding] -> Graph -> Graph)
extendGraphWithBindingsDef = define "extendGraphWithBindings" $
lambdas ["bindings", "g"] $ lets [
"newEls">: Maps.fromList $ Lists.map (var "toEl") (var "bindings"),
"toEl">: lambda "binding" $ lets [
"name">: Core.bindingName $ var "binding",
"term">: Core.bindingTerm $ var "binding",
"mts">: Core.bindingType $ var "binding"]
$ pair (var "name") (Core.binding (var "name") (var "term") (var "mts"))]
$ Graph.graphWithElements (var "g") (Maps.union (var "newEls") (Graph.graphElements $ var "g"))
fieldsOfDef :: TBinding (Type -> [FieldType])
fieldsOfDef = define "fieldsOf" $
lambda "t" $ lets [
"stripped">: ref Rewriting.deannotateTypeDef @@ var "t"]
$ cases _Type (var "stripped") (Just $ list []) [
_Type_forall>>: lambda "forallType" $ ref fieldsOfDef @@ (Core.forallTypeBody $ var "forallType"),
_Type_record>>: lambda "rt" $ Core.rowTypeFields $ var "rt",
_Type_union>>: lambda "rt" $ Core.rowTypeFields $ var "rt"]
getFieldDef :: TBinding (M.Map Name Term -> Name -> (Term -> Flow Graph b) -> Flow Graph b)
getFieldDef = define "getField" $
lambdas ["m", "fname", "decode"] $
Optionals.maybe
(Flows.fail $ "expected field " ++ (Core.unName $ var "fname") ++ " not found")
(var "decode")
(Maps.lookup (var "fname") (var "m"))
lookupElementDef :: TBinding (Graph -> Name -> Maybe Binding)
lookupElementDef = define "lookupElement" $
lambdas ["g", "name"] $ Maps.lookup (var "name") (Graph.graphElements $ var "g")
lookupPrimitiveDef :: TBinding (Graph -> Name -> Maybe Primitive)
lookupPrimitiveDef = define "lookupPrimitive" $
lambda "g" $ lambda "name" $
Maps.lookup (var "name") (Graph.graphPrimitives $ var "g")
matchEnumDef :: TBinding (Name -> [(Name, b)] -> Term -> Flow Graph b)
matchEnumDef = define "matchEnum" $
lambdas ["tname", "pairs"] $
ref matchUnionDef @@ var "tname" @@ (Lists.map (lambda "pair" $
ref matchUnitFieldDef @@ (first $ var "pair") @@ (second $ var "pair")) $ var "pairs")
matchRecordDef :: TBinding ((M.Map Name Term -> Flow Graph b) -> Term -> Flow Graph b)
matchRecordDef = define "matchRecord" $
lambdas ["decode", "term"] $ lets [
"stripped">: ref Rewriting.deannotateAndDetypeTermDef @@ var "term"]
$ cases _Term (var "stripped")
(Just $ ref Monads.unexpectedDef @@ string "record" @@ (ref ShowCore.termDef @@ var "term")) [
_Term_record>>: lambda "record" $ var "decode" @@
(Maps.fromList $ Lists.map
(lambda "field" $ pair (Core.fieldName $ var "field") (Core.fieldTerm $ var "field"))
(Core.recordFields $ var "record"))]
matchUnionDef :: TBinding (Name -> [(Name, Term -> Flow Graph b)] -> Term -> Flow Graph b)
matchUnionDef = define "matchUnion" $
lambdas ["tname", "pairs", "term"] $ lets [
"stripped">: ref Rewriting.deannotateAndDetypeTermDef @@ var "term",
"mapping">: Maps.fromList $ var "pairs"] $
cases _Term (var "stripped")
(Just $ ref Monads.unexpectedDef @@
("union with one of {" ++ (Strings.intercalate ", " $ Lists.map (lambda "pair" $ Core.unName $ first $ var "pair") $ var "pairs") ++ "}") @@
(ref ShowCore.termDef @@ var "stripped")) [
_Term_variable>>: lambda "name" $
Flows.bind (ref requireElementDef @@ var "name") $
lambda "el" $ ref matchUnionDef @@ var "tname" @@ var "pairs" @@ (Core.bindingTerm $ var "el"),
_Term_union>>: lambda "injection" $
Logic.ifElse (Core.equalName_ (Core.injectionTypeName $ var "injection") (var "tname"))
(lets [
"fname">: Core.fieldName $ Core.injectionField $ var "injection",
"val">: Core.fieldTerm $ Core.injectionField $ var "injection"] $
Optionals.maybe
(Flows.fail $ "no matching case for field " ++ (Core.unName $ var "fname")
++ " in union type " ++ (Core.unName $ var "tname"))
(lambda "f" $ var "f" @@ var "val")
(Maps.lookup (var "fname") (var "mapping")))
(ref Monads.unexpectedDef @@ ("injection for type " ++ (Core.unName $ var "tname")) @@ (ref ShowCore.termDef @@ var "term"))]
matchUnitFieldDef :: TBinding (Name -> y -> (Name, x -> Flow Graph y))
matchUnitFieldDef = define "matchUnitField" $
lambdas ["fname", "x"] $ pair (var "fname") (lambda "ignored" $ Flows.pure $ var "x")
requireElementDef :: TBinding (Name -> Flow Graph Binding)
requireElementDef = define "requireElement" $
lambda "name" $ lets [
"showAll">: false,
"ellipsis">: lambda "strings" $
Logic.ifElse (Logic.and (Equality.gt (Lists.length $ var "strings") (int32 3)) (Logic.not $ var "showAll"))
(Lists.concat2 (Lists.take (int32 3) (var "strings")) (list [string "..."]))
(var "strings"),
"err">: lambda "g" $ Flows.fail $
"no such element: " ++ (Core.unName $ var "name") ++
". Available elements: {" ++
(Strings.intercalate ", " $ var "ellipsis" @@ (Lists.map (lambda "el" $ Core.unName $ Core.bindingName $ var "el") $ Maps.elems $ Graph.graphElements $ var "g")) ++
"}"]
$ Flows.bind (ref dereferenceElementDef @@ var "name") $
lambda "mel" $ Optionals.maybe
(Flows.bind (ref Monads.getStateDef) $ var "err")
(unaryFunction Flows.pure)
(var "mel")
requirePrimitiveDef :: TBinding (Name -> Flow Graph Primitive)
requirePrimitiveDef = define "requirePrimitive" $
lambda "name" $
Flows.bind (ref Monads.getStateDef) $
lambda "g" $ Optionals.maybe
(Flows.fail $ "no such primitive function: " ++ (Core.unName $ var "name"))
(unaryFunction Flows.pure)
(ref lookupPrimitiveDef @@ var "g" @@ var "name")
requireTermDef :: TBinding (Name -> Flow Graph Term)
requireTermDef = define "requireTerm" $
lambda "name" $
Flows.bind (ref resolveTermDef @@ var "name") $
lambda "mt" $ Optionals.maybe
(Flows.fail $ "no such element: " ++ (Core.unName $ var "name"))
(unaryFunction Flows.pure)
(var "mt")
resolveTermDef :: TBinding (Name -> Flow Graph (Maybe Term))
resolveTermDef = define "resolveTerm" $
doc "TODO: distinguish between lambda-bound and let-bound variables" $
lambda "name" $ lets [
"recurse">: lambda "el" $ lets [
"stripped">: ref Rewriting.deannotateTermDef @@ (Core.bindingTerm $ var "el")]
$ cases _Term (var "stripped") (Just $ Flows.pure $ just $ Core.bindingTerm $ var "el") [
_Term_variable>>: lambda "name'" $ ref resolveTermDef @@ var "name'"]]
$ Flows.bind (ref Monads.getStateDef) $
lambda "g" $ Optionals.maybe
(Flows.pure nothing)
(var "recurse")
(Maps.lookup (var "name") (Graph.graphElements $ var "g"))
schemaContextDef :: TBinding (Graph -> Graph)
schemaContextDef = define "schemaContext" $
doc "Note: assuming for now that primitive functions are the same in the schema graph" $
lambda "g" $ Optionals.fromMaybe (var "g") (Graph.graphSchema $ var "g")
stripAndDereferenceTermDef :: TBinding (Term -> Flow Graph Term)
stripAndDereferenceTermDef = define "stripAndDereferenceTerm" $
lambda "term" $ lets [
"stripped">: ref Rewriting.deannotateAndDetypeTermDef @@ var "term"]
$ cases _Term (var "stripped") (Just $ Flows.pure $ var "stripped") [
_Term_variable>>: lambda "v" $
Flows.bind (ref requireTermDef @@ var "v") $
lambda "t" $ ref stripAndDereferenceTermDef @@ var "t"]
typeOfPrimitiveDef :: TBinding (Name -> Flow Graph TypeScheme)
typeOfPrimitiveDef = define "typeOfPrimitive" $
lambda "name" $ Flows.map (unaryFunction Graph.primitiveType) $ ref requirePrimitiveDef @@ var "name"
-- TODO: move into hydra.lexical
withEmptyGraphDef :: TBinding (Flow Graph a -> Flow s a)
withEmptyGraphDef = define "withEmptyGraph" $
doc "Execute flow with empty graph" $
ref Monads.withStateDef @@ ref emptyGraphDef
withSchemaContextDef :: TBinding (Flow Graph x -> Flow Graph x)
withSchemaContextDef = define "withSchemaContext" $
lambda "f" $
Flows.bind (ref Monads.getStateDef) $
lambda "g" $ ref Monads.withStateDef @@ (ref schemaContextDef @@ var "g") @@ var "f"