See this series of articles for the detailed description and motivation.

This is a more flexible version of mtl, the monad transformers library.

• You can have many layers of e.g. state transformers in your stack, and you don't have to explicitly lift your gets and puts, as soon as different state transformers carry different types of states.

  Example:

  a :: (MonadState Bool m, MonadState Int m) => m ()
  a = do
    put False -- set the boolean state
    modify (+ (1 :: Int)) -- modify the integer state

• mtl requires Θ(n²) instances (like MonadReader e (StateT s m)); monad-classes requires only Θ(n) of them (where n is the number of different transformer types).

  If you'd like to define your own monad-classes-style class, you have to write much less boilerplate code.

The status of this repo

This repo serves two purposes:

• as a reference implementation accompanying the series of articles on extensible effects
• as an actual implementation we use at Signal Vine

While this is technically open source software, I am not interested in maintaining this as an active open project. In practice this means that:

• this version of monad-classes is not on hackage
• I do not accept feature requests and pull requests. The exception is outright bugs; if you find any, please do report them.

There is a hackage package and a repo maintained by M Farkas-Dyck.