1{-# LANGUAGE FlexibleContexts #-}
4-- Module : Streamly.Streams.SVar
5-- Copyright : (c) 2017 Harendra Kumar
8-- Maintainer : harendra.kumar@gmail.com
9-- Stability : experimental
13module Streamly.Streams.SVar
19import Control.Exception (fromException)
20import Control.Monad (when)
21import Control.Monad.Catch (throwM)
22import Control.Monad.IO.Class (MonadIO(liftIO))
23import Data.IORef (newIORef, readIORef, mkWeakIORef, writeIORef)
24import Data.Maybe (isNothing)
25import Data.Semigroup ((<>))
26import System.IO (hPutStrLn, stderr)
27import System.Clock (Clock(Monotonic), getTime)
28import System.Mem (performMajorGC)
31import Streamly.Streams.StreamK
33printSVar :: SVar t m a -> String -> IO ()
36 hPutStrLn stderr $ "\n" <> how <> "\n" <> svInfo
38-- | Pull a stream from an SVar.
39{-# NOINLINE fromStreamVar #-}
40fromStreamVar :: MonadAsync m => SVar Stream m a -> Stream m a
41fromStreamVar sv = mkStream $ \st stp sng yld -> do
42 list <- readOutputQ sv
43 -- Reversing the output is important to guarantee that we process the
44 -- outputs in the same order as they were generated by the constituent
46 foldStream st stp sng yld $ processEvents $ reverse list
51 when (svarInspectMode sv) $ do
52 t <- liftIO $ getTime Monotonic
53 liftIO $ writeIORef (svarStopTime (svarStats sv)) (Just t)
54 liftIO $ printSVar sv "SVar Done"
57 {-# INLINE processEvents #-}
58 processEvents [] = mkStream $ \st stp sng yld -> do
59 done <- postProcess sv
62 else foldStream st stp sng yld $ fromStreamVar sv
64 processEvents (ev : es) = mkStream $ \st stp sng yld -> do
65 let rest = processEvents es
67 ChildYield a -> yld a rest
71 Nothing -> foldStream st stp sng yld rest
73 case fromException ex of
75 foldStream st stp sng yld rest
76 Nothing -> liftIO (cleanupSVar sv) >> throwM ex
78{-# INLINE fromSVar #-}
79fromSVar :: (MonadAsync m, IsStream t) => SVar Stream m a -> t m a
81 mkStream $ \st stp sng yld -> do
82 ref <- liftIO $ newIORef ()
83 _ <- liftIO $ mkWeakIORef ref hook
84 -- We pass a copy of sv to fromStreamVar, so that we know that it has
85 -- no other references, when that copy gets garbage collected "ref"
86 -- will get garbage collected and our hook will be called.
87 foldStreamShared st stp sng yld $
88 fromStream $ fromStreamVar sv{svarRef = Just ref}
92 when (svarInspectMode sv) $ do
93 r <- liftIO $ readIORef (svarStopTime (svarStats sv))
95 printSVar sv "SVar Garbage Collected"
97 -- If there are any SVars referenced by this SVar a GC will prompt
98 -- them to be cleaned up quickly.
99 when (svarInspectMode sv) performMajorGC
101-- | Write a stream to an 'SVar' in a non-blocking manner. The stream can then
102-- be read back from the SVar using 'fromSVar'.
103toSVar :: (IsStream t, MonadAsync m) => SVar Stream m a -> t m a -> m ()
104toSVar sv m = toStreamVar sv (toStream m)
keysesc to close
- j k
- move down, up
- enter
- open
- esc
- back, or up a level
- 1 2 3 4
- readme, files, commits, refs
- /
- filter
- y
- copy the clone command
- c
- compare the chosen commit with another (or shift-click both)
- ?
- show or hide this list