google-cloud-pubsub 0.31.1 → 0.32.0

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

@@ -86,7 +86,7 @@
           "retry_params_name": "messaging"
         },
         "StreamingPull": {
-          "timeout_millis": 60000,
+          "timeout_millis": 900000,
           "retry_codes_name": "pull",
           "retry_params_name": "streaming_messaging"
         },

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Pubsub
-      VERSION = "0.31.1".freeze
+      VERSION = "0.32.0".freeze
     end
   end
 end

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

@@ -9,9 +9,13 @@ require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.pubsub.v1.MessageStoragePolicy" do
+    repeated :allowed_persistence_regions, :string, 1
+  end
   add_message "google.pubsub.v1.Topic" do
     optional :name, :string, 1
     map :labels, :string, :string, 2
+    optional :message_storage_policy, :message, 3, "google.pubsub.v1.MessageStoragePolicy"
   end
   add_message "google.pubsub.v1.PubsubMessage" do
     optional :data, :bytes, 1
@@ -51,6 +55,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     repeated :subscriptions, :string, 1
     optional :next_page_token, :string, 2
   end
+  add_message "google.pubsub.v1.ListTopicSnapshotsRequest" do
+    optional :topic, :string, 1
+    optional :page_size, :int32, 2
+    optional :page_token, :string, 3
+  end
+  add_message "google.pubsub.v1.ListTopicSnapshotsResponse" do
+    repeated :snapshots, :string, 1
+    optional :next_page_token, :string, 2
+  end
   add_message "google.pubsub.v1.DeleteTopicRequest" do
     optional :topic, :string, 1
   end
@@ -124,6 +137,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.pubsub.v1.CreateSnapshotRequest" do
     optional :name, :string, 1
     optional :subscription, :string, 2
+    map :labels, :string, :string, 3
   end
   add_message "google.pubsub.v1.UpdateSnapshotRequest" do
     optional :snapshot, :message, 1, "google.pubsub.v1.Snapshot"
@@ -135,6 +149,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :expire_time, :message, 3, "google.protobuf.Timestamp"
     map :labels, :string, :string, 4
   end
+  add_message "google.pubsub.v1.GetSnapshotRequest" do
+    optional :snapshot, :string, 1
+  end
   add_message "google.pubsub.v1.ListSnapshotsRequest" do
     optional :project, :string, 1
     optional :page_size, :int32, 2
@@ -161,6 +178,7 @@ end
 module Google
   module Pubsub
     module V1
+      MessageStoragePolicy = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.MessageStoragePolicy").msgclass
       Topic = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Topic").msgclass
       PubsubMessage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.PubsubMessage").msgclass
       GetTopicRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.GetTopicRequest").msgclass
@@ -171,6 +189,8 @@ module Google
       ListTopicsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListTopicsResponse").msgclass
       ListTopicSubscriptionsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListTopicSubscriptionsRequest").msgclass
       ListTopicSubscriptionsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListTopicSubscriptionsResponse").msgclass
+      ListTopicSnapshotsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListTopicSnapshotsRequest").msgclass
+      ListTopicSnapshotsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListTopicSnapshotsResponse").msgclass
       DeleteTopicRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DeleteTopicRequest").msgclass
       Subscription = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Subscription").msgclass
       PushConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.PushConfig").msgclass
@@ -190,6 +210,7 @@ module Google
       CreateSnapshotRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.CreateSnapshotRequest").msgclass
       UpdateSnapshotRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.UpdateSnapshotRequest").msgclass
       Snapshot = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Snapshot").msgclass
+      GetSnapshotRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.GetSnapshotRequest").msgclass
       ListSnapshotsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListSnapshotsRequest").msgclass
       ListSnapshotsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListSnapshotsResponse").msgclass
       DeleteSnapshotRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DeleteSnapshotRequest").msgclass

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

@@ -1,13 +1,13 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/pubsub/v1/pubsub.proto for package 'google.pubsub.v1'
 # Original file comments:
-# Copyright 2017 Google Inc.
+# Copyright 2018 Google Inc.
 #
 # 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
 #
-#     https://www.apache.org/licenses/LICENSE-2.0
+#     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,
@@ -22,9 +22,52 @@ require 'google/pubsub/v1/pubsub_pb'
 module Google
   module Pubsub
     module V1
