stm-chans: Additional types of channels for STM.

[ bsd3, concurrency, library ] [ Propose Tags ]

Additional types of channels for STM.

[Skip to Readme]
Versions [RSS] [faq] 1.0.0, 1.1.0, 1.2.0,,,, 1.3.0, 1.3.1, 2.0.0, 2.1.0, 3.0.0,,,,,
Change log CHANGELOG
Dependencies base (>=4.1 && <5), stm (>=2.4) [details]
License BSD-3-Clause
Copyright Copyright (c) 2011–2021 wren gayle romano
Author wren gayle romano, Thomas DuBuisson
Category Concurrency
Home page
Bug tracker
Source repo head: git clone
Uploaded by WrenRomano at 2021-10-18T07:02:09Z
Distributions Arch:, Debian:, Fedora:, FreeBSD:, LTSHaskell:, NixOS:, Stackage:, openSUSE:
Downloads 87612 total (657 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs available [build log]
Last success reported on 2021-10-18 [all 1 reports]


[Index] [Quick Jump]


Maintainer's Corner

For package maintainers and hackage trustees


Readme for stm-chans-

[back to package description]


Hackage version Build Status Dependencies

This package offers a collection of channel types, similar to Control.Concurrent.STM.{TChan,TQueue} but with additional features. In particular we offer the following data types:

  • Control.Concurrent.STM.TBChan: Bounded FIFO channels. When the channel is full, writers will block/retry. This ensures that the writers do not get too far ahead of the readers, which helps to make sure that memory and cpu resources are used responsibly.
  • Control.Concurrent.STM.TMChan: Closeable FIFO channels.
  • Control.Concurrent.STM.TMQueue: Closeable FIFO queues. Like TChan (Maybe a) but with a monotonicity guarantee that once Nothing is returned all future reads will be Nothing as well.
  • Control.Concurrent.STM.TBMChan: Bounded Closeable FIFO channels.
  • Control.Concurrent.STM.TBMQueue: Bounded Closeable FIFO queues. Combines the capabilities of TBChan and TMChan.


In general, this is a simple package and should be easy to install. It does require GHC however, because it relies on the Control.Concurrent.STM.TChan type which (for some unknown reason) is GHC-only. With the cabal-install program you can just do:

$> cabal install stm-chans