google-cloud-tasks 2.1.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8a86b2e7e3ce3a58ccb592dae831eb86ec31ae3742f431669967db048a11cff
-  data.tar.gz: 9e78fa7f2e22e69104e78cf46c94b4160ce666af21518f10c70b380c9ee2281e
+  metadata.gz: 117c09fd7b2ef0688e9312987c5506198dd5b1c83d920ec31fdee85c0140c4c9
+  data.tar.gz: 102b0b7fe0aa65dec8ed7b642eebcbd7f67bbc8d26cba7dc6ca245310649c66b
 SHA512:
-  metadata.gz: 4ef42d9e7495d06150b8e00514d57a12df400ba545fda56d622e7bc79b8c3905b8335c7752f5ed3c7d2cfedfed7fd344efa41a66a4fbc767d793889c90200e1d
-  data.tar.gz: 23fcf0b9e4e89fdbeb0ad4b401ca0b5f20c9056b2302fb3cd82f1d246a5803941d6a426ee966e084ede8781ba4d20a6defa72fd240bbf2e109766c76c1f1d943
+  metadata.gz: c9beb63408d5f71920c9ad0da5c19d1247c962e8546552b2102ee62818b3f35e16dd8dd17dd9243f1a6798d41e94195a9e2eaf49e757731e6384a9ac11b2b4a7
+  data.tar.gz: f7c53d7df9a5b54a63e93c714d7aba626ef7038e86bf1c35e621f95e9759ee08ee5746ae0c4e362519ef014ce43904b17b417616aade696a7113a313b521e9a8

data/MIGRATING.md

@@ -30,6 +30,10 @@ To summarize:
     resource paths. These methods now take keyword rather than positional
     arguments, and are also available in a separate paths module. See
     [Resource Path Helpers](#resource-path-helpers) for more info.
+ *  Previously, clients reported RPC errors by raising instances of
+    `Google::Gax::GaxError` and its subclasses. Now, RPC exceptions are of type
+    `Google::Cloud::Error` and its subclasses. See
+    [Handling Errors](#handling-errors) for more info.
  *  Some classes have moved into different namespaces. See
     [Class Namespaces](#class-namespaces) for more info.
 
@@ -240,7 +244,7 @@ In the 2.0 client, you can also use the paths module as a convenience module.
 
 New:
 ```
-# Bring the session_path method into the current class
+# Bring the path helper methods into the current class
 include Google::Cloud::Tasks::V2::CloudTasks::Paths
 
 def foo
@@ -255,6 +259,48 @@ def foo
 end
 ```
 
+### Handling Errors
+
+The client reports standard
+[gRPC error codes](https://github.com/grpc/grpc/blob/master/doc/statuscodes.md)
+by raising exceptions. In older releases, these exceptions were located in the
+`Google::Gax` namespace and were subclasses of the `Google::Gax::GaxError` base
+exception class, defined in the `google-gax` gem. However, these classes were
+different from the standard exceptions (subclasses of `Google::Cloud::Error`)
+thrown by other client libraries such as `google-cloud-storage`.
+
+The 2.0 client library now uses the `Google::Cloud::Error` exception hierarchy,
+for consistency across all the Google Cloud client libraries. In general, these
+exceptions have the same name as their counterparts from older releases, but
+are located in the `Google::Cloud` namespace rather than the `Google::Gax`
+namespace.
+
+Old:
+```
+client = Google::Cloud::Tasks.new
+
+parent = "projects/my-project/locations/-"
+
+begin
+  response = client.list_queues parent, page_size: 10
+rescue Google::Gax::Error => e
+  # Handle exceptions that subclass Google::Gax::Error
+end
+```
+
+New:
+```
+client = Google::Cloud::Tasks.cloud_tasks
+
+parent = "projects/my-project/locations/-"
+
+begin
+  response = client.list_queues parent: parent, page_size: 10
+rescue Google::Cloud::Error => e
+  # Handle exceptions that subclass Google::Cloud::Error
+end
+```
+
 ### Class Namespaces
 
 In older releases, the client object was of class

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

@@ -20,7 +20,7 @@
 module Google
   module Cloud
     module Tasks
-      VERSION = "2.1.0"
+      VERSION = "2.1.1"
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-tasks
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.1.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-20 00:00:00.000000000 Z
+date: 2020-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core