google-cloud-pubsub 0.37.1 → 0.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ca95d3d409fb3fd3061e5e9bb0e34eed7d8efdd3677c4de6e34dbed26499eae
-  data.tar.gz: e7a16095e21f9a166461cbecbc4c95a4895421762da8c644a866cbce95a0e19b
+  metadata.gz: 7d5381a504110817167a469d767b176debfe597ba4388de028485ef49118cc83
+  data.tar.gz: 83915c1329784d01e58d208dff9e713417d768a26a2924e54f3e7ab48edfd453
 SHA512:
-  metadata.gz: 2ad6bd6779827fcd87e613832f7a47cc73331615dcd3564d223776cea9d8469890829a7c2f8dd5bd989f1ffb5147c2fc8197086ce3e32994d40786c38141e1d7
-  data.tar.gz: f056480612e86fac7b2339067dae67c6d393cfc0864d30dcba8a492f3db25d6e6e269385d00dd5e85fd9de22d00cc577227b557e18aa4f3fe5f0244d1416c0d2
+  metadata.gz: ce37e8734b042325330222d29672abf5f7f77334b4bc03d21ff234aefdd5c9865edb4e6c0c33660855f229f9cc8c3c6ce06bb42db0e0d0edf45adb564523a9ff
+  data.tar.gz: 3c5da92014d6c54983930b380146f86c79a5ab7474b17d1bb3361f1c13418d513836045ff5f6211f244185694bde54465cceebf95e598842145727219597a453

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Release History
 
+### 0.38.0 / 2019-07-31
+
+* Allow persistence_regions to be set
+  * Support setting persistence_regions on topic creation
+    and topic update.
+* Allow Service endpoint to be configured
+  * Google::Cloud::PubSub.configure.endpoint
+* Fix max threads setting in thread pools
+  * Thread pools once again limit the number of threads allocated.
+* Reduce thread usage at startup
+  * Allocate threads in pool as needed, not all up front
+* Update documentation links
+
 ### 0.37.1 / 2019-07-09
 
 * Add IAM GetPolicyOptions in the lower-level interface.

data/LOGGING.md

