BSD-3-Clause licensed by Edward A. Kmett
Maintained by Edward A. Kmett
This version can be pinned in stack with:comonad-4.2.7.2@sha256:cbd214397c5232755da4aa9a4acd8ddb5ae9e676b9f407dd2a9d1493ba59ce0f,3525

comonad

Build Status

This package provides comonads, the categorical dual of monads.

class Functor w => Comonad w where
    extract :: w a -> a
    duplicate :: w a -> w (w a)
    extend :: (w a -> b) -> w a -> w b

There are two ways to define a comonad:

I. Provide definitions for ‘extract’ and ‘extend’ satisfying these laws:

extend extract      = id
extract . extend f  = f
extend f . extend g = extend (f . extend g)

In this case, you may simply set ‘fmap’ = ‘liftW’.

These laws are directly analogous to the laws for monads and perhaps can be made clearer by viewing them as laws stating that Cokleisli composition must be associative, and has extract for a unit:

f =>= extract   = f
extract =>= f   = f
(f =>= g) =>= h = f =>= (g =>= h)

II. Alternately, you may choose to provide definitions for ‘fmap’, ‘extract’, and ‘duplicate’ satisfying these laws:

extract . duplicate      = id
fmap extract . duplicate = id
duplicate . duplicate    = fmap duplicate . duplicate

In this case you may not rely on the ability to define ‘fmap’ in terms of ‘liftW’.

You may of course, choose to define both ‘duplicate’ /and/ ‘extend’. In that case you must also satisfy these laws:

extend f  = fmap f . duplicate
duplicate = extend id
fmap f    = extend (f . extract)

These are the default definitions of ‘extend’ and’duplicate’ and the definition of ‘liftW’ respectively.

Contact Information

Contributions and bug reports are welcome!

Please feel free to contact me through github or on the #haskell IRC channel on irc.freenode.net.

-Edward Kmett

Changes

4.2.7.2

  • Compiles warning-free on GHC 7.10

4.2.7.1

  • Use CPP

4.2.7

  • Trustworthy fixes for GHC 7.2

4.2.6

  • Re-export (Data.Functor.$>) rather than supply our own on GHC 7.8+
  • Better SafeHaskell support.
  • instance Monoid m => ComonadTraced m ((->) m)

4.2.5

  • Added a MINIMAL pragma to Comonad.
  • Added DefaultSignatures support for ComonadApply on GHC 7.2+

4.2.4

  • Added Kenneth Foner’s fixed point as kfix.

4.2.3

  • Add Comonad and ComonadEnv instances for Arg e from semigroups 0.16.3 which can be used to extract the argmin or argmax.

4.2.2

  • contravariant 1.0 support

4.2.1

  • Added flags that supply unsupported build modes that can be convenient for sandbox users.

4.2

  • transformers 0.4 compatibility

4.1

  • Fixed the ‘Typeable’ instance for ’Cokleisli on GHC 7.8.1

4.0.1

  • Fixes to avoid warnings on GHC 7.8.1

4.0

  • Merged the contents of comonad-transformers and comonads-fd into this package.

3.1

  • Added instance Comonad (Tagged s).

3.0.3

  • Trustworthy or Safe depending on GHC version

3.0.2

  • GHC 7.7 HEAD compatibility
  • Updated build system