google-cloud-pubsub 0.20.0 → 0.20.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 835dfba62f6801603cf98ecfccd798ba59a575a8
-  data.tar.gz: 3c5f2bf501c861ce2fe0e42f6625707df7c54e5b
+  metadata.gz: 1ed97e68a23ababe3268559effcac9c99bfcd390
+  data.tar.gz: 35e382342f920445a7b58e13e9c32ba0c96b0cc4
 SHA512:
-  metadata.gz: 7c8a41c01358952bfb9e567ff295ba6f3626d9e5602de29df9d5463346d594b0b54eb8b756c7dcbc45d4464adfb5410401b3d984da327cf9f170e78d5a9ef1ee
-  data.tar.gz: 59186803d87e2873ea085bdbff9000f6e8eec623d076c6074ca52eac494cef2ba7c961d43fe91a0c49d13cb49970c5fbf0a9f3ded3ddede2538b6f1a2e21fe74
+  metadata.gz: a3799ef6da67d6870fb2054da570540ebef4d51f0ea56932d35a6d5bd7404a4777e87002420a68f6f2c2dd3e17973f8c6e2a45a6b672e3e77c5573b26d1851fb
+  data.tar.gz: 3a51da97b7c25e7c9819a7f56e1836f6e8fbe61d953cdb4e74bf407148514923f69437d03df899e1505b27c32f4bfa4131713f7ae4c856398f0993c17d494f4b

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

@@ -15,8 +15,8 @@
 
 require "google/cloud/errors"
 require "google/cloud/core/grpc_backoff"
-require "google/pubsub/v1/pubsub_services_pb"
-require "google/iam/v1/iam_policy_services"
+require "google/pubsub/v1/pubsub_pb"
+require "google/iam/v1/iam_policy"
 require "google/cloud/core/grpc_utils"
 require "json"
 
@@ -48,22 +48,34 @@ module Google
 
         def subscriber
           return mocked_subscriber if mocked_subscriber
-          @subscriber ||= Google::Pubsub::V1::Subscriber::Stub.new(
-            host, creds, timeout: timeout)
+          @subscriber ||= begin
+            require "google/pubsub/v1/pubsub_services_pb"
+
+            Google::Pubsub::V1::Subscriber::Stub.new(
+              host, creds, timeout: timeout)
+          end
         end
         attr_accessor :mocked_subscriber
 
         def publisher
           return mocked_publisher if mocked_publisher
-          @publisher ||= Google::Pubsub::V1::Publisher::Stub.new(
-            host, creds, timeout: timeout)
+          @publisher ||= begin
+            require "google/pubsub/v1/pubsub_services_pb"
+
+            Google::Pubsub::V1::Publisher::Stub.new(
+              host, creds, timeout: timeout)
+          end
         end
         attr_accessor :mocked_publisher
 
         def iam
           return mocked_iam if mocked_iam
-          @iam ||= Google::Iam::V1::IAMPolicy::Stub.new(
-            host, creds, timeout: timeout)
+          @iam ||= begin
+            require "google/iam/v1/iam_policy_services"
+
+            Google::Iam::V1::IAMPolicy::Stub.new(
+              host, creds, timeout: timeout)
+          end
         end
         attr_accessor :mocked_iam
 

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

@@ -0,0 +1,17 @@
+# Copyright 2015 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "google/cloud/pubsub/v1/publisher_api"
+require "google/cloud/pubsub/v1/subscriber_api"

data/lib/google/cloud/pubsub/v1/publisher_api.rb

