cztop 1.2.2 → 1.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ecc7b2951190994c49a1fe184641bc8933b0564dce1bdf00a346b491d67f5810
-  data.tar.gz: 0d54b8a9bd48d08ca734a5aee4a5317c13aa1a7f2b620fa036dbde8c61b98eb9
+  metadata.gz: c158b4eded1b181765d923d869fc6b9f959313f7640bfc3dc8b47b113dcf4d5c
+  data.tar.gz: afcca2379f96a9569f1776938873767fcbaaa78ec3a08faf2f860b17b42b6f34
 SHA512:
-  metadata.gz: b9f762a7ed4509bef25d4f995fd8ed7bcbe40ea67b829eda881d3973b5656ba9c72eb485b56916edddd112006e804d21f74eb17d016d50764db1ef35f7de0c2a
-  data.tar.gz: d2a876b9478e43c322e10388ac929d8cc97bcf5a9e19d9b4a67b1e042b2830165ff16d7721334c22ebb42172819b7e9397854123d90908ff8eeaffb0e3055565
+  metadata.gz: f4ab7318be7ef914957517c7dc8bb9d4030faa89b86de08479d5ad4fcc63b544745f19d0945d119898a378855f51039788f89df0dd3b9994ec2801100d5f31c3
+  data.tar.gz: 3d68e63fb44e994bcac69c76855991c8f71a4c275f76c9afcd728ccc3d3e906d1f25359bf36861136ac8252e6b433bcbec81047217a18052900a7ae3e302f0ce

data/CHANGES.md

@@ -1,3 +1,12 @@
+1.2.4 (1/16/2024)
+-----
+* PolymorphicZsockMethods#wait: fail with NotImplementedError inside non-blocking Fibers
+* fail with ArgumentError when sending message with no parts
+
+1.2.3 (1/7/2024)
+-----
+* no changes, just re-release to update README on https://www.rubydoc.info/gems/cztop
+
 1.2.2 (1/7/2024)
 -----
 * restore compatibility with Ruby 3.0+

data/README.md

@@ -18,26 +18,33 @@ See [this example](https://github.com/paddor/cztop/blob/master/examples/async.rb
 ```ruby
 #! /usr/bin/env ruby
 
-require 'cztop'
+require 'bundler/inline'
+
+gemfile do
+  source 'https://rubygems.org'
+  gem 'cztop', path: '../../'
+  gem 'async'
+end
+
+ENDPOINT = 'inproc://req_rep_example'
+# ENDPOINT = 'ipc:///tmp/req_rep_example0'
+# ENDPOINT = 'tcp://localhost:5556'
 
 Async do |task|
-  task.async do |t|
-    socket = CZTop::Socket::REP.new("inproc://req_rep_example")
-    socket.options.rcvtimeo = 50 # ms
+  rep_task = task.async do |t|
+    socket = CZTop::Socket::REP.new ENDPOINT
 
     loop do
       msg = socket.receive
       puts "<<< #{msg.to_a.inspect}"
       socket << msg.to_a.map(&:upcase)
-    rescue IO::TimeoutError
-      break
     end
-
+  ensure
     puts "REP done."
   end
 
   task.async do
-    socket = CZTop::Socket::REQ.new("inproc://req_rep_example")
+    socket = CZTop::Socket::REQ.new ENDPOINT
 
     10.times do |i|
       socket << "foobar ##{i}"
@@ -46,6 +53,7 @@ Async do |task|
     end
 
     puts "REQ done."
+    rep_task.stop
   end
 end
 ```
@@ -85,6 +93,8 @@ Executed in  401.51 millis    fish           external
 
 ```
 
+A slightly more complex version (more sockets) is [here](https://github.com/paddor/cztop/blob/master/examples/massive_async.rb).
+
 ## Overview
 
 ### Features

data/cztop.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |spec|
   spec.license       = "ISC"
   spec.required_ruby_version = Gem::Requirement.new(">= 3.0.0")
 
-  spec.metadata["homepage_uri"]    = spec.homepage
+  spec.metadata["homepage_uri"]    = "https://github.com/paddor/cztop"
   spec.metadata["source_code_uri"] = "https://github.com/paddor/cztop"
   spec.metadata["changelog_uri"]   = "https://github.com/paddor/cztop/blob/master/CHANGES.md"
 

data/lib/cztop/actor.rb

@@ -37,7 +37,7 @@ module CZTop
   class Actor
 
     include HasFFIDelegate
-    extend CZTop::HasFFIDelegate::ClassMethods
+    extend HasFFIDelegate::ClassMethods
     include ZsockOptions
     include SendReceiveMethods
     include PolymorphicZsockMethods

data/lib/cztop/message/frames.rb

@@ -6,7 +6,7 @@ module CZTop
     # @return [Integer] number of frames
     # @see content_size
     def size
-      frames.count
+      ffi_delegate.size
     end
 
 

data/lib/cztop/message.rb

@@ -32,7 +32,7 @@ module CZTop
     end
 
 
-    # @return [Boolean] if this message is empty or not
+    # @return [Boolean] if this message is empty or not (no frames or every frame has length zero)
     def empty?
       content_size.zero?
     end
@@ -56,11 +56,13 @@ module CZTop
     #   corresponding
     #   to the given routing ID)
     # @raise [ArgumentError] if the message is invalid, e.g. when trying to
-    #   send a multi-part message over a CLIENT/SERVER socket
+    #   send a message with a no parts, or a multi-part message over a CLIENT/SERVER socket
     # @raise [SystemCallError] for any other error code set after +zmsg_send+
     #   returns with failure. Please report as bug.
     #
     def send_to(destination)
+      fail ArgumentError, "message has no frames" if size.zero?
+
       destination.wait_writable
 
       rc = Zmsg.send(ffi_delegate, destination)

data/lib/cztop/polymorphic_zsock_methods.rb

@@ -14,7 +14,10 @@ module CZTop
 
     # Waits for a signal.
     # @return [Integer] the received signal
+    # @note This will block and is therefore not compatible with {Fiber.scheduler} (e.g. Async).
     def wait
+      fail NotImplementedError if !Fiber.blocking?
+
       ::CZMQ::FFI::Zsock.wait(ffi_delegate)
     end
 

data/lib/cztop/send_receive_methods.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-# Support Ruby < 3.2
 unless defined? IO::TimeoutError
+  # Support Ruby < 3.2
   class IO::TimeoutError < IOError
   end
 end

data/lib/cztop/socket.rb

@@ -5,7 +5,7 @@ module CZTop
   class Socket
 
     include HasFFIDelegate
-    extend CZTop::HasFFIDelegate::ClassMethods
+    extend HasFFIDelegate::ClassMethods
     include ZsockOptions
     include SendReceiveMethods
     include PolymorphicZsockMethods

data/lib/cztop/version.rb

@@ -2,6 +2,6 @@
 
 module CZTop
 
-  VERSION = '1.2.2'
+  VERSION = '1.2.4'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cztop
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.2.4
 platform: ruby
 authors:
 - Patrik Wenger
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-01-07 00:00:00.000000000 Z
+date: 2024-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: czmq-ffi-gen
@@ -190,7 +190,7 @@ homepage: https://rubygems.org/gems/cztop
 licenses:
 - ISC
 metadata:
-  homepage_uri: https://rubygems.org/gems/cztop
+  homepage_uri: https://github.com/paddor/cztop
   source_code_uri: https://github.com/paddor/cztop
   changelog_uri: https://github.com/paddor/cztop/blob/master/CHANGES.md
 post_install_message: