Package
The Ruby binding (C extension) is available as a gem named zmq. For the alternate Ruby binding (FFI, works on JRuby and others), go to the ruby-ffi page for more information.
To install the ruby gem:
gem install zmq
If the gem installation complains that it cannot find libzmq or headers, simply pass the location of your libzmq installation to the gem install command:
gem install zmq -- --with-zmq-dir=/opt/local
On Windows I had to add the parameter for the libs. For example:
gem install zmq -- --with-zmq-dir=c:/src/zeromq-2.2.0 --with-zmq-lib=c:/src/zeromq-2.2.0/src/.libs
(note the extra -- are required)
This gem should work for both Ruby 1.8 and Ruby 1.9. Ruby threads are supported for Ruby 1.9 only (ZMQ calls will block the entire interpreter under Ruby 1.8, due to limitations of the zeromq C++ library and the Ruby 1.8 threading model).
Source Code
Source code can be found here:
http://github.com/zeromq/rbzmq
To build the Ruby binding from the source code, first make sure that ØMQ is installed on the system. Then fetch the rbzmq code from the repository and do the following:
$ ruby extconf.rb
$ make
$ make install
To test whether everything is all right try running the performance tests in perf subdirectory:
$ ruby local_lat.rb tcp://127.0.0.1:5555 1 100
and
$ ruby ./remote_lat.rb tcp://127.0.0.1:5555 1 100
message size: 1 [B]
roundtrip count: 100
mean latency: 44.875 [us]
Documentation
The ruby bindings have rdoc/ri documentation that is installed along with the library. It is also available on the web at:
http://zeromq.github.com/rbzmq/
Additionally, have a look at performance tests in perf subdirectory.
Bug Reporting
http://github.com/zeromq/rbzmq/issues
Mailing list
Use generic ØMQ | mailing lists.
Written: 27 Jan 2010 14:02
Revised: 02 Jul 2012 18:17
If you found this page useful, please rate it up so others will find it.
Edit this page | Tags | Print
See also
- 8th Binding
- Ada Binding
- Bash Binding
- Basic Binding
- C++ Binding
- C Binding
- C# Binding (.NET & Mono)
- Chicken Scheme Binding
- Common Lisp Binding
- D Binding
- delphi binding
- Eiffel Binding
- Erlang Binding
- F# Binding
- Felix
- Flex (ActionScript)
- Fortran77
- Free Pascal Compiler aka FPC binding
- Go Binding
- Guile Binding
- Haskell Binding
- Haxe Binding
- Java binding
- JavaScript (Flash) Binding
- Julia
- LabVIEW
- Lua bindings
- Metatrader 4 Binding
- MQL4 and MQL5 Binding
- Nimrod Binding
- Node.js Binding
- Objective Caml binding
- Objective-C
- ooc Binding
- Perl Bindings
- PHP binding
- Python binding
- Q
- R Binding
- R (pbdR) Binding
- Racket Binding
- REBOL 2 Binding
- REBOL 3 Binding
- Red Binding
- Ruby Binding (FFI)
- Scala Binding
- Smalltalk
- Swift
- Tcl
- Twisted (Python) Bindings
- XOP Igor PRO
- XPCOM Binding
- Zig Binding
Show summary of bindings category
Who's watching this page?
... and more