This repository is used to package and release the Ruby gem czmq-ffi-gen, the low-level Ruby FFI binding for CZMQ. The gem czmq-ffi-gen can be used as a base for a higher-level CZMQ binding like CZTop. But of course you can use it for anything you want. :-)

This is generated code. It is generated from the API models in CZMQ using zproject. It doesn't feel like Ruby. It's not intended to be used directly. Instead, use CZTop, or write your own wrapper for this library.

The actual generated code lies in CZMQ, which is Git submodule of this repository, registered under vendor/czmq.

So if you're not happy with any of the generated code, go have a closer look at CZMQ (or zproject, which is used by CZMQ to generate the low-level binding).

For that same reason, API documentation of unreleased code (directly off this repository), like rubydoc.info/github/paddor/czmq-ffi-gen does NOT include any of the generated code. Rubydoc.info doesn't check out Git submodules as part of its documentation procedure.

However, the API documentation of the released gem should include all the code, as the gem release process will include all required source files directly within the gem.

Check out http://www.rubydoc.info/gems/czmq-ffi-gen for the API documentation for the released gem.

• CZMQ > 3.0 (you need to build from master)
• ZMQ >= 4.0

For security mechanisms like CURVE, you'll need:

• libsodium

On OSX using homebrew, run:

$ brew install libsodium
$ brew install zmq --with-libsodium
$ brew install czmq --HEAD

If you're running Linux, go check this page to get more help. Make sure to install CZMQ, not only ZMQ.

Note: The option --HEAD is required because this binding is generated directly from CZMQ's master branch. The current and older releases aren't supported.

See .travis.yml for a list of Ruby versions against which czmq-ffi-gen is tested.

At the time of writing, these include:

• MRI 2.3, 2.2.4, 2.1.8
• Rubinius (HEAD)
• JRuby 9000 (HEAD)

• JRuby 1.7.x and MRI < 2.0
  • doesn't work because of the use of the double splat operator (**opts)

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

gem 'czmq-ffi-gen'

And then execute:

$ bundle

Or install it yourself as:

$ gem install czmq-ffi-gen

Check out CZTop or the API documentation to see how this project can be used. :-)

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

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