@@ -5,7 +5,7 @@ To enable logging for this library, set the logger for the underlying
 that you set may be a Ruby stdlib
 [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as
 shown below, or a
-[`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/Google/Cloud/Logging/Logger)
+[`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 that will write logs to [Stackdriver
 Logging](https://cloud.google.com/logging/). See
 [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)

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

@@ -193,9 +193,9 @@ module Google
 
         def init_resources!
           @first_published_at   ||= Time.now
-          @publish_thread_pool  ||= Concurrent::CachedThreadPool.new \
+          @publish_thread_pool  ||= Concurrent::ThreadPoolExecutor.new \
             max_threads: @publish_threads
-          @callback_thread_pool ||= Concurrent::CachedThreadPool.new \
+          @callback_thread_pool ||= Concurrent::ThreadPoolExecutor.new \
             max_threads: @callback_threads
           @thread ||= Thread.new { run_background }
         end

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

@@ -174,6 +174,9 @@ module Google
         # @param [String] kms_key The Cloud KMS encryption key that will be used
         #   to protect access to messages published on this topic. Optional.
         #   For example: `projects/a/locations/b/keyRings/c/cryptoKeys/d`
+        # @param [Array<String>] persistence_regions The list of GCP region IDs
+        #   where messages that are published to the topic may be persisted in
+        #   storage. Optional.
         # @param [Hash] async A hash of values to configure the topic's
         #   {AsyncPublisher} that is created when {Topic#publish_async}
         #   is called. Optional.
@@ -202,11 +205,13 @@ module Google
         #   pubsub = Google::Cloud::PubSub.new
         #   topic = pubsub.create_topic "my-topic"
         #
-        def create_topic topic_name, labels: nil, kms_key: nil, async: nil
+        def create_topic topic_name, labels: nil, kms_key: nil,
+                         persistence_regions: nil, async: nil
           ensure_service!
           grpc = service.create_topic topic_name,
-                                      labels:       labels,
-                                      kms_key_name: kms_key
+                                      labels:              labels,
+                                      kms_key_name:        kms_key,
+                                      persistence_regions: persistence_regions
           Topic.from_grpc grpc, service, async: async
         end
         alias new_topic create_topic

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

@@ -126,12 +126,21 @@ module Google
 
         ##
         # Creates the given topic with the given name.
-        def create_topic topic_name, labels: nil, kms_key_name: nil, options: {}
+        def create_topic topic_name, labels: nil, kms_key_name: nil,
+                         persistence_regions: nil, options: {}
+          if persistence_regions
+            message_storage_policy = {
+              allowed_persistence_regions: Array(persistence_regions)
+            }
+          end
+
           execute do
-            publisher.create_topic topic_path(topic_name, options),
-                                   labels:       labels,
-                                   kms_key_name: kms_key_name,
-                                   options:      default_options
+            publisher.create_topic \
+              topic_path(topic_name, options),
+              labels:                 labels,
+              kms_key_name:           kms_key_name,
+              message_storage_policy: message_storage_policy,
+              options:                default_options
           end
         end
 

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

@@ -48,7 +48,7 @@ module Google
             @pause_cond = new_cond
 
             @inventory = Inventory.new self, @subscriber.stream_inventory
-            @callback_thread_pool = Concurrent::CachedThreadPool.new \
+            @callback_thread_pool = Concurrent::ThreadPoolExecutor.new \
               max_threads: @subscriber.callback_threads
 
             @stream_keepalive_task = Concurrent::TimerTask.new(

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

@@ -201,7 +201,7 @@ module Google
           end
 
           def with_threadpool
-            pool = Concurrent::CachedThreadPool.new \
+            pool = Concurrent::ThreadPoolExecutor.new \
               max_threads: @subscriber.push_threads
 
             yield pool

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

@@ -212,6 +212,30 @@ module Google
           Array @grpc.message_storage_policy.allowed_persistence_regions
         end
 
+        ##
+        # Sets the list of GCP region IDs where messages that are published to
+        # the topic may be persisted in storage.
+        #
+        # @param [Array<String>] new_persistence_regions
+        #
+        # @example
+        #   require "google/cloud/pubsub"
+        #
+        #   pubsub = Google::Cloud::PubSub.new
+        #
+        #   topic = pubsub.topic "my-topic"
+        #
+        #   topic.persistence_regions = ["us-central1", "us-central2"]
+        #
+        def persistence_regions= new_persistence_regions
+          update_grpc = Google::Cloud::PubSub::V1::Topic.new \
+            name: name, message_storage_policy: {
+              allowed_persistence_regions: Array(new_persistence_regions)
+            }
+          @grpc = service.update_topic update_grpc, :message_storage_policy
+          @resource_name = nil
+        end
+
         ##
         # Permanently deletes the topic.
         #

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

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

data/lib/google/cloud/pubsub.rb

@@ -111,6 +111,7 @@ module Google
         PubSub::Project.new(
           PubSub::Service.new(
             project_id, credentials, timeout:       timeout,
+                                     host:          configure.endpoint,
                                      client_config: client_config
           )
         )
@@ -136,6 +137,8 @@ module Google
       # * `timeout` - (Integer) Default timeout to use in requests.
       # * `client_config` - (Hash) A hash of values to override the default
       #   behavior of the API client.
+      # * `endpoint` - (String) Override of the endpoint host name, or `nil`
+      #   to use the default endpoint.
       # * `emulator_host` - (String) Host name of the emulator. Defaults to
       #   `ENV["PUBSUB_EMULATOR_HOST"]`
       # * `on_error` - (Proc) A Proc to be run when an error is encountered

data/lib/google-cloud-pubsub.rb

@@ -143,4 +143,5 @@ Google::Cloud.configure.add_config! :pubsub do |config|
   config.add_field! :emulator_host, default_emulator,
                     match: String, allow_nil: true
   config.add_field! :on_error, nil, match: Proc
+  config.add_field! :endpoint, nil, match: String
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub
 version: !ruby/object:Gem::Version
-  version: 0.37.1
+  version: 0.38.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-10 00:00:00.000000000 Z
+date: 2019-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -306,7 +306,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.4
 signing_key: 
 specification_version: 4
 summary: API Client library for Google Cloud Pub/Sub