From 00ad7b9a1c798e611a0c0b7fcbfa5ee76c2f39c4 Mon Sep 17 00:00:00 2001 From: Paul Oliver Date: Tue, 14 Jan 2025 15:58:56 -0800 Subject: Adds minimal documentation --- hsm-core/Hsm/Core/Fsm.hs | 2 ++ hsm-core/Hsm/Core/Log.hs | 2 ++ 2 files changed, 4 insertions(+) (limited to 'hsm-core/Hsm/Core') diff --git a/hsm-core/Hsm/Core/Fsm.hs b/hsm-core/Hsm/Core/Fsm.hs index 43fa497..6f9910e 100644 --- a/hsm-core/Hsm/Core/Fsm.hs +++ b/hsm-core/Hsm/Core/Fsm.hs @@ -26,6 +26,8 @@ data FsmOutput i o env sta = data FsmResult i o env sta = FsmResult o sta (FsmState i o env sta) +-- Finite state machines allow processing of stream elements using pure +-- functions. One or more FSMs can be included within a `Streamly` pipeline. fsm :: forall i o env sta es. ( Log :> es diff --git a/hsm-core/Hsm/Core/Log.hs b/hsm-core/Hsm/Core/Log.hs index 9f1f357..9bf8b37 100644 --- a/hsm-core/Hsm/Core/Log.hs +++ b/hsm-core/Hsm/Core/Log.hs @@ -9,6 +9,8 @@ import Data.Time.Clock (getCurrentTime) import Effectful (Eff, (:>)) import Effectful.Log (Log, LogLevel, getLoggerIO, logMessage) +-- Helper function allows logging within IO, Useful during `resourcet` +-- allocation and release operations. withLogIO :: Log :> es => Eff es (LogLevel -> Text -> IO ()) withLogIO = do logIO <- getLoggerIO -- cgit v1.2.1