{-# LANGUAGE FlexibleContexts, TypeFamilies #-}
-- | This module defines a convenience typeclass for creating
-- normalised programs.
--
-- See "Futhark.Construct" for a high-level description.
module Futhark.Binder.Class
  ( Bindable (..)
  , mkLet
  , mkLet'
  , MonadBinder (..)
  , insertStms
  , insertStm
  , letBind
  , letBindNames
  , collectStms_
  , bodyBind
  , attributing
  , auxing

  , module Futhark.MonadFreshNames
  )
where

import qualified Data.Kind

import Futhark.IR
import Futhark.MonadFreshNames

-- | The class of lores that can be constructed solely from an
-- expression, within some monad.  Very important: the methods should
-- not have any significant side effects!  They may be called more
-- often than you think, and the results thrown away.  If used
-- exclusively within a 'MonadBinder' instance, it is acceptable for
-- them to create new bindings, however.
class (ASTLore lore,
       FParamInfo lore ~ DeclType,
       LParamInfo lore ~ Type,
       RetType lore ~ DeclExtType,
       BranchType lore ~ ExtType,
       SetType (LetDec lore)) =>
      Bindable lore where
  mkExpPat :: [Ident] -> [Ident] -> Exp lore -> Pattern lore
  mkExpDec :: Pattern lore -> Exp lore -> ExpDec lore
  mkBody :: Stms lore -> Result -> Body lore
  mkLetNames :: (MonadFreshNames m, HasScope lore m) =>
                [VName] -> Exp lore -> m (Stm lore)

-- | A monad that supports the creation of bindings from expressions
-- and bodies from bindings, with a specific lore.  This is the main
-- typeclass that a monad must implement in order for it to be useful
-- for generating or modifying Futhark code.  Most importantly
-- maintains a current state of 'Stms' (as well as a 'Scope') that
-- have been added with 'addStm'.
--
-- Very important: the methods should not have any significant side
-- effects!  They may be called more often than you think, and the
-- results thrown away.  It is acceptable for them to create new
-- bindings, however.
class (ASTLore (Lore m),
       MonadFreshNames m, Applicative m, Monad m,
       LocalScope (Lore m) m) =>
      MonadBinder m where
  type Lore m :: Data.Kind.Type
  mkExpDecM :: Pattern (Lore m) -> Exp (Lore m) -> m (ExpDec (Lore m))
  mkBodyM :: Stms (Lore m) -> Result -> m (Body (Lore m))
  mkLetNamesM :: [VName] -> Exp (Lore m) -> m (Stm (Lore m))

  -- | Add a statement to the 'Stms' under construction.
  addStm      :: Stm (Lore m) -> m ()
  addStm      = Seq (Stm (Lore m)) -> m ()
forall (m :: * -> *). MonadBinder m => Seq (Stm (Lore m)) -> m ()
addStms (Seq (Stm (Lore m)) -> m ())
-> (Stm (Lore m) -> Seq (Stm (Lore m))) -> Stm (Lore m) -> m ()
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Stm (Lore m) -> Seq (Stm (Lore m))
forall lore. Stm lore -> Stms lore
oneStm

  -- | Add multiple statements to the 'Stms' under construction.
  addStms     :: Stms (Lore m) -> m ()

  -- | Obtain the statements constructed during a monadic action,
  -- instead of adding them to the state.
  collectStms :: m a -> m (a, Stms (Lore m))

  -- | Add the provided certificates to any statements added during
  -- execution of the action.
  certifying :: Certificates -> m a -> m a
  certifying = (Seq (Stm (Lore m)) -> Seq (Stm (Lore m))) -> m a -> m a
forall (m :: * -> *) a.
MonadBinder m =>
(Stms (Lore m) -> Stms (Lore m)) -> m a -> m a
censorStms ((Seq (Stm (Lore m)) -> Seq (Stm (Lore m))) -> m a -> m a)
-> (Certificates -> Seq (Stm (Lore m)) -> Seq (Stm (Lore m)))
-> Certificates
-> m a
-> m a
forall b c a. (b -> c) -> (a -> b) -> a -> c
. (Stm (Lore m) -> Stm (Lore m))
-> Seq (Stm (Lore m)) -> Seq (Stm (Lore m))
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
fmap ((Stm (Lore m) -> Stm (Lore m))
 -> Seq (Stm (Lore m)) -> Seq (Stm (Lore m)))
-> (Certificates -> Stm (Lore m) -> Stm (Lore m))
-> Certificates
-> Seq (Stm (Lore m))
-> Seq (Stm (Lore m))
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Certificates -> Stm (Lore m) -> Stm (Lore m)
forall lore. Certificates -> Stm lore -> Stm lore
certify

-- | Apply a function to the statements added by this action.
censorStms :: MonadBinder m =>
              (Stms (Lore m) -> Stms (Lore m))
           -> m a -> m a
censorStms :: (Stms (Lore m) -> Stms (Lore m)) -> m a -> m a
censorStms Stms (Lore m) -> Stms (Lore m)
f m a
m = do
  (a
x, Stms (Lore m)
stms) <- m a -> m (a, Stms (Lore m))
forall (m :: * -> *) a.
MonadBinder m =>
m a -> m (a, Seq (Stm (Lore m)))
collectStms m a
m
  Stms (Lore m) -> m ()
forall (m :: * -> *). MonadBinder m => Seq (Stm (Lore m)) -> m ()
addStms (Stms (Lore m) -> m ()) -> Stms (Lore m) -> m ()
forall a b. (a -> b) -> a -> b
$ Stms (Lore m) -> Stms (Lore m)
f Stms (Lore m)
stms
  a -> m a
forall (m :: * -> *) a. Monad m => a -> m a
return a
x

-- | Add the given attributes to any statements added by this action.
attributing :: MonadBinder m => Attrs -> m a -> m a
attributing :: Attrs -> m a -> m a
attributing Attrs
attrs = (Stms (Lore m) -> Stms (Lore m)) -> m a -> m a
forall (m :: * -> *) a.
MonadBinder m =>
(Stms (Lore m) -> Stms (Lore m)) -> m a -> m a
censorStms ((Stms (Lore m) -> Stms (Lore m)) -> m a -> m a)
-> (Stms (Lore m) -> Stms (Lore m)) -> m a -> m a
forall a b. (a -> b) -> a -> b
$ (Stm (Lore m) -> Stm (Lore m)) -> Stms (Lore m) -> Stms (Lore m)
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
fmap Stm (Lore m) -> Stm (Lore m)
onStm
  where onStm :: Stm (Lore m) -> Stm (Lore m)
onStm (Let Pattern (Lore m)
pat StmAux (ExpDec (Lore m))
aux Exp (Lore m)
e) =
          Pattern (Lore m)
-> StmAux (ExpDec (Lore m)) -> Exp (Lore m) -> Stm (Lore m)
forall lore.
Pattern lore -> StmAux (ExpDec lore) -> Exp lore -> Stm lore
Let Pattern (Lore m)
pat StmAux (ExpDec (Lore m))
aux { stmAuxAttrs :: Attrs
stmAuxAttrs = Attrs
attrs Attrs -> Attrs -> Attrs
forall a. Semigroup a => a -> a -> a
<> StmAux (ExpDec (Lore m)) -> Attrs
forall dec. StmAux dec -> Attrs
stmAuxAttrs StmAux (ExpDec (Lore m))
aux } Exp (Lore m)
e

-- | Add the certificates and attributes to any statements added by
-- this action.
auxing :: MonadBinder m => StmAux anylore -> m a -> m a
auxing :: StmAux anylore -> m a -> m a
auxing (StmAux Certificates
cs Attrs
attrs anylore
_) = (Stms (Lore m) -> Stms (Lore m)) -> m a -> m a
forall (m :: * -> *) a.
MonadBinder m =>
(Stms (Lore m) -> Stms (Lore m)) -> m a -> m a
censorStms ((Stms (Lore m) -> Stms (Lore m)) -> m a -> m a)
-> (Stms (Lore m) -> Stms (Lore m)) -> m a -> m a
forall a b. (a -> b) -> a -> b
$ (Stm (Lore m) -> Stm (Lore m)) -> Stms (Lore m) -> Stms (Lore m)
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
fmap Stm (Lore m) -> Stm (Lore m)
onStm
  where onStm :: Stm (Lore m) -> Stm (Lore m)
onStm (Let Pattern (Lore m)
pat StmAux (ExpDec (Lore m))
aux Exp (Lore m)
e) =
          Pattern (Lore m)
-> StmAux (ExpDec (Lore m)) -> Exp (Lore m) -> Stm (Lore m)
forall lore.
Pattern lore -> StmAux (ExpDec lore) -> Exp lore -> Stm lore
Let Pattern (Lore m)
pat StmAux (ExpDec (Lore m))
aux' Exp (Lore m)
e
          where aux' :: StmAux (ExpDec (Lore m))
aux' = StmAux (ExpDec (Lore m))
aux { stmAuxAttrs :: Attrs
stmAuxAttrs = Attrs
attrs Attrs -> Attrs -> Attrs
forall a. Semigroup a => a -> a -> a
<> StmAux (ExpDec (Lore m)) -> Attrs
forall dec. StmAux dec -> Attrs
stmAuxAttrs StmAux (ExpDec (Lore m))
aux
                           , stmAuxCerts :: Certificates
stmAuxCerts = Certificates
cs Certificates -> Certificates -> Certificates
forall a. Semigroup a => a -> a -> a
<> StmAux (ExpDec (Lore m)) -> Certificates
forall dec. StmAux dec -> Certificates
stmAuxCerts StmAux (ExpDec (Lore m))
aux
                           }

-- | Add a statement with the given pattern and expression.
letBind :: MonadBinder m =>
            Pattern (Lore m) -> Exp (Lore m) -> m ()
letBind :: Pattern (Lore m) -> Exp (Lore m) -> m ()
letBind Pattern (Lore m)
pat Exp (Lore m)
e =
  Stm (Lore m) -> m ()
forall (m :: * -> *). MonadBinder m => Stm (Lore m) -> m ()
addStm (Stm (Lore m) -> m ()) -> m (Stm (Lore m)) -> m ()
forall (m :: * -> *) a b. Monad m => (a -> m b) -> m a -> m b
=<< Pattern (Lore m)
-> StmAux (ExpDec (Lore m)) -> Exp (Lore m) -> Stm (Lore m)
forall lore.
Pattern lore -> StmAux (ExpDec lore) -> Exp lore -> Stm lore
Let Pattern (Lore m)
pat (StmAux (ExpDec (Lore m)) -> Exp (Lore m) -> Stm (Lore m))
-> m (StmAux (ExpDec (Lore m))) -> m (Exp (Lore m) -> Stm (Lore m))
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> (ExpDec (Lore m) -> StmAux (ExpDec (Lore m))
forall dec. dec -> StmAux dec
defAux (ExpDec (Lore m) -> StmAux (ExpDec (Lore m)))
-> m (ExpDec (Lore m)) -> m (StmAux (ExpDec (Lore m)))
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> Pattern (Lore m) -> Exp (Lore m) -> m (ExpDec (Lore m))
forall (m :: * -> *).
MonadBinder m =>
Pattern (Lore m) -> Exp (Lore m) -> m (ExpDec (Lore m))
mkExpDecM Pattern (Lore m)
pat Exp (Lore m)
e) m (Exp (Lore m) -> Stm (Lore m))
-> m (Exp (Lore m)) -> m (Stm (Lore m))
forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
<*> Exp (Lore m) -> m (Exp (Lore m))
forall (f :: * -> *) a. Applicative f => a -> f a
pure Exp (Lore m)
e

-- | Construct a 'Stm' from identifiers for the context- and value
-- part of the pattern, as well as the expression.
mkLet :: Bindable lore => [Ident] -> [Ident] -> Exp lore -> Stm lore
mkLet :: [Ident] -> [Ident] -> Exp lore -> Stm lore
mkLet [Ident]
ctx [Ident]
val Exp lore
e =
  let pat :: Pattern lore
pat = [Ident] -> [Ident] -> Exp lore -> Pattern lore
forall lore.
Bindable lore =>
[Ident] -> [Ident] -> Exp lore -> Pattern lore
mkExpPat [Ident]
ctx [Ident]
val Exp lore
e
      dec :: ExpDec lore
dec = Pattern lore -> Exp lore -> ExpDec lore
forall lore.
Bindable lore =>
Pattern lore -> Exp lore -> ExpDec lore
mkExpDec Pattern lore
pat Exp lore
e
  in Pattern lore -> StmAux (ExpDec lore) -> Exp lore -> Stm lore
forall lore.
Pattern lore -> StmAux (ExpDec lore) -> Exp lore -> Stm lore
Let Pattern lore
pat (ExpDec lore -> StmAux (ExpDec lore)
forall dec. dec -> StmAux dec
defAux ExpDec lore
dec) Exp lore
e

-- | Like mkLet, but also take attributes and certificates from the
-- given 'StmAux'.
mkLet' :: Bindable lore => [Ident] -> [Ident] -> StmAux a -> Exp lore -> Stm lore
mkLet' :: [Ident] -> [Ident] -> StmAux a -> Exp lore -> Stm lore
mkLet' [Ident]
ctx [Ident]
val (StmAux Certificates
cs Attrs
attrs a
_) Exp lore
e =
  let pat :: Pattern lore
pat = [Ident] -> [Ident] -> Exp lore -> Pattern lore
forall lore.
Bindable lore =>
[Ident] -> [Ident] -> Exp lore -> Pattern lore
mkExpPat [Ident]
ctx [Ident]
val Exp lore
e
      dec :: ExpDec lore
dec = Pattern lore -> Exp lore -> ExpDec lore
forall lore.
Bindable lore =>
Pattern lore -> Exp lore -> ExpDec lore
mkExpDec Pattern lore
pat Exp lore
e
  in Pattern lore -> StmAux (ExpDec lore) -> Exp lore -> Stm lore
forall lore.
Pattern lore -> StmAux (ExpDec lore) -> Exp lore -> Stm lore
Let Pattern lore
pat (Certificates -> Attrs -> ExpDec lore -> StmAux (ExpDec lore)
forall dec. Certificates -> Attrs -> dec -> StmAux dec
StmAux Certificates
cs Attrs
attrs ExpDec lore
dec) Exp lore
e

-- | Add a statement with the given pattern element names and
-- expression.
letBindNames :: MonadBinder m => [VName] -> Exp (Lore m) -> m ()
letBindNames :: [VName] -> Exp (Lore m) -> m ()
letBindNames [VName]
names Exp (Lore m)
e = Stm (Lore m) -> m ()
forall (m :: * -> *). MonadBinder m => Stm (Lore m) -> m ()
addStm (Stm (Lore m) -> m ()) -> m (Stm (Lore m)) -> m ()
forall (m :: * -> *) a b. Monad m => (a -> m b) -> m a -> m b
=<< [VName] -> Exp (Lore m) -> m (Stm (Lore m))
forall (m :: * -> *).
MonadBinder m =>
[VName] -> Exp (Lore m) -> m (Stm (Lore m))
mkLetNamesM [VName]
names Exp (Lore m)
e

-- | As 'collectStms', but throw away the ordinary result.
collectStms_ :: MonadBinder m => m a -> m (Stms (Lore m))
collectStms_ :: m a -> m (Stms (Lore m))
collectStms_ = ((a, Stms (Lore m)) -> Stms (Lore m))
-> m (a, Stms (Lore m)) -> m (Stms (Lore m))
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
fmap (a, Stms (Lore m)) -> Stms (Lore m)
forall a b. (a, b) -> b
snd (m (a, Stms (Lore m)) -> m (Stms (Lore m)))
-> (m a -> m (a, Stms (Lore m))) -> m a -> m (Stms (Lore m))
forall b c a. (b -> c) -> (a -> b) -> a -> c
. m a -> m (a, Stms (Lore m))
forall (m :: * -> *) a.
MonadBinder m =>
m a -> m (a, Seq (Stm (Lore m)))
collectStms

-- | Add the statements of the body, then return the body result.
bodyBind :: MonadBinder m => Body (Lore m) -> m [SubExp]
bodyBind :: Body (Lore m) -> m [SubExp]
bodyBind (Body BodyDec (Lore m)
_ Stms (Lore m)
stms [SubExp]
es) = do
  Stms (Lore m) -> m ()
forall (m :: * -> *). MonadBinder m => Seq (Stm (Lore m)) -> m ()
addStms Stms (Lore m)
stms
  [SubExp] -> m [SubExp]
forall (m :: * -> *) a. Monad m => a -> m a
return [SubExp]
es

-- | Add several bindings at the outermost level of a t'Body'.
insertStms :: Bindable lore => Stms lore -> Body lore -> Body lore
insertStms :: Stms lore -> Body lore -> Body lore
insertStms Stms lore
stms1 (Body BodyDec lore
_ Stms lore
stms2 [SubExp]
res) = Stms lore -> [SubExp] -> Body lore
forall lore. Bindable lore => Stms lore -> [SubExp] -> Body lore
mkBody (Stms lore
stms1Stms lore -> Stms lore -> Stms lore
forall a. Semigroup a => a -> a -> a
<>Stms lore
stms2) [SubExp]
res

-- | Add a single binding at the outermost level of a t'Body'.
insertStm :: Bindable lore => Stm lore -> Body lore -> Body lore
insertStm :: Stm lore -> Body lore -> Body lore
insertStm = Stms lore -> Body lore -> Body lore
forall lore. Bindable lore => Stms lore -> Body lore -> Body lore
insertStms (Stms lore -> Body lore -> Body lore)
-> (Stm lore -> Stms lore) -> Stm lore -> Body lore -> Body lore
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Stm lore -> Stms lore
forall lore. Stm lore -> Stms lore
oneStm