cztop 2.0.0.rc3 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b288fb83c9508f5e1b41bd9d3035b0fa6a2f1b1f3adc35889a1f0fd21d257d7
-  data.tar.gz: 25c243cd72c6f84529a6a811ba30c313a4342c693d7e3815788ca94f56bccdd7
+  metadata.gz: '0913144e2536ad8910269c7bc0c513b756f6c5d62c39e88827703798a76565b3'
+  data.tar.gz: 1f08fa6c65186758f916775075773cf9745d62a4958b4713c3d036a1078aa128
 SHA512:
-  metadata.gz: 95f3d18ee1e94a759068b4861304cd388781e96e8ec719ffbdd6b3eebedc102285f3d6d8cf88114c8d8c7346f6a9f16ce7bdbd46bdf22f46c5d7bddd54c1fd5a
-  data.tar.gz: d1e27c106eed00de4583ff5cc32c0f79895dbecad8726ca73601270485838ddf860029efbe18eb95d40f4ec522dccfb0fdd42c12af125d6b3a704c3a42e5daa3
+  metadata.gz: 3840694739dcb2562b26fc20e76da756df5d85ab86458794930dfc76d3f16db0ee228a3cbc6473a6b6b8daa2972a5492c480b99bcff6643a2d9075283d6e5d02
+  data.tar.gz: 4d370c0f125b6e803d7ede0c97b3710e5080024615795c79279c959013f18d9ef472cd8df3664e5b124de70fb550db20046f820bfe348c130521cfb3ca57d1de

data/CHANGES.md

@@ -1,3 +1,10 @@
+2.0.0
+-----
+
+* `Socket::SUB` no longer auto-subscribes to everything — constructor `prefix:`
+  now defaults to `nil` (no subscription). Call `#subscribe` explicitly or pass
+  `prefix: ""` to subscribe to all messages.
+
 2.0.0.rc3
 -----
 

data/ZGUIDE_SUMMARY.md

@@ -180,12 +180,11 @@ loop do
   puts msg.first
 end
 
-# --- subscribe to everything (the default) ---
-sub = Cztop::Socket::SUB.connect('tcp://localhost:5556')
+# --- subscribe to everything ---
+sub = Cztop::Socket::SUB.connect('tcp://localhost:5556', prefix: '')
 
-# --- defer subscription, add later ---
-sub = Cztop::Socket::SUB.new('tcp://localhost:5556', prefix: nil)
-sub.subscribe('weather.sfo')
+# --- subscribe to a specific prefix ---
+sub = Cztop::Socket::SUB.connect('tcp://localhost:5556', prefix: 'weather.sfo')
 ```
 
 → see [`examples/zguide/02_pub_sub.rb`](examples/zguide/02_pub_sub.rb)
@@ -798,7 +797,7 @@ in the snapshot using the sequence number.
 
 ```ruby
 # Clone client sketch
-sub = Cztop::Socket::SUB.connect(pub_endpoint)
+sub = Cztop::Socket::SUB.connect(pub_endpoint, prefix: '')
 sub.recv_timeout = 1
 
 # Subscribe first, snapshot second
@@ -906,7 +905,7 @@ is a feature.
 ```ruby
 # Class methods (preferred)
 pub = Cztop::Socket::PUB.bind('tcp://*:5556')
-sub = Cztop::Socket::SUB.connect('tcp://localhost:5556')
+sub = Cztop::Socket::SUB.connect('tcp://localhost:5556', prefix: '')
 
 # Constructor
 pub = Cztop::Socket::PUB.new('tcp://*:5556')

data/lib/cztop/socket/sub.rb

@@ -14,12 +14,12 @@ module CZTop
       EVERYTHING = ''
 
       # @param endpoints [String] endpoints to connect to
-      # @param prefix [String, nil] subscription prefix; defaults to
-      #   everything ({EVERYTHING}). Pass +nil+ to skip subscribing.
+      # @param prefix [String, nil] subscription prefix; defaults to no
+      #   subscription. Pass {EVERYTHING} (+""+) to subscribe to everything.
       # @param curve [Hash, nil] CURVE encryption options
       # @param linger [Integer] linger period in milliseconds (default: 0)
       #
-      def initialize(endpoints = nil, prefix: EVERYTHING, curve: nil, linger: 0)
+      def initialize(endpoints = nil, prefix: nil, curve: nil, linger: 0)
         super(endpoints, curve: curve, linger: linger)
 
         attach_ffi_delegate(Zsock.new(Types::SUB))

data/lib/cztop/version.rb

@@ -2,6 +2,6 @@
 
 module CZTop
 
-  VERSION = '2.0.0.rc3'
+  VERSION = '2.0.0'
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cztop
 version: !ruby/object:Gem::Version
-  version: 2.0.0.rc3
+  version: 2.0.0
 platform: ruby
 authors:
 - Patrik Wenger