@@ -0,0 +1,371 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# EDITING INSTRUCTIONS
+# This file was generated from the file
+# https://github.com/googleapis/googleapis/blob/master/google/pubsub/v1/pubsub.proto,
+# and updates to that file get reflected here through a refresh process.
+# For the short term, the refresh process will only be runnable by Google
+# engineers.
+#
+# The only allowed edits are to method and file documentation. A 3-way
+# merge preserves those additions if the generated source changes.
+
+require "json"
+require "pathname"
+
+require "google/gax"
+require "google/pubsub/v1/pubsub_services_pb"
+
+module Google
+  module Cloud
+    module Pubsub
+      module V1
+        # The service that an application uses to manipulate topics, and to send
+        # messages to a topic.
+        #
+        # @!attribute [r] stub
+        #   @return [Google::Pubsub::V1::Publisher::Stub]
+        class PublisherApi
+          attr_reader :stub
+
+          # The default address of the service.
+          SERVICE_ADDRESS = "pubsub.googleapis.com".freeze
+
+          # The default port of the service.
+          DEFAULT_SERVICE_PORT = 443
+
+          CODE_GEN_NAME_VERSION = "gapic/0.1.0".freeze
+
+          DEFAULT_TIMEOUT = 30
+
+          PAGE_DESCRIPTORS = {
+            "list_topics" => Google::Gax::PageDescriptor.new(
+              "page_token",
+              "next_page_token",
+              "topics"),
+            "list_topic_subscriptions" => Google::Gax::PageDescriptor.new(
+              "page_token",
+              "next_page_token",
+              "subscriptions")
+          }.freeze
+
+          private_constant :PAGE_DESCRIPTORS
+
+          BUNDLE_DESCRIPTORS = {
+            "publish" => Google::Gax::BundleDescriptor.new(
+              "messages",
+              [
+                "topic"
+              ],
+              subresponse_field: "message_ids")
+          }.freeze
+
+          private_constant :BUNDLE_DESCRIPTORS
+
+          # The scopes needed to make gRPC calls to all of the methods defined in
+          # this service.
+          ALL_SCOPES = [
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/pubsub"
+          ].freeze
+
+          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}"
+          )
+
+          private_constant :PROJECT_PATH_TEMPLATE
+
+          TOPIC_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/topics/{topic}"
+          )
+
+          private_constant :TOPIC_PATH_TEMPLATE
+
+          # Returns a fully-qualified project resource name string.
+          # @param project [String]
+          # @return [String]
+          def self.project_path project
+            PROJECT_PATH_TEMPLATE.render(
+              :"project" => project
+            )
+          end
+
+          # Returns a fully-qualified topic resource name string.
+          # @param project [String]
+          # @param topic [String]
+          # @return [String]
+          def self.topic_path project, topic
+            TOPIC_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"topic" => topic
+            )
+          end
+
+          # Parses the project from a project resource.
+          # @param project_name [String]
+          # @return [String]
+          def self.match_project_from_project_name project_name
+            PROJECT_PATH_TEMPLATE.match(project_name)["project"]
+          end
+
+          # Parses the project from a topic resource.
+          # @param topic_name [String]
+          # @return [String]
+          def self.match_project_from_topic_name topic_name
+            TOPIC_PATH_TEMPLATE.match(topic_name)["project"]
+          end
+
+          # Parses the topic from a topic resource.
+          # @param topic_name [String]
+          # @return [String]
+          def self.match_topic_from_topic_name topic_name
+            TOPIC_PATH_TEMPLATE.match(topic_name)["topic"]
+          end
+
+          # @param service_path [String]
+          #   The domain name of the API remote host.
+          # @param port [Integer]
+          #   The port on which to connect to the remote host.
+          # @param channel [Channel]
+          #   A Channel object through which to make calls.
+          # @param chan_creds [Grpc::ChannelCredentials]
+          #   A ChannelCredentials for the setting up the RPC client.
+          # @param client_config[Hash]
+          #   A Hash for call options for each method. See
+          #   Google::Gax#construct_settings for the structure of
+          #   this data. Falls back to the default config if not specified
+          #   or the specified config is missing data points.
+          # @param timeout [Numeric]
+          #   The default timeout, in seconds, for calls made through this client.
+          # @param app_name [String]
+          #   The codename of the calling service.
+          # @param app_version [String]
+          #   The version of the calling service.
+          def initialize \
+              service_path: SERVICE_ADDRESS,
+              port: DEFAULT_SERVICE_PORT,
+              channel: nil,
+              chan_creds: nil,
+              scopes: ALL_SCOPES,
+              client_config: {},
+              timeout: DEFAULT_TIMEOUT,
+              app_name: "gax",
+              app_version: Google::Gax::VERSION
+            google_api_client = "#{app_name}/#{app_version} " \
+              "#{CODE_GEN_NAME_VERSION} ruby/#{RUBY_VERSION}".freeze
+            headers = { :"x-goog-api-client" => google_api_client }
+            client_config_file = Pathname.new(__dir__).join(
+              "publisher_client_config.json"
+            )
+            defaults = client_config_file.open do |f|
+              Google::Gax.construct_settings(
+                "google.pubsub.v1.Publisher",
+                JSON.parse(f.read),
+                client_config,
+                Google::Gax::Grpc::STATUS_CODE_NAMES,
+                timeout,
+                bundle_descriptors: BUNDLE_DESCRIPTORS,
+                page_descriptors: PAGE_DESCRIPTORS,
+                errors: Google::Gax::Grpc::API_ERRORS,
+                kwargs: headers
+              )
+            end
+            @stub = Google::Gax::Grpc.create_stub(
+              service_path,
+              port,
+              chan_creds: chan_creds,
+              channel: channel,
+              scopes: scopes,
+              &Google::Pubsub::V1::Publisher::Stub.method(:new)
+            )
+
+            @create_topic = Google::Gax.create_api_call(
+              @stub.method(:create_topic),
+              defaults["create_topic"]
+            )
+            @publish = Google::Gax.create_api_call(
+              @stub.method(:publish),
+              defaults["publish"]
+            )
+            @get_topic = Google::Gax.create_api_call(
+              @stub.method(:get_topic),
+              defaults["get_topic"]
+            )
+            @list_topics = Google::Gax.create_api_call(
+              @stub.method(:list_topics),
+              defaults["list_topics"]
+            )
+            @list_topic_subscriptions = Google::Gax.create_api_call(
+              @stub.method(:list_topic_subscriptions),
+              defaults["list_topic_subscriptions"]
+            )
+            @delete_topic = Google::Gax.create_api_call(
+              @stub.method(:delete_topic),
+              defaults["delete_topic"]
+            )
+          end
+
+          # Service calls
+
+          # Creates the given topic with the given name.
+          #
+          # @param name [String]
+          #   The name of the topic. It must have the format
+          #   +"projects/{project}/topics/{topic}"+. +{topic}+ must start with a letter,
+          #   and contain only letters (+[A-Za-z]+), numbers (+[0-9]+), dashes (+-+),
+          #   underscores (+_+), periods (+.+), tildes (+~+), plus (+++) or percent
+          #   signs (+%+). It must be between 3 and 255 characters in length, and it
+          #   must not start with +"goog"+.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Pubsub::V1::Topic]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def create_topic \
+              name,
+              options: nil
+            req = Google::Pubsub::V1::Topic.new(
+              name: name
+            )
+            @create_topic.call(req, options)
+          end
+
+          # Adds one or more messages to the topic. Returns +NOT_FOUND+ if the topic
+          # does not exist. The message payload must not be empty; it must contain
+          #  either a non-empty data field, or at least one attribute.
+          #
+          # @param topic [String]
+          #   The messages in the request will be published on this topic.
+          # @param messages [Array<Google::Pubsub::V1::PubsubMessage>]
+          #   The messages to publish.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Pubsub::V1::PublishResponse]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def publish \
+              topic,
+              messages,
+              options: nil
+            req = Google::Pubsub::V1::PublishRequest.new(
+              topic: topic,
+              messages: messages
+            )
+            @publish.call(req, options)
+          end
+
+          # Gets the configuration of a topic.
+          #
+          # @param topic [String]
+          #   The name of the topic to get.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Pubsub::V1::Topic]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def get_topic \
+              topic,
+              options: nil
+            req = Google::Pubsub::V1::GetTopicRequest.new(
+              topic: topic
+            )
+            @get_topic.call(req, options)
+          end
+
+          # Lists matching topics.
+          #
+          # @param project [String]
+          #   The name of the cloud project that topics belong to.
+          # @param page_size [Integer]
+          #   The maximum number of resources contained in the underlying API
+          #   response. If page streaming is performed per-resource, this
+          #   parameter does not affect the return value. If page streaming is
+          #   performed per-page, this determines the maximum number of
+          #   resources in a page.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Gax::PagedEnumerable<Google::Pubsub::V1::Topic>]
+          #   An enumerable of Google::Pubsub::V1::Topic instances.
+          #   See Google::Gax::PagedEnumerable documentation for other
+          #   operations such as per-page iteration or access to the response
+          #   object.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def list_topics \
+              project,
+              page_size: nil,
+              options: nil
+            req = Google::Pubsub::V1::ListTopicsRequest.new(
+              project: project
+            )
+            req.page_size = page_size unless page_size.nil?
+            @list_topics.call(req, options)
+          end
+
+          # Lists the name of the subscriptions for this topic.
+          #
+          # @param topic [String]
+          #   The name of the topic that subscriptions are attached to.
+          # @param page_size [Integer]
+          #   The maximum number of resources contained in the underlying API
+          #   response. If page streaming is performed per-resource, this
+          #   parameter does not affect the return value. If page streaming is
+          #   performed per-page, this determines the maximum number of
+          #   resources in a page.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Gax::PagedEnumerable<String>]
+          #   An enumerable of String instances.
+          #   See Google::Gax::PagedEnumerable documentation for other
+          #   operations such as per-page iteration or access to the response
+          #   object.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def list_topic_subscriptions \
+              topic,
+              page_size: nil,
+              options: nil
+            req = Google::Pubsub::V1::ListTopicSubscriptionsRequest.new(
+              topic: topic
+            )
+            req.page_size = page_size unless page_size.nil?
+            @list_topic_subscriptions.call(req, options)
+          end
+
+          # Deletes the topic with the given name. Returns +NOT_FOUND+ if the topic
+          # does not exist. After a topic is deleted, a new topic may be created with
+          # the same name; this is an entirely new topic with none of the old
+          # configuration or subscriptions. Existing subscriptions to this topic are
+          # not deleted, but their +topic+ field is set to +_deleted-topic_+.
+          #
+          # @param topic [String]
+          #   Name of the topic to delete.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def delete_topic \
+              topic,
+              options: nil
+            req = Google::Pubsub::V1::DeleteTopicRequest.new(
+              topic: topic
+            )
+            @delete_topic.call(req, options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/pubsub/v1/publisher_client_config.json

@@ -0,0 +1,78 @@
+{
+  "interfaces": {
+    "google.pubsub.v1.Publisher": {
+      "retry_codes": {
+        "retry_codes_def": {
+          "idempotent": [
+            "DEADLINE_EXCEEDED",
+            "UNAVAILABLE"
+          ],
+          "one_plus_delivery": [
+            "DEADLINE_EXCEEDED",
+            "UNAVAILABLE"
+          ],
+          "non_idempotent": []
+        }
+      },
+      "retry_params": {
+        "default": {
+          "initial_retry_delay_millis": 100,
+          "retry_delay_multiplier": 1.3,
+          "max_retry_delay_millis": 60000,
+          "initial_rpc_timeout_millis": 60000,
+          "rpc_timeout_multiplier": 1.0,
+          "max_rpc_timeout_millis": 60000,
+          "total_timeout_millis": 600000
+        },
+        "messaging": {
+          "initial_retry_delay_millis": 100,
+          "retry_delay_multiplier": 1.3,
+          "max_retry_delay_millis": 60000,
+          "initial_rpc_timeout_millis": 12000,
+          "rpc_timeout_multiplier": 1.0,
+          "max_rpc_timeout_millis": 12000,
+          "total_timeout_millis": 600000
+        }
+      },
+      "methods": {
+        "CreateTopic": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "Publish": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "one_plus_delivery",
+          "retry_params_name": "messaging",
+          "bundling": {
+            "element_count_threshold": 10,
+            "element_count_limit": 1000,
+            "request_byte_threshold": 1024,
+            "request_byte_limit": 10485760,
+            "delay_threshold_millis": 10
+          }
+        },
+        "GetTopic": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "ListTopics": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "ListTopicSubscriptions": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "DeleteTopic": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        }
+      }
+    }
+  }
+}

