ffi-rzmq 1.0.3 → 2.0.1

metadata

@@ -1,73 +1,67 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: ffi-rzmq
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 1
-  - 0
-  - 3
-  version: 1.0.3
+version: !ruby/object:Gem::Version
+  version: 2.0.1
 platform: ruby
-authors: 
+authors:
 - Chuck Remes
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2013-10-03 00:00:00 -05:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: ffi
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+date: 2014-01-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi-rzmq-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.1
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: rspec
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 6
-        version: "2.6"
+      - !ruby/object:Gem::Version
+        version: '2.14'
   type: :development
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: rake
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id003
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: |-
   This gem wraps the ZeroMQ networking library using the ruby FFI (foreign
   function interface). It's a pure ruby wrapper so this gem can be loaded
-  and run by any ruby runtime that supports FFI. That's all of the major ones -
-  MRI, Rubinius and JRuby.
-email: 
+  and run by any ruby runtime that supports FFI. That's all of the major ones - MRI, Rubinius and JRuby.
+email:
 - git@chuckremes.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .bnsignore
 - .gitignore
 - .travis.yml
@@ -77,41 +71,26 @@ files:
 - README.rdoc
 - Rakefile
 - examples/README.rdoc
-- examples/v2api/latency_measurement.rb
-- examples/v2api/local_lat.rb
-- examples/v2api/local_lat_poll.rb
-- examples/v2api/local_throughput.rb
-- examples/v2api/pub.rb
-- examples/v2api/publish_subscribe.rb
-- examples/v2api/remote_lat.rb
-- examples/v2api/remote_throughput.rb
-- examples/v2api/reqrep_poll.rb
-- examples/v2api/request_response.rb
-- examples/v2api/sub.rb
-- examples/v2api/throughput_measurement.rb
-- examples/v2api/xreqxrep_poll.rb
-- examples/v3api/latency_measurement.rb
-- examples/v3api/local_lat.rb
-- examples/v3api/local_lat_poll.rb
-- examples/v3api/local_throughput.rb
-- examples/v3api/pub.rb
-- examples/v3api/publish_subscribe.rb
-- examples/v3api/remote_lat.rb
-- examples/v3api/remote_throughput.rb
-- examples/v3api/reqrep_poll.rb
-- examples/v3api/request_response.rb
-- examples/v3api/sub.rb
-- examples/v3api/throughput_measurement.rb
-- examples/v3api/xreqxrep_poll.rb
+- examples/latency_measurement.rb
+- examples/local_lat.rb
+- examples/local_lat_poll.rb
+- examples/local_throughput.rb
+- examples/pub.rb
+- examples/publish_subscribe.rb
+- examples/remote_lat.rb
+- examples/remote_throughput.rb
+- examples/repreq_over_curve.rb
+- examples/reqrep_poll.rb
+- examples/request_response.rb
+- examples/sub.rb
+- examples/throughput_measurement.rb
+- examples/xreqxrep_poll.rb
 - ext/README
 - ffi-rzmq.gemspec
 - lib/ffi-rzmq.rb
-- lib/ffi-rzmq/constants.rb
 - lib/ffi-rzmq/context.rb
 - lib/ffi-rzmq/device.rb
 - lib/ffi-rzmq/exceptions.rb
-- lib/ffi-rzmq/libc.rb
-- lib/ffi-rzmq/libzmq.rb
 - lib/ffi-rzmq/message.rb
 - lib/ffi-rzmq/poll.rb
 - lib/ffi-rzmq/poll_item.rb
@@ -132,37 +111,33 @@ files:
 - spec/spec_helper.rb
 - spec/support/test.crt
 - spec/support/test.key
-has_rdoc: true
+- spec/util_spec.rb
 homepage: http://github.com/chuckremes/ffi-rzmq
-licenses: []
-
+licenses:
+- MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: ffi-rzmq
-rubygems_version: 1.3.6
+rubygems_version: 2.0.14
 signing_key: 
-specification_version: 3
-summary: This gem wraps the ZeroMQ (0mq) networking library using Ruby FFI (foreign function interface).
-test_files: 
+specification_version: 4
+summary: This gem wraps the ZeroMQ (0mq) networking library using Ruby FFI (foreign
+  function interface).
+test_files:
 - spec/context_spec.rb
 - spec/device_spec.rb
 - spec/message_spec.rb