+      module Publisher
+        # The service that an application uses to manipulate topics, and to send
+        # messages to a topic.
+        class Service
+
+          include GRPC::GenericService
+
+          self.marshal_class_method = :encode
+          self.unmarshal_class_method = :decode
+          self.service_name = 'google.pubsub.v1.Publisher'
+
+          # Creates the given topic with the given name. See the
+          # <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+          rpc :CreateTopic, Topic, Topic
+          # Updates an existing topic. Note that certain properties of a
+          # topic are not modifiable.
+          rpc :UpdateTopic, UpdateTopicRequest, Topic
+          # 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.
+          rpc :Publish, PublishRequest, PublishResponse
+          # Gets the configuration of a topic.
+          rpc :GetTopic, GetTopicRequest, Topic
+          # Lists matching topics.
+          rpc :ListTopics, ListTopicsRequest, ListTopicsResponse
+          # Lists the names of the subscriptions on this topic.
+          rpc :ListTopicSubscriptions, ListTopicSubscriptionsRequest, ListTopicSubscriptionsResponse
+          # Lists the names of the snapshots on this topic.<br><br>
+          # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+          # changed in backward-incompatible ways and is not recommended for production
+          # use. It is not subject to any SLA or deprecation policy.
+          rpc :ListTopicSnapshots, ListTopicSnapshotsRequest, ListTopicSnapshotsResponse
+          # 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_`.
+          rpc :DeleteTopic, DeleteTopicRequest, Google::Protobuf::Empty
+        end
+
+        Stub = Service.rpc_stub_class
+      end
       module Subscriber
         # The service that an application uses to manipulate subscriptions and to
-        # consume messages from a subscription via the `Pull` method.
+        # consume messages from a subscription via the `Pull` method or by
+        # establishing a bi-directional stream using the `StreamingPull` method.
         class Service
 
           include GRPC::GenericService
@@ -33,7 +76,8 @@ module Google
           self.unmarshal_class_method = :decode
           self.service_name = 'google.pubsub.v1.Subscriber'
 
-          # Creates a subscription to a given topic.
+          # Creates a subscription to a given topic. See the
+          # <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
           # If the subscription already exists, returns `ALREADY_EXISTS`.
           # If the corresponding topic doesn't exist, returns `NOT_FOUND`.
           #
@@ -48,10 +92,6 @@ module Google
           rpc :GetSubscription, GetSubscriptionRequest, Subscription
           # Updates an existing subscription. Note that certain properties of a
           # subscription, such as its topic, are not modifiable.
-          # NOTE:  The style guide requires body: "subscription" instead of body: "*".
-          # Keeping the latter for internal consistency in V1, however it should be
-          # corrected in V2.  See
-          # https://cloud.google.com/apis/design/standard_methods#update for details.
           rpc :UpdateSubscription, UpdateSubscriptionRequest, Subscription
           # Lists matching subscriptions.
           rpc :ListSubscriptions, ListSubscriptionsRequest, ListSubscriptionsResponse
@@ -80,18 +120,13 @@ module Google
           # there are too many concurrent pull requests pending for the given
           # subscription.
           rpc :Pull, PullRequest, PullResponse
-          # (EXPERIMENTAL) StreamingPull is an experimental feature. This RPC will
-          # respond with UNIMPLEMENTED errors unless you have been invited to test
-          # this feature. Contact cloud-pubsub@google.com with any questions.
-          #
           # Establishes a stream with the server, which sends messages down to the
           # client. The client streams acknowledgements and ack deadline modifications
           # back to the server. The server will close the stream and return the status
-          # on any error. The server may close the stream with status `OK` to reassign
-          # server-side resources, in which case, the client should re-establish the
-          # stream. `UNAVAILABLE` may also be returned in the case of a transient error
-          # (e.g., a server restart). These should also be retried by the client. Flow
-          # control can be achieved by configuring the underlying RPC channel.
+          # on any error. The server may close the stream with status `UNAVAILABLE` to
+          # reassign server-side resources, in which case, the client should
+          # re-establish the stream. Flow control can be achieved by configuring the
+          # underlying RPC channel.
           rpc :StreamingPull, stream(StreamingPullRequest), stream(StreamingPullResponse)
           # Modifies the `PushConfig` for a specified subscription.
           #
@@ -100,76 +135,55 @@ module Google
           # attributes of a push subscription. Messages will accumulate for delivery
           # continuously through the call regardless of changes to the `PushConfig`.
           rpc :ModifyPushConfig, ModifyPushConfigRequest, Google::Protobuf::Empty
