zeromq3-haskell: Bindings to ZeroMQ 3.x

[ ffi, library, mit, system ] [ Propose Tags ]

The 0MQ lightweight messaging kernel is a library which extends the standard socket interfaces with features traditionally provided by specialised messaging middleware products. 0MQ sockets provide an abstraction of asynchronous message queues, multiple messaging patterns, message filtering (subscriptions), seamless access to multiple transport protocols and more. This library provides the Haskell language binding to 0MQ >= 3.2.2


[Skip to Readme]

Modules

  • Data
    • Data.Restricted
  • System
    • System.ZMQ3
      • System.ZMQ3.Monadic

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1, 0.1.1, 0.1.2, 0.1.3, 0.1.4, 0.2, 0.3.0, 0.3.1, 0.4, 0.5, 0.5.1, 0.5.2
Dependencies async, base (>=3 && <5), bytestring, containers, MonadCatchIO-transformers, semigroups, transformers [details]
License MIT
Copyright Copyright (c) 2010 - 2013 zeromq-haskell authors
Author Toralf Wittner
Maintainer Toralf Wittner <tw@dtex.org>
Category System, FFI
Home page http://github.com/twittner/zeromq-haskell/
Source repo head: git clone https://github.com/twittner/zeromq-haskell
Uploaded by ToralfWittner at 2013-06-23T21:52:22Z
Distributions
Reverse Dependencies 5 direct, 18 indirect [details]
Downloads 9528 total (20 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
All reported builds failed as of 2016-12-21 [all 8 reports]

Readme for zeromq3-haskell-0.4

[back to package description]

This library provides Haskell bindings to 0MQ 3.2.x (http://zeromq.org). API documentation can be found at: http://twittner.github.io/zeromq-haskell/

Current status

This software currently has beta status, i.e. it had seen limited testing.

Version 0.4 - Return Async a in System.ZMQ3.Monadic.async. Also require Data.List.NonEmpty in System.ZMQ3.sendMulti.

Version 0.3 - Add monadic layer on top of System.ZMQ3 and substitute String for ByteString in a number of cases, where the 0MQ API speaks of "binary data", i.e. subscribe/unsubscribe, identity/setIdentity and setTcpAcceptFilter.

Version 0.2 - Add additional functionality from 3.2 stable release, e.g. zmq_proxy support, new socket options, socket monitoring etc. API Change: withContext no longer accepts the number of I/O threads as first argument.

Version 0.1.4 - Expose waitRead and waitWrite.

Version 0.1.3 - Deprecated Xreq, XRep in favour of Dealer and Router as in libzmq. Fixes to compile and run with GHC 7.4.1.

Version 0.1.2 - Add sendMulti and receiveMulti. Rename SndMore to SendMore.

Version 0.1.1 - Include better error message when trying to build against invalid 0MQ version.

Version 0.1 - First release to provide bindings against 0MQ 3.1.0

Installation

As usual for Haskell packages this software is installed best via Cabal (http://www.haskell.org/cabal). In addition to GHC it depends on 0MQ 3.1.x of course.

Notes

zeromq3-haskell mostly follows 0MQ's API. One difference though is that sockets are parameterized types, i.e. there is not one single socket type but when creating a socket the desired socket type has to be specified, e.g. Pair and the resulting socket is of type Socket Pair. This additional type information is used to ensure that only options applicable to the socket type can be set.

Other differences are mostly for convenience. Also one does not deal directly with 0MQ messages, instead these are created internally as needed.

Finally note that receive is already non-blocking internally. GHC's I/O manager is used to wait for data to be available, so from a client's perspective receive appears to be blocking.

Differences to the 0MQ 2.x binding

This library is based on the zeromq-haskell binding for 0MQ 2.x. Socket types and options have been aligned with 0MQ 3.x and instead of using a big SocketOption datatype, this library provides separate get and set functions for each available option, e.g. affinity/setAffinity. For details, please refer to the module's haddock documentation.

Examples

The examples folder contains some simple tests mostly mimicking the ones that come with 0MQ.

Bugs

If you find any bugs or other shortcomings I would greatly appreciate a bug report, preferably via http://github.com/twittner/zeromq-haskell/issues or e-mail to tw@dtex.org