google-cloud-dataproc 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f490c691026a7dea6c4172dc329b0a233e0093615533dd7ed5c78a2d06b713a
-  data.tar.gz: f9f2d0efd7b4e432da2a0d94f660f5294dc86ac65c3ee2c6b530bea432b5915a
+  metadata.gz: ec0383e9af4e2ae871bcd10490149741e39c5407113b7ae613f9a43bd80f3fcb
+  data.tar.gz: 2b0101a2d521cc9a15af428908b3ecc0acc072b791878b57b7670dd278b0b013
 SHA512:
-  metadata.gz: 494d784605041d8a2ede9b08a23f52313c0b06f468dea60505bac7d80873ece77584736453a58280d5930fda35a68c92bdf88700af0787a7b221a2c4ec5efdce
-  data.tar.gz: 110bf1049f497a6985aaa1f047687fab7646e57050393613c165d02bc16f472ee502ebc2005f74a956766a63b95af02b09767dc351760353fbcc0dd5a607caea
+  metadata.gz: 1d642b1169e3edadbc3b19eb2453fc69b0fa720694079a25317acd7a6df1367b3add424e41d14ba40dcbf395fde6a0a99646b6bf9c41b9b8da6839db0e1c9156
+  data.tar.gz: d113a8e467db3c44067b0b69f7818b302ea9f5856fa3c9da099da5792f49af99f9d01ebbfa06e6b6af0f5dd20201c453f063e9a16c135a749bbb54f2bbf84dbe

data/MIGRATING.md

@@ -29,6 +29,10 @@ To summarize:
     resource paths. These paths are now instance methods on the client objects,
     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.
 
@@ -274,7 +278,7 @@ Finally, in the 1.0 client, you can also use the paths module as a convenience m
 
 New:
 ```
-# Bring the session_path method into the current class
+# Bring the path helper methods into the current class
 include Google::Cloud::Dataproc::V1::WorkflowTemplateService::Paths
 
 def foo
@@ -291,6 +295,53 @@ 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 1.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::Dataproc::ClusterController.new
+
+project_id = "my-project"
+region = "us-central1"
+cluster_name = "my_cluster"
+
+begin
+  response = client.get_cluster project_id, region, cluster_name
+rescue Google::Gax::Error => e
+  # Handle exceptions that subclass Google::Gax::Error
+end
+```
+
+New:
+```
+client = Google::Cloud::Dataproc.cluster_controller
+
+project_id = "my-project"
+region = "us-central1"
+cluster_name = "my_cluster"
+
+begin
+  response = client.get_cluster project_id: project_id, region: region,
+                                cluster_name: cluster_name
+rescue Google::Cloud::Error => e
+  # Handle exceptions that subclass Google::Cloud::Error
+end
+```
+
 ### Class Namespaces
 
 In older releases, the client object was of classes with names like:

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

@@ -20,7 +20,7 @@
 module Google
   module Cloud
     module Dataproc
-      VERSION = "1.1.0"
+      VERSION = "1.1.1"
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-dataproc
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.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