-          # Lists the existing snapshots.
+          # Gets the configuration details of a snapshot.<br><br>
+          # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+          # changed in backward-incompatible ways and is not recommended for production
+          # use. It is not subject to any SLA or deprecation policy.
+          rpc :GetSnapshot, GetSnapshotRequest, Snapshot
+          # Lists the existing snapshots.<br><br>
+          # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+          # changed in backward-incompatible ways and is not recommended for production
+          # use. It is not subject to any SLA or deprecation policy.
           rpc :ListSnapshots, ListSnapshotsRequest, ListSnapshotsResponse
-          # Creates a snapshot from the requested subscription.
+          # Creates a snapshot from the requested subscription.<br><br>
+          # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+          # changed in backward-incompatible ways and is not recommended for production
+          # use. It is not subject to any SLA or deprecation policy.
           # If the snapshot already exists, returns `ALREADY_EXISTS`.
           # If the requested subscription doesn't exist, returns `NOT_FOUND`.
-          #
-          # If the name is not provided in the request, the server will assign a random
+          # If the backlog in the subscription is too old -- and the resulting snapshot
+          # would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
+          # See also the `Snapshot.expire_time` field. If the name is not provided in
+          # the request, the server will assign a random
           # name for this snapshot on the same project as the subscription, conforming
-          # to the
-          # [resource name format](https://cloud.google.com/pubsub/docs/overview#names).
-          # The generated name is populated in the returned Snapshot object.
-          # Note that for REST API requests, you must specify a name in the request.
+          # to the [resource name format](https://cloud.google.com/pubsub/docs/overview#names).
+          # The generated
+          # name is populated in the returned Snapshot object. Note that for REST API
+          # requests, you must specify a name in the request.
           rpc :CreateSnapshot, CreateSnapshotRequest, Snapshot
-          # Updates an existing snapshot. Note that certain properties of a snapshot
-          # are not modifiable.
-          # NOTE:  The style guide requires body: "snapshot" instead of body: "*".
-          # Keeping the latter for internal consistency in V1, however it should be
-          # corrected in V2.  See
-          # https://cloud.google.com/apis/design/standard_methods#update for details.
+          # Updates an existing snapshot.<br><br>
+          # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+          # changed in backward-incompatible ways and is not recommended for production
+          # use. It is not subject to any SLA or deprecation policy.
+          # Note that certain properties of a snapshot are not modifiable.
           rpc :UpdateSnapshot, UpdateSnapshotRequest, Snapshot
-          # Removes an existing snapshot. All messages retained in the snapshot
+          # Removes an existing snapshot. <br><br>
+          # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+          # changed in backward-incompatible ways and is not recommended for production
+          # use. It is not subject to any SLA or deprecation policy.
+          # When the snapshot is deleted, all messages retained in the snapshot
           # are immediately dropped. After a snapshot is deleted, a new one may be
           # created with the same name, but the new one has no association with the old
           # snapshot or its subscription, unless the same subscription is specified.
           rpc :DeleteSnapshot, DeleteSnapshotRequest, Google::Protobuf::Empty
           # Seeks an existing subscription to a point in time or to a given snapshot,
-          # whichever is provided in the request.
+          # whichever is provided in the request.<br><br>
+          # <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+          # changed in backward-incompatible ways and is not recommended for production
+          # use. It is not subject to any SLA or deprecation policy.
           rpc :Seek, SeekRequest, SeekResponse
         end
 
-        Stub = Service.rpc_stub_class
-      end
-      module Publisher
-        # The service that an application uses to manipulate topics, and to send
-        # messages to a topic.
-        class Service
-
-          include GRPC::GenericService
-
-          self.marshal_class_method = :encode
-          self.unmarshal_class_method = :decode
-          self.service_name = 'google.pubsub.v1.Publisher'
-
-          # Creates the given topic with the given name.
-          rpc :CreateTopic, Topic, Topic
-          # Updates an existing topic. Note that certain properties of a topic are not
-          # modifiable.  Options settings follow the style guide:
-          # NOTE:  The style guide requires body: "topic" instead of body: "*".
-          # Keeping the latter for internal consistency in V1, however it should be
-          # corrected in V2.  See
-          # https://cloud.google.com/apis/design/standard_methods#update for details.
-          rpc :UpdateTopic, UpdateTopicRequest, Topic
-          # 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.
-          rpc :Publish, PublishRequest, PublishResponse
-          # Gets the configuration of a topic.
-          rpc :GetTopic, GetTopicRequest, Topic
-          # Lists matching topics.
-          rpc :ListTopics, ListTopicsRequest, ListTopicsResponse
-          # Lists the name of the subscriptions for this topic.
-          rpc :ListTopicSubscriptions, ListTopicSubscriptionsRequest, ListTopicSubscriptionsResponse
-          # 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_`.
-          rpc :DeleteTopic, DeleteTopicRequest, Google::Protobuf::Empty
-        end
-
         Stub = Service.rpc_stub_class
       end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub
 version: !ruby/object:Gem::Version