@@ -175,3 +150,4 @@ test_files:
 - spec/spec_helper.rb
 - spec/support/test.crt
 - spec/support/test.key
+- spec/util_spec.rb

data/examples/v2api/latency_measurement.rb

@@ -1,139 +0,0 @@
-
-require File.join(File.dirname(__FILE__), '..', '..', 'lib', 'ffi-rzmq')
-
-
-# Within a single process, we start up two threads. One thread has a REQ (request)
-# socket and the second thread has a REP (reply) socket. We measure the
-# *round-trip* latency between these sockets. Only *one* message is in flight at
-# any given moment.
-#
-# This example also illustrates how a single context can be shared amongst several
-# threads. Sharing a single context also allows a user to specify the "inproc"
-# transport in addition to "tcp" and "ipc".
-#
-#  % ruby latency_measurement.rb tcp://127.0.0.1:5555 1024 1_000_000
-#
-#  % ruby latency_measurement.rb inproc://lm_sock 1024 1_000_000
-#
-
-if ARGV.length < 3
-  puts "usage: ruby latency_measurement.rb <connect-to> <message-size> <roundtrip-count>"
-  exit
-end
-
-link = ARGV[0]
-message_size = ARGV[1].to_i
-roundtrip_count = ARGV[2].to_i
-
-def assert(rc)
-  raise "Last API call failed at #{caller(1)}" unless rc >= 0
-end
-
-begin
-  master_context = ZMQ::Context.new
-rescue ContextError => e
-  STDERR.puts "Failed to allocate context or socket!"
-  raise
-end
-
-
-class Receiver
-  def initialize context, link, size, count
-    @context = context
-    @link = link
-    @size = size
-    @count = count
-
-    begin
-      @socket = @context.socket(ZMQ::REP)
-    rescue ContextError => e
-      STDERR.puts "Failed to allocate REP socket!"
-      raise
-    end
-
-    assert(@socket.setsockopt(ZMQ::LINGER, 100))
-
-    assert(@socket.setsockopt(ZMQ::HWM, 100))
-
-    assert(@socket.bind(@link))
-  end
-
-  def run
-    @count.times do
-      string = ''
-      assert(@socket.recv_string(string, 0))
-
-      raise "Message size doesn't match, expected [#{@size}] but received [#{string.size}]" if @size != string.size
-
-      assert(@socket.send_string(string, 0))
-    end
-
-    assert(@socket.close)
-  end
-end
-
-class Transmitter
-  def initialize context, link, size, count
-    @context = context
-    @link = link
-    @size = size
-    @count = count
-
-    begin
-      @socket = @context.socket(ZMQ::REQ)
-    rescue ContextError => e
-      STDERR.puts "Failed to allocate REP socket!"
-      raise
-    end
-
-    assert(@socket.setsockopt(ZMQ::LINGER, 100))
-
-    assert(@socket.setsockopt(ZMQ::HWM, 100))
-
-    assert(@socket.connect(@link))
-  end
-
-  def run
-    msg = "#{ '3' * @size }"
-
-    elapsed = elapsed_microseconds do
-      @count.times do
-        assert(@socket.send_string(msg, 0))
-        assert(@socket.recv_string(msg, 0))
-
-        raise "Message size doesn't match, expected [#{@size}] but received [#{msg.size}]" if @size != msg.size
-      end
-    end
-
-    latency = elapsed / @count / 2
-
-    puts "message size: %i [B]" % @size
-    puts "roundtrip count: %i" % @count
-    puts "throughput (msgs/s): %i" % (@count / (elapsed / 1_000_000))
-    puts "mean latency: %.3f [us]" % latency
-    assert(@socket.close)
-  end
-
-  def elapsed_microseconds(&blk)
-    start = Time.now
-    yield
-    value = ((Time.now - start) * 1_000_000)
-  end
-end
-
-threads = []
-threads << Thread.new do
-  receiver = Receiver.new(master_context, link, message_size, roundtrip_count)
-  receiver.run
-end
-
-sleep 1
-
-threads << Thread.new do
-  transmitter = Transmitter.new(master_context, link, message_size, roundtrip_count)
-  transmitter.run
-end
-
-threads.each {|t| t.join}
-
-master_context.terminate

data/examples/v2api/local_lat.rb

