在镜头中自动生成类型类的文档在哪里?

时间:2019-02-24 23:03:21

标签: haskell lens

我正在看这个blog post(也是here)中倒数第二个示例,并且在验证它运行之后,似乎可以确认lens可以生成Has类型类,我认为这是从博客的作者。但是,我错过了在lens contentslens tutorial中对此进行描述的地方。也欢迎对官方文档进行外部解释。但是,在使用最基本的功能(makeLenses,或者在这种情况下为makeLensesWith)时,这似乎只是标准。

这是转载的代码:

#!/usr/bin/env stack
-- stack --resolver lts-8.12 script
{-# LANGUAGE FlexibleContexts #-}
{-# LANGUAGE FlexibleInstances #-}
{-# LANGUAGE TemplateHaskell #-}
{-# LANGUAGE MultiParamTypeClasses #-}
{-# LANGUAGE FunctionalDependencies #-}
import Control.Concurrent.Async.Lifted.Safe
import Control.Monad.Reader
import Control.Concurrent.STM
import Say
import Control.Lens
import Prelude hiding (log)

data Env = Env
  { envLog :: !(String -> IO ())
  , envBalance :: !(TVar Int)
  }

makeLensesWith camelCaseFields ''Env

modify :: (MonadReader env m, HasBalance env (TVar Int), MonadIO m)
       => (Int -> Int)
       -> m ()
modify f = do
  env <- ask
  liftIO $ atomically $ modifyTVar' (env^.balance) f

logSomething :: (MonadReader env m, HasLog env (String -> IO ()), MonadIO m)
             => String
             -> m ()
logSomething msg = do
  env <- ask
  liftIO $ (env^.log) msg

main :: IO ()
main = do
  ref <- newTVarIO 4
  let env = Env
        { envLog = sayString
        , envBalance = ref
        }
  runReaderT
    (concurrently
      (modify (+ 1))
      (logSomething "Increasing account balance"))
    env
  balance <- readTVarIO ref
  sayString $ "Final balance: " ++ show balance

1 个答案:

答案 0 :(得分:2)

Fieldlens一词,用于描述每个命名字段的一个类的模式,从而允许具有相同字段名但(可选)不同类型的多个记录。因此,camelCaseFieldsmakeFieldOpticsdefaultFieldRules都以自己的名字说,他们将以HasFoo的通常简洁样式生成这些lens类。

makeClassy 生成名为Has*,但以数据类型而不是记录字段命名并且不遵循其他模式的类。

您上面的代码生成以下代码(显示为-ddump-splices):

    makeLensesWith camelCaseFields ''Env
  ======>
    class HasBalance s a | s -> a where
      balance :: Lens' s a
    instance HasBalance Env (TVar Int) where
      {-# INLINE balance #-}
      balance f_a4eTr (Env x1_a4eTs x2_a4eTt)
        = (fmap (\ y1_a4eTu -> (Env x1_a4eTs) y1_a4eTu)) (f_a4eTr x2_a4eTt)
    class HasLog s a | s -> a where
      log :: Lens' s a
    instance HasLog Env (String -> IO ()) where
      {-# INLINE log #-}
      log f_a4eTx (Env x1_a4eTy x2_a4eTz)
        = (fmap (\ y1_a4eTA -> (Env y1_a4eTA) x2_a4eTz)) (f_a4eTx x1_a4eTy)