{-# LANGUAGE AllowAmbiguousTypes #-} {-# LANGUAGE ConstraintKinds #-} {-# LANGUAGE DataKinds #-} {-# LANGUAGE FlexibleContexts #-} {-# LANGUAGE GADTs #-} {-# LANGUAGE ScopedTypeVariables #-} {-# LANGUAGE TypeApplications #-} {-# 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.String 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 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 $ \f -> f =<< 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 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 -- | 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) = opaque removeEffects :: (MonadThunk t m (NValue t f m), MonadDataContext f m) => NValue t f m -> m (NValue t f m) removeEffects = iterNValueM id -- 2021-02-25: NOTE: Please, unflip this up the stack (\ t f -> f =<< queryM (pure opaque) t) (fmap Free . sequenceNValue' id) opaque :: Applicative f => NValue t f m opaque = nvStr $ makeNixStringWithoutContext "" dethunk :: (MonadThunk t m (NValue t f m), MonadDataContext f m) => t -> m (NValue t f m) dethunk = removeEffects <=< queryM (pure opaque)