@@ -1,58 +0,0 @@
-#
-#    Copyright (c) 2007-2010 iMatix Corporation
-#
-#    This file is part of 0MQ.
-#
-#    0MQ is free software; you can redistribute it and/or modify it under
-#    the terms of the Lesser GNU General Public License as published by
-#    the Free Software Foundation; either version 3 of the License, or
-#    (at your option) any later version.
-#
-#    0MQ is distributed in the hope that it will be useful,
-#    but WITHOUT ANY WARRANTY; without even the implied warranty of
-#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#    Lesser GNU General Public License for more details.
-#
-#    You should have received a copy of the Lesser GNU General Public License
-#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require File.join(File.dirname(__FILE__), '..', '..', 'lib', 'ffi-rzmq')
-
-if ARGV.length < 3
-  puts "usage: ruby local_lat.rb <connect-to> <message-size> <roundtrip-count>"
-  exit
-end
-
-bind_to = ARGV[0]
-message_size = ARGV[1].to_i
-roundtrip_count = ARGV[2].to_i
-
-def assert(rc)
-  raise "Last API call failed at #{caller(1)}" unless rc >= 0
-end
-
-begin
-  ctx = ZMQ::Context.new
-  s = ctx.socket(ZMQ::REP)
-rescue ContextError => e
-  STDERR.puts "Failed to allocate context or socket!"
-  raise
-end
-
-assert(s.setsockopt(ZMQ::LINGER, 100))
-assert(s.setsockopt(ZMQ::HWM, 100))
-
-assert(s.bind(bind_to))
-
-roundtrip_count.times do
-  string = ''
-  assert(s.recv_string(string, 0))
-
-  raise "Message size doesn't match, expected [#{message_size}] but received [#{string.size}]" if message_size != string.size
-
-  assert(s.send_string(string, 0))
-end
-
-assert(s.close)
-
-ctx.terminate

data/examples/v2api/local_lat_poll.rb

@@ -1,66 +0,0 @@
-
-require File.join(File.dirname(__FILE__), '..', '..', 'lib', 'ffi-rzmq')
-
-if ARGV.length < 3
-  puts "usage: ruby local_lat.rb <connect-to> <message-size> <roundtrip-count>"
-  exit
-end
-
-link = ARGV[0]
-message_size = ARGV[1].to_i
-roundtrip_count = ARGV[2].to_i
-
-def assert(rc)
-  raise "Last API call failed at #{caller(1)}" unless rc >= 0
-end
-
-begin
-  ctx = ZMQ::Context.new
-  s1 = ctx.socket(ZMQ::REQ)
-  s2 = ctx.socket(ZMQ::REP)
-rescue ContextError => e
-  STDERR.puts "Failed to allocate context or socket!"
-  raise
-end
-
-assert(s1.setsockopt(ZMQ::LINGER, 100))
-assert(s2.setsockopt(ZMQ::LINGER, 100))
-
-assert(s1.connect(link))
-assert(s2.bind(link))
-
-poller = ZMQ::Poller.new
-poller.register_readable(s2)
-poller.register_readable(s1)
-
-
-start_time = Time.now
-
-# kick it off
-message = ZMQ::Message.new("a" * message_size)
-assert(s1.sendmsg(message, ZMQ::NonBlocking))
-
-i = roundtrip_count
-
-until i.zero?
-  i -= 1
-
-  assert(poller.poll_nonblock)
-
-  poller.readables.each do |socket|
-    received_message = ''
-    assert(socket.recv_string(received_message, ZMQ::NonBlocking))
-    assert(socket.sendmsg(ZMQ::Message.new(received_message), ZMQ::NonBlocking))
-  end
-end
-
-elapsed_usecs = (Time.now.to_f - start_time.to_f) * 1_000_000
-latency = elapsed_usecs / roundtrip_count / 2
-
-puts "mean latency: %.3f [us]" % latency
-puts "received all messages in %.3f seconds" % (elapsed_usecs / 1_000_000)
-
-assert(s1.close)
-assert(s2.close)
-
-ctx.terminate

data/examples/v2api/local_throughput.rb

