Project

cztop

0.04
A long-lived project that still receives updates
CZMQ Ruby binding based on the generated low-level FFI bindings of CZMQ
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
 Dependencies

Development

>= 0
>= 0
>= 0
~> 3.8.0
>= 0

Runtime

 Project Readme

Specs status Specs status codecov

CZTop

CZTop is a CZMQ binding for Ruby. It is based on czmq-ffi-gen, the generated low-level FFI binding of CZMQ and has a focus on being easy to use for Rubyists (POLS) and providing first class support for security mechanisms (like CURVE).

Overview

Class Hierarchy

Here's an overview of the core classes:

More information in the API documentation.

Features

  • Ruby-like API
    • method names
      • sending a message via a socket is done with Socket#<<
        • socket << "simple message"
        • socket << ["multi", "frame", "message"]
      • #x= methods instead of #set_x (e.g. socket options)
      • #[] where it makes sense (e.g. on a Message, Config, or Certificate)
    • no manual error checking needed
      • if there's an error, an appropriate exception is raised
    • of course, no manual dealing with the ZMQ context
  • easy security
    • use Socket#CURVE_server!(cert) on the server
    • and Socket#CURVE_client!(client_cert, server_cert) on the client
  • socket types as Ruby classes
    • no need to manually pass type constants
      • but you can: CZTop::Socket.new_by_type(:REP)
    • e.g. #subscribe only exists on CZTop::Socket::SUB

Requirements

  • CZMQ >= 4.2
  • ZMQ >= 4.3

On Ubuntu 20.04+:

$ sudo apt install libczmq-dev

On macOS using Homebrew, run:

$ brew install czmq

Supported Rubies

  • MRI (2.6, 2.7, 3.0)
  • Rubinius (HEAD)
  • JRuby 9000 (HEAD)

Installation

To use this gem, add this line to your application's Gemfile:

gem 'cztop'

And then execute:

$ bundle

Or install it yourself as:

$ gem install cztop

Documentation

The API should be fairly straight-forward to anyone who is familiar with CZMQ and Ruby. The following API documentation is currently available:

Feel free to start a wiki page.

Performance

CZTop is just a convenience layer on top of the thin czmq-ffi-gen library.

Make sure to check out the perf directory for latency and throughput measurement scripts.

Usage

See the examples directory for some examples.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/paddor/cztop.

To run the tests before/after you made any changes to the source and have created a test case for it, use rake spec.

License

The gem is available as open source under the terms of the ISC License. See the LICENSE file.