{-# LANGUAGE AllowAmbiguousTypes #-} {-# LANGUAGE ConstraintKinds #-} {-# LANGUAGE DataKinds #-} {-# LANGUAGE GADTs #-} {-# LANGUAGE ScopedTypeVariables #-} {-# LANGUAGE TypeFamilies #-} {-# LANGUAGE RankNTypes #-} -- | Code for normalization (reduction into a normal form) of Nix expressions. -- Nix language allows recursion, so some expressions do not converge. -- And so do not converge into a normal form. module Nix.Normal where import Prelude hiding ( force ) import Nix.Utils import Control.Monad.Free ( Free(..) ) import Data.Set ( member , insert ) import Nix.Cited import Nix.Frames import Nix.Thunk import Nix.Value newtype NormalLoop t f m = NormalLoop (NValue t f m) deriving Show instance MonadDataErrorContext t f m => Exception (NormalLoop t f m) -- | Normalize the value as much as possible, leaving only detected cycles. normalizeValue :: forall e t m f . ( Framed e m , MonadThunk t m (NValue t f m) , MonadDataErrorContext t f m , Ord (ThunkId m) ) => NValue t f m -> m (NValue t f m) normalizeValue v = run $ iterNValueM run (flip go) (fmap Free . sequenceNValue' run) v where start = 0 :: Int table = mempty run :: ReaderT Int (StateT (Set (ThunkId m)) m) r -> m r run = (`evalStateT` table) . (`runReaderT` start) go :: t -> ( NValue t f m -> ReaderT Int (StateT (Set (ThunkId m)) m) (NValue t f m) ) -> ReaderT Int (StateT (Set (ThunkId m)) m) (NValue t f m) go t k = do b <- seen t bool (do i <- ask when (i > 2000) $ fail "Exceeded maximum normalization depth of 2000 levels" (lifted . lifted) (=<< force t) (local succ . k) ) (pure $ pure t) b seen t = do let tid = thunkId t lift $ do res <- gets $ member tid unless res $ modify $ insert tid pure res -- 2021-05-09: NOTE: This seems a bit excessive. If these functorial versions are not used for recursion schemes - just free from it. -- | Normalization HOF (functorial) version of @normalizeValue@. Accepts the special thunk operating/forcing/nirmalizing function & internalizes it. normalizeValueF :: forall e t m f . ( Framed e m , MonadThunk t m (NValue t f m) , MonadDataErrorContext t f m , Ord (ThunkId m) ) => (forall r . t -> (NValue t f m -> m r) -> m r) -> NValue t f m -> m (NValue t f m) normalizeValueF f = run . iterNValueM run (flip go) (fmap Free . sequenceNValue' run) where start = 0 :: Int table = mempty run :: ReaderT Int (StateT (Set (ThunkId m)) m) r -> m r run = (`evalStateT` table) . (`runReaderT` start) go :: t -> ( NValue t f m -> ReaderT Int (StateT (Set (ThunkId m)) m) (NValue t f m) ) -> ReaderT Int (StateT (Set (ThunkId m)) m) (NValue t f m) go t k = do b <- seen t bool (do i <- ask when (i > 2000) $ fail "Exceeded maximum normalization depth of 2000 levels" lifted (lifted $ f t) $ local succ . k ) (pure $ pure t) b seen t = do let tid = thunkId t lift $ do res <- gets $ member tid unless res $ modify $ insert tid pure res -- | Normalize value. -- Detect cycles. -- If cycles were detected - put a stub on them. normalForm :: ( Framed e m , MonadThunk t m (NValue t f m) , MonadDataErrorContext t f m , HasCitations m (NValue t f m) t , HasCitations1 m (NValue t f m) f , Ord (ThunkId m) ) => NValue t f m -> m (NValue t f m) normalForm t = stubCycles <$> normalizeValue t -- | Monadic context of the result. normalForm_ :: ( Framed e m , MonadThunk t m (NValue t f m) , MonadDataErrorContext t f m , Ord (ThunkId m) ) => NValue t f m -> m () normalForm_ t = void $ normalizeValue t opaqueVal :: Applicative f => NValue t f m opaqueVal = nvStrWithoutContext "" -- | Detect cycles & stub them. stubCycles :: forall t f m . ( MonadDataContext f m , HasCitations m (NValue t f m) t , HasCitations1 m (NValue t f m) f ) => NValue t f m -> NValue t f m stubCycles = iterNValue (\_ t -> Free $ NValue' $ foldr (addProvenance1 @m @(NValue t f m)) cyc (reverse $ citations @m @(NValue t f m) t) ) Free where Free (NValue' cyc) = opaqueVal thunkStubVal :: Applicative f => NValue t f m thunkStubVal = nvStrWithoutContext thunkStubText -- | Check if thunk @t@ is computed, -- then bind it into first arg. -- else bind the thunk stub val. bindComputedThunkOrStub :: ( Applicative f , MonadThunk t m (NValue t f m) ) => (NValue t f m -> m a) -> t -> m a bindComputedThunkOrStub = (<=< query (pure thunkStubVal)) removeEffects :: (MonadThunk t m (NValue t f m), MonadDataContext f m) => NValue t f m -> m (NValue t f m) removeEffects = iterNValueM id bindComputedThunkOrStub (fmap Free . sequenceNValue' id) dethunk :: (MonadThunk t m (NValue t f m), MonadDataContext f m) => t -> m (NValue t f m) dethunk = bindComputedThunkOrStub removeEffects