google-cloud-pubsub 0.39.3 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73f7842ab38615304cdae95c371eb8afea6bc4299208ba3ae4c61e4db85356ba
-  data.tar.gz: 6b0e30cf14ee025dc2abdb7bcbfb7424fe93952c9dfc24a9cd01837a7a813621
+  metadata.gz: 0e249c4539610e4b293e64f0e61319712f2d7cd68197aca32158387873962c6d
+  data.tar.gz: 1abcfc9704a1d17035fcf1c79a65a41fb3a0406621bd80d60fb8bf40e402f2ab
 SHA512:
-  metadata.gz: 7e343262355396ae126ac9945df4a89f7af156f9f6a4ea7f31581eceee691f875595235fed0e3d2800b5b49aea46e61fe528db32f35c10c42f3b3c738e5608c1
-  data.tar.gz: edcdc80a74455127b8817a5aa2cf9b95c5a057a37fe5e9e6f15fa2f5da90ad4fa16290548a07311ed15df719c88cfa4e87b350047e769137f4d8215bcc6015be
+  metadata.gz: dd0fd7eba6866ae2893d3d4efdd23d32f37793ed64b43f9ee27755e26ae13d79d95f1782fb246bea4ce9c5ed36747789d07c92d3bd578d8dd04471aa905b6953
+  data.tar.gz: 0b0edaae2cf9304c0af750fd3e0e0d7989f846f284a3498eb9c476e9139fda649f24c55fc877286b0f614de949b877bd14062519470dbd91aeabb81425a44b0d

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Release History
 
+### 1.0.0 / 2019-09-30
+
+#### Features
+
+* Allow wait to block for specified time
+  * Add timeout argument to Subscriber#wait! method.
+  * Document timeout argument on AsyncPublisher#wait! method.
+* Add stop! convenience method, calling both stop and wait
+  * Add Subscriber#stop! method.
+  * Add AsyncPublisher#stop! method.
+
 ### 0.39.3 / 2019-09-27
 
 #### Bug Fixes

data/lib/google/cloud/pubsub/async_publisher.rb

@@ -136,10 +136,15 @@ module Google
         end
 
         ##
-        # Blocks until the publisher is fully stopped, all pending messages
-        # have been published, and all callbacks have completed. Does not stop
-        # the publisher. To stop the publisher, first call {#stop} and then
-        # call {#wait!} to block until the publisher is stopped.
+        # Blocks until the publisher is fully stopped, all pending messages have
+        # been published, and all callbacks have completed, or until `timeout`
+        # seconds have passed.
+        #
+        # Does not stop the publisher. To stop the publisher, first call {#stop}
+        # and then call {#wait!} to block until the publisher is stopped
+        #
+        # @param [Number, nil] timeout The number of seconds to block until the
+        #   publisher is fully stopped. Default will block indefinitely.
         #
         # @return [AsyncPublisher] returns self so calls can be chained.
         def wait! timeout = nil
@@ -157,6 +162,22 @@ module Google
           self
         end
 
+        ##
+        # Stop this publisher and block until the publisher is fully stopped,
+        # all pending messages have been published, and all callbacks have
+        # completed, or until `timeout` seconds have passed.
+        #
+        # The same as calling {#stop} and {#wait!}.
+        #
+        # @param [Number, nil] timeout The number of seconds to block until the
+        #   publisher is fully stopped. Default will block indefinitely.
+        #
+        # @return [AsyncPublisher] returns self so calls can be chained.
+        def stop! timeout = nil
+          stop
+          wait! timeout
+        end
+
         ##
         # Forces all messages in the current batch to be published
         # immediately.

data/lib/google/cloud/pubsub/subscriber.rb

@@ -149,17 +149,21 @@ module Google
 
         ##
         # Blocks until the subscriber is fully stopped and all received messages
-        # have been processed or released.
+        # have been processed or released, or until `timeout` seconds have
+        # passed.
         #
         # Does not stop the subscriber. To stop the subscriber, first call
         # {#stop} and then call {#wait!} to block until the subscriber is
         # stopped.
         #
+        # @param [Number, nil] timeout The number of seconds to block until the
+        #   subscriber is fully stopped. Default will block indefinitely.
+        #
         # @return [Subscriber] returns self so calls can be chained.
-        def wait!
+        def wait! timeout = nil
           wait_pool = synchronize do
             @stream_pool.map do |stream|
-              Thread.new { stream.wait! }
+              Thread.new { stream.wait! timeout }
             end
           end
           wait_pool.map(&:join)
@@ -167,6 +171,23 @@ module Google
           self
         end
 
+        ##
+        # Stop this subscriber and block until the subscriber is fully stopped
+        # and all received messages have been processed or released, or until
+        # `timeout` seconds have passed.
+        #
+        # The same as calling {#stop} and {#wait!}.
+        #
+        # @param [Number, nil] timeout The number of seconds to block until the
+        #   subscriber is fully stopped. Default will block indefinitely.
+        #
+        # @return [Subscriber] returns self so calls can be chained.
+        #
+        def stop! timeout = nil
+          stop
+          wait! timeout
+        end
+
         ##
         # Whether the subscriber has been started.
         #

data/lib/google/cloud/pubsub/subscriber/stream.rb

@@ -107,9 +107,9 @@ module Google
             synchronize { @paused }
           end
 
-          def wait!
+          def wait! timeout = nil
             # Wait for all queued callbacks to be processed.
-            @callback_thread_pool.wait_for_termination
+            @callback_thread_pool.wait_for_termination timeout
 
             self
           end

data/lib/google/cloud/pubsub/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module PubSub
-      VERSION = "0.39.3".freeze
+      VERSION = "1.0.0".freeze
     end
 
     Pubsub = PubSub unless const_defined? :Pubsub

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub
 version: !ruby/object:Gem::Version
-  version: 0.39.3
+  version: 1.0.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-09-27 00:00:00.000000000 Z
+date: 2019-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core