google-cloud-pubsub 1.4.0 → 1.7.1

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

@@ -7,9 +7,14 @@
           "UNAVAILABLE",
           "UNKNOWN"
         ],
+        "non_idempotent2": [],
         "non_idempotent": [
           "UNAVAILABLE"
         ],
+        "idempotent2": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ],
         "none": [],
         "publish": [
           "ABORTED",
@@ -79,6 +84,11 @@
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
+        "ListTopicSnapshots": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent2",
+          "retry_params_name": "default"
+        },
         "DeleteTopic": {
           "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
@@ -98,6 +108,11 @@
           "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
+        },
+        "DetachSubscription": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent2",
+          "retry_params_name": "default"
         }
       }
     }

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

@@ -307,6 +307,14 @@ module Google
                 {'subscription' => request.subscription}
               end
             )
+            @get_snapshot = Google::Gax.create_api_call(
+              @subscriber_stub.method(:get_snapshot),
+              defaults["get_snapshot"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'snapshot' => request.snapshot}
+              end
+            )
             @modify_ack_deadline = Google::Gax.create_api_call(
               @subscriber_stub.method(:modify_ack_deadline),
               defaults["modify_ack_deadline"],
@@ -501,6 +509,14 @@ module Google
           #   value for `expiration_policy.ttl` is 1 day.
           #   A hash of the same form as `Google::Cloud::PubSub::V1::ExpirationPolicy`
           #   can also be provided.
+          # @param filter [String]
+          #   An expression written in the Cloud Pub/Sub filter language. If non-empty,
+          #   then only `PubsubMessage`s whose `attributes` field matches the filter are
+          #   delivered on this subscription. If empty, then no messages are filtered
+          #   out.
+          #   <b>EXPERIMENTAL:</b> This feature is part of a closed 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.
           # @param dead_letter_policy [Google::Cloud::PubSub::V1::DeadLetterPolicy | Hash]
           #   A policy that specifies the conditions for dead lettering messages in
           #   this subscription. If dead_letter_policy is not set, dead lettering
@@ -510,11 +526,21 @@ module Google
           #   parent project (i.e.,
           #   service-\\{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
           #   permission to Acknowledge() messages on this subscription.
-          #   <b>EXPERIMENTAL:</b> This feature is part of a closed 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.
           #   A hash of the same form as `Google::Cloud::PubSub::V1::DeadLetterPolicy`
           #   can also be provided.
+          # @param retry_policy [Google::Cloud::PubSub::V1::RetryPolicy | Hash]
+          #   A policy that specifies how Cloud Pub/Sub retries message delivery for this
+          #   subscription.
+          #
+          #   If not set, the default retry policy is applied. This generally implies
+          #   that messages will be retried as soon as possible for healthy subscribers.
+          #   RetryPolicy will be triggered on NACKs or acknowledgement deadline
+          #   exceeded events for a given message.
+          #   <b>EXPERIMENTAL:</b> 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.
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::RetryPolicy`
+          #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -541,7 +567,9 @@ module Google
               labels: nil,
               enable_message_ordering: nil,
               expiration_policy: nil,
+              filter: nil,
               dead_letter_policy: nil,
+              retry_policy: nil,
               options: nil,
               &block
             req = {
@@ -554,7 +582,9 @@ module Google
               labels: labels,
               enable_message_ordering: enable_message_ordering,
               expiration_policy: expiration_policy,
-              dead_letter_policy: dead_letter_policy
+              filter: filter,
+              dead_letter_policy: dead_letter_policy,
+              retry_policy: retry_policy
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::Subscription)
             @create_subscription.call(req, options, &block)
@@ -725,6 +755,41 @@ module Google
             nil
           end
 
+          # Gets the configuration details of a snapshot. Snapshots are used in
+          # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+          # operations, which allow you to manage message acknowledgments in bulk. That
+          # is, you can set the acknowledgment state of messages in an existing
+          # subscription to the state captured by a snapshot.
+          #
+          # @param snapshot [String]
+          #   Required. The name of the snapshot to get.
+          #   Format is `projects/{project}/snapshots/{snap}`.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::PubSub::V1::Snapshot]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::PubSub::V1::Snapshot]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub"
+          #
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_snapshot = Google::Cloud::PubSub::V1::SubscriberClient.snapshot_path("[PROJECT]", "[SNAPSHOT]")
+          #   response = subscriber_client.get_snapshot(formatted_snapshot)
+
+          def get_snapshot \
+              snapshot,
+              options: nil,
+              &block
+            req = {
+              snapshot: snapshot
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::GetSnapshotRequest)
+            @get_snapshot.call(req, options, &block)
+          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
@@ -1254,8 +1319,8 @@ module Google
           # Sets the access control policy on the specified resource. Replaces
           # any existing policy.
           #
-          # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
-          # PERMISSION_DENIED
+          # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`
+          # errors.
           #
           # @param resource [String]
           #   REQUIRED: The resource for which the policy is being specified.
@@ -1279,11 +1344,13 @@ module Google
           #   require "google/cloud/pubsub"
           #
           #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
-          #   formatted_resource = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #
+          #   # TODO: Initialize `resource`:
+          #   resource = ''
           #
           #   # TODO: Initialize `policy`:
           #   policy = {}
-          #   response = subscriber_client.set_iam_policy(formatted_resource, policy)
+          #   response = subscriber_client.set_iam_policy(resource, policy)
 
           def set_iam_policy \
               resource,
@@ -1321,8 +1388,10 @@ module Google
           #   require "google/cloud/pubsub"
           #
           #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
-          #   formatted_resource = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
-          #   response = subscriber_client.get_iam_policy(formatted_resource)
+          #
+          #   # TODO: Initialize `resource`:
+          #   resource = ''
+          #   response = subscriber_client.get_iam_policy(resource)
 
           def get_iam_policy \
               resource,
@@ -1339,7 +1408,7 @@ module Google
 
           # Returns permissions that a caller has on the specified resource. If the
           # resource does not exist, this will return an empty set of
-          # permissions, not a NOT_FOUND error.
+          # permissions, not a `NOT_FOUND` error.
           #
           # Note: This operation is designed to be used for building
           # permission-aware UIs and command-line tools, not for authorization
@@ -1365,11 +1434,13 @@ module Google
           #   require "google/cloud/pubsub"
           #
           #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
-          #   formatted_resource = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #
+          #   # TODO: Initialize `resource`:
+          #   resource = ''
           #
           #   # TODO: Initialize `permissions`:
           #   permissions = []
-          #   response = subscriber_client.test_iam_permissions(formatted_resource, permissions)
+          #   response = subscriber_client.test_iam_permissions(resource, permissions)
 
           def test_iam_permissions \
               resource,

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

@@ -10,6 +10,10 @@
         "non_idempotent": [
           "UNAVAILABLE"
         ],
+        "idempotent2": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ],
         "streaming_pull": [
           "ABORTED",
           "DEADLINE_EXCEEDED",
@@ -73,6 +77,11 @@
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
+        "GetSnapshot": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent2",
+          "retry_params_name": "default"
+        },
         "ModifyAckDeadline": {
           "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",

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

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

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

@@ -73,6 +73,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.pubsub.v1.DeleteTopicRequest" do
     optional :topic, :string, 1
   end
+  add_message "google.pubsub.v1.DetachSubscriptionRequest" do
+    optional :subscription, :string, 1
+  end
+  add_message "google.pubsub.v1.DetachSubscriptionResponse" do
+  end
   add_message "google.pubsub.v1.Subscription" do
     optional :name, :string, 1
     optional :topic, :string, 2
@@ -83,7 +88,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     map :labels, :string, :string, 9
     optional :enable_message_ordering, :bool, 10
     optional :expiration_policy, :message, 11, "google.pubsub.v1.ExpirationPolicy"
+    optional :filter, :string, 12
     optional :dead_letter_policy, :message, 13, "google.pubsub.v1.DeadLetterPolicy"
+    optional :retry_policy, :message, 14, "google.pubsub.v1.RetryPolicy"
+  end
+  add_message "google.pubsub.v1.RetryPolicy" do
+    optional :minimum_backoff, :message, 1, "google.protobuf.Duration"
+    optional :maximum_backoff, :message, 2, "google.protobuf.Duration"
   end
   add_message "google.pubsub.v1.DeadLetterPolicy" do
     optional :dead_letter_topic, :string, 1
@@ -222,7 +233,10 @@ module Google::Cloud::PubSub::V1
   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
+  DetachSubscriptionRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DetachSubscriptionRequest").msgclass
+  DetachSubscriptionResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DetachSubscriptionResponse").msgclass
   Subscription = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Subscription").msgclass
+  RetryPolicy = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.RetryPolicy").msgclass
   DeadLetterPolicy = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DeadLetterPolicy").msgclass
   ExpirationPolicy = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ExpirationPolicy").msgclass
   PushConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.PushConfig").msgclass

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

@@ -53,7 +53,7 @@ module Google::Cloud::PubSub::V1
       rpc :GetTopic, GetTopicRequest, Topic
       # Lists matching topics.
       rpc :ListTopics, ListTopicsRequest, ListTopicsResponse
-      # Lists the names of the subscriptions on this topic.
+      # Lists the names of the attached subscriptions on this topic.
       rpc :ListTopicSubscriptions, ListTopicSubscriptionsRequest, ListTopicSubscriptionsResponse
       # Lists the names of the snapshots on this topic. Snapshots are used in
       # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
@@ -68,6 +68,11 @@ module Google::Cloud::PubSub::V1
       # 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
+      # Detaches a subscription from this topic. All messages retained in the
+      # subscription are dropped. Subsequent `Pull` and `StreamingPull` requests
+      # will return FAILED_PRECONDITION. If the subscription is a push
+      # subscription, pushes to the endpoint will stop.
+      rpc :DetachSubscription, DetachSubscriptionRequest, DetachSubscriptionResponse
     end
 
     Stub = Service.rpc_stub_class

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.7.1
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-11 00:00:00.000000000 Z
+date: 2020-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -141,14 +141,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.10'
+        version: '5.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.10'
+        version: '5.14'
 - !ruby/object:Gem::Dependency
   name: minitest-autotest
   requirement: !ruby/object:Gem::Requirement
@@ -278,6 +278,7 @@ files:
 - lib/google/cloud/pubsub/project.rb
 - lib/google/cloud/pubsub/publish_result.rb
 - lib/google/cloud/pubsub/received_message.rb
+- lib/google/cloud/pubsub/retry_policy.rb
 - lib/google/cloud/pubsub/service.rb
 - lib/google/cloud/pubsub/snapshot.rb
 - lib/google/cloud/pubsub/snapshot/list.rb