data/lib/google/cloud/pubsub/v1/subscriber_api.rb

@@ -0,0 +1,503 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# EDITING INSTRUCTIONS
+# This file was generated from the file
+# https://github.com/googleapis/googleapis/blob/master/google/pubsub/v1/pubsub.proto,
+# and updates to that file get reflected here through a refresh process.
+# For the short term, the refresh process will only be runnable by Google
+# engineers.
+#
+# The only allowed edits are to method and file documentation. A 3-way
+# merge preserves those additions if the generated source changes.
+
+require "json"
+require "pathname"
+
+require "google/gax"
+require "google/pubsub/v1/pubsub_services_pb"
+
+module Google
+  module Cloud
+    module Pubsub
+      module V1
+        # The service that an application uses to manipulate subscriptions and to
+        # consume messages from a subscription via the +Pull+ method.
+        #
+        # @!attribute [r] stub
+        #   @return [Google::Pubsub::V1::Subscriber::Stub]
+        class SubscriberApi
+          attr_reader :stub
+
+          # The default address of the service.
+          SERVICE_ADDRESS = "pubsub.googleapis.com".freeze
+
+          # The default port of the service.
+          DEFAULT_SERVICE_PORT = 443
+
+          CODE_GEN_NAME_VERSION = "gapic/0.1.0".freeze
+
+          DEFAULT_TIMEOUT = 30
+
+          PAGE_DESCRIPTORS = {
+            "list_subscriptions" => Google::Gax::PageDescriptor.new(
+              "page_token",
+              "next_page_token",
+              "subscriptions")
+          }.freeze
+
+          private_constant :PAGE_DESCRIPTORS
+
+          # The scopes needed to make gRPC calls to all of the methods defined in
+          # this service.
+          ALL_SCOPES = [
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/pubsub"
+          ].freeze
+
+          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}"
+          )
+
+          private_constant :PROJECT_PATH_TEMPLATE
+
+          SUBSCRIPTION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/subscriptions/{subscription}"
+          )
+
+          private_constant :SUBSCRIPTION_PATH_TEMPLATE
+
+          TOPIC_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/topics/{topic}"
+          )
+
+          private_constant :TOPIC_PATH_TEMPLATE
+
+          # Returns a fully-qualified project resource name string.
+          # @param project [String]
+          # @return [String]
+          def self.project_path project
+            PROJECT_PATH_TEMPLATE.render(
+              :"project" => project
+            )
+          end
+
+          # Returns a fully-qualified subscription resource name string.
+          # @param project [String]
+          # @param subscription [String]
+          # @return [String]
+          def self.subscription_path project, subscription
+            SUBSCRIPTION_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"subscription" => subscription
+            )
+          end
+
+          # Returns a fully-qualified topic resource name string.
+          # @param project [String]
+          # @param topic [String]
+          # @return [String]
+          def self.topic_path project, topic
+            TOPIC_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"topic" => topic
+            )
+          end
+
+          # Parses the project from a project resource.
+          # @param project_name [String]
+          # @return [String]
+          def self.match_project_from_project_name project_name
+            PROJECT_PATH_TEMPLATE.match(project_name)["project"]
+          end
+
+          # Parses the project from a subscription resource.
+          # @param subscription_name [String]
+          # @return [String]
+          def self.match_project_from_subscription_name subscription_name
+            SUBSCRIPTION_PATH_TEMPLATE.match(subscription_name)["project"]
+          end
+
+          # Parses the subscription from a subscription resource.
+          # @param subscription_name [String]
+          # @return [String]
+          def self.match_subscription_from_subscription_name subscription_name
+            SUBSCRIPTION_PATH_TEMPLATE.match(subscription_name)["subscription"]
+          end
+
+          # Parses the project from a topic resource.
+          # @param topic_name [String]
+          # @return [String]
+          def self.match_project_from_topic_name topic_name
+            TOPIC_PATH_TEMPLATE.match(topic_name)["project"]
+          end
+
+          # Parses the topic from a topic resource.
+          # @param topic_name [String]
+          # @return [String]
+          def self.match_topic_from_topic_name topic_name
+            TOPIC_PATH_TEMPLATE.match(topic_name)["topic"]
+          end
+
+          # @param service_path [String]
+          #   The domain name of the API remote host.
+          # @param port [Integer]
+          #   The port on which to connect to the remote host.
+          # @param channel [Channel]
+          #   A Channel object through which to make calls.
+          # @param chan_creds [Grpc::ChannelCredentials]
+          #   A ChannelCredentials for the setting up the RPC client.
+          # @param client_config[Hash]
+          #   A Hash for call options for each method. See
+          #   Google::Gax#construct_settings for the structure of
+          #   this data. Falls back to the default config if not specified
+          #   or the specified config is missing data points.
+          # @param timeout [Numeric]
+          #   The default timeout, in seconds, for calls made through this client.
+          # @param app_name [String]
+          #   The codename of the calling service.
+          # @param app_version [String]
+          #   The version of the calling service.
+          def initialize \
+              service_path: SERVICE_ADDRESS,
+              port: DEFAULT_SERVICE_PORT,
+              channel: nil,
+              chan_creds: nil,
+              scopes: ALL_SCOPES,
+              client_config: {},
+              timeout: DEFAULT_TIMEOUT,
+              app_name: "gax",
+              app_version: Google::Gax::VERSION
+            google_api_client = "#{app_name}/#{app_version} " \
+              "#{CODE_GEN_NAME_VERSION} ruby/#{RUBY_VERSION}".freeze
+            headers = { :"x-goog-api-client" => google_api_client }
+            client_config_file = Pathname.new(__dir__).join(
+              "subscriber_client_config.json"
+            )
+            defaults = client_config_file.open do |f|
+              Google::Gax.construct_settings(
+                "google.pubsub.v1.Subscriber",
+                JSON.parse(f.read),
+                client_config,
+                Google::Gax::Grpc::STATUS_CODE_NAMES,
+                timeout,
+                page_descriptors: PAGE_DESCRIPTORS,
+                errors: Google::Gax::Grpc::API_ERRORS,
+                kwargs: headers
+              )
+            end
+            @stub = Google::Gax::Grpc.create_stub(
+              service_path,
+              port,
+              chan_creds: chan_creds,
+              channel: channel,
+              scopes: scopes,
+              &Google::Pubsub::V1::Subscriber::Stub.method(:new)
+            )
+
+            @create_subscription = Google::Gax.create_api_call(
+              @stub.method(:create_subscription),
+              defaults["create_subscription"]
+            )
+            @get_subscription = Google::Gax.create_api_call(
+              @stub.method(:get_subscription),
+              defaults["get_subscription"]
+            )
+            @list_subscriptions = Google::Gax.create_api_call(
+              @stub.method(:list_subscriptions),
+              defaults["list_subscriptions"]
+            )
+            @delete_subscription = Google::Gax.create_api_call(
+              @stub.method(:delete_subscription),
+              defaults["delete_subscription"]
+            )
+            @modify_ack_deadline = Google::Gax.create_api_call(
+              @stub.method(:modify_ack_deadline),
+              defaults["modify_ack_deadline"]
+            )
+            @acknowledge = Google::Gax.create_api_call(
+              @stub.method(:acknowledge),
+              defaults["acknowledge"]
+            )
+            @pull = Google::Gax.create_api_call(
+              @stub.method(:pull),
+              defaults["pull"]
+            )
+            @modify_push_config = Google::Gax.create_api_call(
+              @stub.method(:modify_push_config),
+              defaults["modify_push_config"]
+            )
+          end
+
+          # Service calls
+
+          # Creates a subscription to a given topic for a given subscriber.
+          # If the subscription already exists, returns +ALREADY_EXISTS+.
+          # If the corresponding topic doesn't exist, returns +NOT_FOUND+.
+          #
+          # If the name is not provided in the request, the server will assign a random
+          # name for this subscription on the same project as the topic.
+          #
+          # @param name [String]
+          #   The name of the subscription. It must have the format
+          #   +"projects/{project}/subscriptions/{subscription}"+. +{subscription}+ must
+          #   start with a letter, and contain only letters (+[A-Za-z]+), numbers
+          #   (+[0-9]+), dashes (+-+), underscores (+_+), periods (+.+), tildes (+~+),
+          #   plus (+++) or percent signs (+%+). It must be between 3 and 255 characters
+          #   in length, and it must not start with +"goog"+.
+          # @param topic [String]
+          #   The name of the topic from which this subscription is receiving messages.
+          #   The value of this field will be +_deleted-topic_+ if the topic has been
+          #   deleted.
+          # @param push_config [Google::Pubsub::V1::PushConfig]
+          #   If push delivery is used with this subscription, this field is
+          #   used to configure it. An empty +pushConfig+ signifies that the subscriber
+          #   will pull and ack messages using API methods.
+          # @param ack_deadline_seconds [Integer]
+          #   This value is the maximum time after a subscriber receives a message
+          #   before the subscriber should acknowledge the message. After message
+          #   delivery but before the ack deadline expires and before the message is
+          #   acknowledged, it is an outstanding message and will not be delivered
+          #   again during that time (on a best-effort basis).
+          #
+          #   For pull subscriptions, this value is used as the initial value for the ack
+          #   deadline. To override this value for a given message, call
+          #   +ModifyAckDeadline+ with the corresponding +ack_id+ if using
+          #   pull.
+          #
+          #   For push delivery, this value is also used to set the request timeout for
+          #   the call to the push endpoint.
+          #
+          #   If the subscriber never acknowledges the message, the Pub/Sub
+          #   system will eventually redeliver the message.
+          #
+          #   If this parameter is not set, the default value of 10 seconds is used.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Pubsub::V1::Subscription]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def create_subscription \
+              name,
+              topic,
+              push_config: nil,
+              ack_deadline_seconds: nil,
+              options: nil
+            req = Google::Pubsub::V1::Subscription.new(
+              name: name,
+              topic: topic
+            )
+            req.push_config = push_config unless push_config.nil?
+            req.ack_deadline_seconds = ack_deadline_seconds unless ack_deadline_seconds.nil?
+            @create_subscription.call(req, options)
+          end
+
+          # Gets the configuration details of a subscription.
+          #
+          # @param subscription [String]
+          #   The name of the subscription to get.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Pubsub::V1::Subscription]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def get_subscription \
+              subscription,
+              options: nil
+            req = Google::Pubsub::V1::GetSubscriptionRequest.new(
+              subscription: subscription
+            )
+            @get_subscription.call(req, options)
+          end
+
+          # Lists matching subscriptions.
+          #
+          # @param project [String]
+          #   The name of the cloud project that subscriptions belong to.
+          # @param page_size [Integer]
+          #   The maximum number of resources contained in the underlying API
+          #   response. If page streaming is performed per-resource, this
+          #   parameter does not affect the return value. If page streaming is
+          #   performed per-page, this determines the maximum number of
+          #   resources in a page.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Gax::PagedEnumerable<Google::Pubsub::V1::Subscription>]
+          #   An enumerable of Google::Pubsub::V1::Subscription instances.
+          #   See Google::Gax::PagedEnumerable documentation for other
+          #   operations such as per-page iteration or access to the response
+          #   object.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def list_subscriptions \
+              project,
+              page_size: nil,
+              options: nil
+            req = Google::Pubsub::V1::ListSubscriptionsRequest.new(
+              project: project
+            )
+            req.page_size = page_size unless page_size.nil?
+            @list_subscriptions.call(req, options)
+          end
+
+          # Deletes an existing subscription. All pending messages in the subscription
+          # are immediately dropped. Calls to +Pull+ after deletion will return
+          # +NOT_FOUND+. After a subscription is deleted, a new one may be created with
+          # the same name, but the new one has no association with the old
+          # subscription, or its topic unless the same topic is specified.
+          #
+          # @param subscription [String]
+          #   The subscription to delete.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def delete_subscription \
+              subscription,
+              options: nil
+            req = Google::Pubsub::V1::DeleteSubscriptionRequest.new(
+              subscription: subscription
+            )
+            @delete_subscription.call(req, options)
+          end
+
+          # Modifies the ack deadline for a specific message. This method is useful
+          # to indicate that more time is needed to process a message by the
+          # subscriber, or to make the message available for redelivery if the
+          # processing was interrupted.
+          #
+          # @param subscription [String]
+          #   The name of the subscription.
+          # @param ack_ids [Array<String>]
+          #   List of acknowledgment IDs.
+          # @param ack_deadline_seconds [Integer]
+          #   The new ack deadline with respect to the time this request was sent to
+          #   the Pub/Sub system. Must be >= 0. For example, if the value is 10, the new
+          #   ack deadline will expire 10 seconds after the +ModifyAckDeadline+ call
+          #   was made. Specifying zero may immediately make the message available for
+          #   another pull request.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def modify_ack_deadline \
+              subscription,
+              ack_ids,
+              ack_deadline_seconds,
+              options: nil
+            req = Google::Pubsub::V1::ModifyAckDeadlineRequest.new(
+              subscription: subscription,
+              ack_ids: ack_ids,
+              ack_deadline_seconds: ack_deadline_seconds
+            )
+            @modify_ack_deadline.call(req, options)
+          end
+
+          # Acknowledges the messages associated with the +ack_ids+ in the
+          # +AcknowledgeRequest+. The Pub/Sub system can remove the relevant messages
+          # from the subscription.
+          #
+          # Acknowledging a message whose ack deadline has expired may succeed,
+          # but such a message may be redelivered later. Acknowledging a message more
+          # than once will not result in an error.
+          #
+          # @param subscription [String]
+          #   The subscription whose message is being acknowledged.
+          # @param ack_ids [Array<String>]
+          #   The acknowledgment ID for the messages being acknowledged that was returned
+          #   by the Pub/Sub system in the +Pull+ response. Must not be empty.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def acknowledge \
+              subscription,
+              ack_ids,
+              options: nil
+            req = Google::Pubsub::V1::AcknowledgeRequest.new(
+              subscription: subscription,
+              ack_ids: ack_ids
+            )
+            @acknowledge.call(req, options)
+          end
+
+          # Pulls messages from the server. Returns an empty list if there are no
+          # messages available in the backlog. The server may return +UNAVAILABLE+ if
+          # there are too many concurrent pull requests pending for the given
+          # subscription.
+          #
+          # @param subscription [String]
+          #   The subscription from which messages should be pulled.
+          # @param return_immediately [true, false]
+          #   If this is specified as true the system will respond immediately even if
+          #   it is not able to return a message in the +Pull+ response. Otherwise the
+          #   system is allowed to wait until at least one message is available rather
+          #   than returning no messages. The client may cancel the request if it does
+          #   not wish to wait any longer for the response.
+          # @param max_messages [Integer]
+          #   The maximum number of messages returned for this request. The Pub/Sub
+          #   system may return fewer than the number specified.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Pubsub::V1::PullResponse]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def pull \
+              subscription,
+              max_messages,
+              return_immediately: nil,
+              options: nil
+            req = Google::Pubsub::V1::PullRequest.new(
+              subscription: subscription,
+              max_messages: max_messages
+            )
+            req.return_immediately = return_immediately unless return_immediately.nil?
+            @pull.call(req, options)
+          end
+
+          # Modifies the +PushConfig+ for a specified subscription.
+          #
+          # This may be used to change a push subscription to a pull one (signified by
+          # an empty +PushConfig+) or vice versa, or change the endpoint URL and other
+          # attributes of a push subscription. Messages will accumulate for delivery
+          # continuously through the call regardless of changes to the +PushConfig+.
+          #
+          # @param subscription [String]
+          #   The name of the subscription.
+          # @param push_config [Google::Pubsub::V1::PushConfig]
+          #   The push configuration for future deliveries.
+          #
+          #   An empty +pushConfig+ indicates that the Pub/Sub system should
+          #   stop pushing messages from the given subscription and allow
+          #   messages to be pulled and acknowledged - effectively pausing
+          #   the subscription if +Pull+ is not called.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          def modify_push_config \
+              subscription,
+              push_config,
+              options: nil
+            req = Google::Pubsub::V1::ModifyPushConfigRequest.new(
+              subscription: subscription,
+              push_config: push_config
+            )
+            @modify_push_config.call(req, options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/pubsub/v1/subscriber_client_config.json

@@ -0,0 +1,77 @@
+{
+  "interfaces": {
+    "google.pubsub.v1.Subscriber": {
+      "retry_codes": {
+        "retry_codes_def": {
+          "idempotent": [
+            "DEADLINE_EXCEEDED",
+            "UNAVAILABLE"
+          ],
+          "non_idempotent": []
+        }
+      },
+      "retry_params": {
+        "default": {
+          "initial_retry_delay_millis": 100,
+          "retry_delay_multiplier": 1.3,
+          "max_retry_delay_millis": 60000,
+          "initial_rpc_timeout_millis": 60000,
+          "rpc_timeout_multiplier": 1.0,
+          "max_rpc_timeout_millis": 60000,
+          "total_timeout_millis": 600000
+        },
+        "messaging": {
+          "initial_retry_delay_millis": 100,
+          "retry_delay_multiplier": 1.3,
+          "max_retry_delay_millis": 60000,
+          "initial_rpc_timeout_millis": 12000,
+          "rpc_timeout_multiplier": 1.0,
+          "max_rpc_timeout_millis": 12000,
+          "total_timeout_millis": 600000
+        }
+      },
+      "methods": {
+        "CreateSubscription": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "GetSubscription": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "ListSubscriptions": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "DeleteSubscription": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "ModifyAckDeadline": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "Acknowledge": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "messaging"
+        },
+        "Pull": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "messaging"
+        },
+        "ModifyPushConfig": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        }
+      }
+    }
+  }
+}

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Pubsub
-      VERSION = "0.20.0"
+      VERSION = "0.20.1"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.20.1
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-27 00:00:00.000000000 Z
+date: 2016-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -67,6 +67,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: google-gax
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.4
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -200,6 +214,11 @@ files:
 - lib/google/cloud/pubsub/topic.rb
 - lib/google/cloud/pubsub/topic/list.rb
 - lib/google/cloud/pubsub/topic/publisher.rb
+- lib/google/cloud/pubsub/v1.rb
+- lib/google/cloud/pubsub/v1/publisher_api.rb
+- lib/google/cloud/pubsub/v1/publisher_client_config.json
+- lib/google/cloud/pubsub/v1/subscriber_api.rb
+- lib/google/cloud/pubsub/v1/subscriber_client_config.json
 - lib/google/cloud/pubsub/version.rb
 - lib/google/iam/v1/iam_policy.rb
 - lib/google/iam/v1/iam_policy_services.rb