@@ -1,58 +0,0 @@
-
-require File.join(File.dirname(__FILE__), '..', '..', 'lib', 'ffi-rzmq')
-
-if ARGV.length != 3
-  puts "usage: ruby local_throughtput.rb <bind-to> <message-size> <message-count>"
-  Process.exit
-end
-
-def assert(rc)
-  raise "Last API call failed at #{caller(1)}" unless rc >= 0
-end
-
-bind_to = ARGV[0]
-message_size = ARGV[1].to_i
-message_count = ARGV[2].to_i
-
-begin
-  ctx = ZMQ::Context.new
-  s = ZMQ::Socket.new(ctx.pointer, ZMQ::SUB)
-rescue ContextError => e
-  STDERR.puts "Failed to allocate context or socket!"
-  raise
-end
-
-assert(s.setsockopt(ZMQ::LINGER, 100))
-assert(s.setsockopt(ZMQ::SUBSCRIBE, ""))
-
-assert(s.bind(bind_to))
-
-msg = ZMQ::Message.new
-assert(s.recvmsg(msg))
-
-start_time = Time.now
-
-i = 1
-while i < message_count
-  assert(s.recvmsg(msg))
-  i += 1
-end
-
-end_time = Time.now
-
-elapsed = (end_time.to_f - start_time.to_f) * 1000000
-if elapsed == 0
-  elapsed = 1
-end
-
-throughput = message_count * 1000000 / elapsed
-megabits = throughput * message_size * 8 / 1000000
-
-puts "message size: %i [B]" % message_size
-puts "message count: %i" % message_count
-puts "mean throughput: %i [msg/s]" % throughput
-puts "mean throughput: %.3f [Mb/s]" % megabits
-
-assert(s.close)
-
-ctx.terminate

data/examples/v2api/pub.rb

@@ -1,46 +0,0 @@
-
-require File.join(File.dirname(__FILE__), '..', '..', 'lib', 'ffi-rzmq')
-
-if ARGV.length != 3
-  puts "usage: ruby remote_throughput.rb <connect-to> <message-size> <message-count>"
-  Process.exit
-end
-
-connect_to = ARGV[0]
-message_size = ARGV[1].to_i
-message_count = ARGV[2].to_i
-
-def assert(rc)
-  raise "Last API call failed at #{caller(1)}" unless rc >= 0
-end
-
-begin
-  ctx = ZMQ::Context.new
-  s = ZMQ::Socket.new(ctx.pointer, ZMQ::PUB)
-rescue ContextError => e
-  STDERR.puts "Could not allocate a context or socket!"
-  raise
-end
-
-#assert(s.setsockopt(ZMQ::LINGER, 1_000))
-#assert(s.setsockopt(ZMQ::RCVHWM, 0))
-assert(s.setsockopt(ZMQ::HWM, 10))
-assert(s.bind(connect_to))
-
-# the sleep gives the downstream SUB socket a chance to register its
-# subscription filters with this PUB socket
-puts "Hit any key to start publishing"
-STDIN.gets
-
-i = 0
-while i < message_count
-  msg = ZMQ::Message.new(i.to_s)
-  assert(s.sendmsg(msg))
-  puts i
-  i += 1
-end
-
-sleep 10
-assert(s.close)
-
-ctx.terminate

data/examples/v2api/remote_throughput.rb

@@ -1,39 +0,0 @@
-
-require File.join(File.dirname(__FILE__), '..', '..', 'lib', 'ffi-rzmq')
-
-if ARGV.length != 3
-  puts "usage: ruby remote_throughput.rb <connect-to> <message-size> <message-count>"
-  Process.exit
-end
-
-connect_to = ARGV[0]
-message_size = ARGV[1].to_i
-message_count = ARGV[2].to_i
-
-def assert(rc)
-  raise "Last API call failed at #{caller(1)}" unless rc >= 0
-end
-
-begin
-  ctx = ZMQ::Context.new
-  s = ZMQ::Socket.new(ctx.pointer, ZMQ::PUB)
-rescue ContextError => e
-  STDERR.puts "Could not allocate a context or socket!"
-  raise
-end
-
-assert(s.setsockopt(ZMQ::LINGER, 1_000))
-assert(s.connect(connect_to))
-
-contents = "#{'0'*message_size}"
-
-i = 0
-while i < message_count
-  msg = ZMQ::Message.new(contents)
-  assert(s.sendmsg(msg))
-  i += 1
-end
-
-assert(s.close)
-
-ctx.terminate