-  version: 0.31.1
+  version: 0.32.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-08-14 00:00:00.000000000 Z
+date: 2018-08-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -31,14 +31,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: grpc-google-iam-v1
   requirement: !ruby/object:Gem::Requirement
@@ -137,6 +137,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -222,17 +236,21 @@ files:
 - lib/google/cloud/pubsub/subscriber/async_stream_pusher.rb
 - lib/google/cloud/pubsub/subscriber/async_unary_pusher.rb
 - lib/google/cloud/pubsub/subscriber/enumerator_queue.rb
+- lib/google/cloud/pubsub/subscriber/inventory.rb
 - lib/google/cloud/pubsub/subscriber/stream.rb
 - lib/google/cloud/pubsub/subscription.rb
 - lib/google/cloud/pubsub/subscription/list.rb
 - lib/google/cloud/pubsub/topic.rb
 - lib/google/cloud/pubsub/topic/list.rb
 - lib/google/cloud/pubsub/v1.rb
+- lib/google/cloud/pubsub/v1/credentials.rb
+- lib/google/cloud/pubsub/v1/doc/google/iam/v1/iam_policy.rb
+- lib/google/cloud/pubsub/v1/doc/google/iam/v1/policy.rb
 - lib/google/cloud/pubsub/v1/doc/google/protobuf/duration.rb
+- lib/google/cloud/pubsub/v1/doc/google/protobuf/empty.rb
 - lib/google/cloud/pubsub/v1/doc/google/protobuf/field_mask.rb
 - lib/google/cloud/pubsub/v1/doc/google/protobuf/timestamp.rb
 - lib/google/cloud/pubsub/v1/doc/google/pubsub/v1/pubsub.rb
-- lib/google/cloud/pubsub/v1/doc/overview.rb
 - lib/google/cloud/pubsub/v1/publisher_client.rb
 - lib/google/cloud/pubsub/v1/publisher_client_config.json
 - lib/google/cloud/pubsub/v1/subscriber_client.rb

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

@@ -1,75 +0,0 @@
-# Copyright 2017 Google LLC
-#
-# 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
-#
-#     https://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.
-
-module Google
-  module Cloud
-    # rubocop:disable LineLength
-
-    ##
-    # # Ruby Client for Google Cloud Pub/Sub API ([Beta](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
-    #
-    # [Google Cloud Pub/Sub API][Product Documentation]:
-    # Provides reliable, many-to-many, asynchronous messaging between applications.
-    # - [Product Documentation][]
-    #
-    # ## Quick Start
-    # In order to use this library, you first need to go through the following
-    # steps:
-    #
-    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-    # 2. [Enable the Google Cloud Pub/Sub API.](https://console.cloud.google.com/apis/api/pubsub)
-    # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
-    #
-    # ### Installation
-    # ```
-    # $ gem install google-cloud-pubsub
-    # ```
-    #
-    # ### Preview
-    # #### PublisherClient
-    # ```rb
-    # require "google/cloud/pubsub"
-    #
-    # publisher_client = Google::Cloud::Pubsub::Publisher.new
-    # formatted_project = Google::Cloud::Pubsub::V1::PublisherClient.project_path(project_id)
-    #
-    # # Iterate over all results.
-    # publisher_client.list_topics(formatted_project).each do |element|
-    #   # Process element.
-    # end
-    #
-    # # Or iterate over results one page at a time.
-    # publisher_client.list_topics(formatted_project).each_page do |page|
-    #   # Process each page at a time.
-    #   page.each do |element|
-    #     # Process element.
-    #   end
-    # end
-    # ```
-    #
-    # ### Next Steps
-    # - Read the [Google Cloud Pub/Sub API Product documentation][Product Documentation]
-    #   to learn more about the product and see How-to Guides.
-    # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
-    #   to see the full list of Cloud APIs that we cover.
-    #
-    # [Product Documentation]: https://cloud.google.com/pubsub
-    #
-    #
-    module Pubsub
-      module V1
-      end
-    end
-  end
-end