google-cloud-text_to_speech 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d59186996a1418b65e467a28e6df399fb77db0850b98b872ede8726ad63fd514
-  data.tar.gz: 87585f82c0f93f943c669e0fc0ea75b5c3cd5a6344402b07b054ee42ea4c97a5
+  metadata.gz: 7644a242f0fdb02d68e4fd6ecd7a56b8787e28b693e8ac5a6c6b74ec8fdf9abf
+  data.tar.gz: fe457fd08ebdc624063122203c4e906d63cc89f33eaff67f4ad220c7352fa02c
 SHA512:
-  metadata.gz: feb2984e799bc2539ae858d26c83fa0773577f54587b066d44e812846d1fcacf231f8cd4eb497836c8647ca6b8b257caee44d20d9a89d0cd72d26465cb8c2c7d
-  data.tar.gz: 5dbfdd112c6adfe3b3d89677ab0e7519b9ae642d8c08055e4a7d090ccd039ca4cdd5ff4fef50119caf817ff7ed2932eaec8fadbc4b5cb70742e8a9e08526a5f3
+  metadata.gz: ad9950862c86f20a973d1b487154da13dc82cc970423e1b5970107ba31a88172393b80e617a05f14bb0a8bf8bda64b99c8f2c2d175fb6aeb1e89af40399c7a01
+  data.tar.gz: e0f94c1b174c911c64e99b14e24ff0c97425c78e542be2fd352d73c2ee60fa5a56b72bc07352f6af05a2abc03a5fc96df8d1c88eda8057453513de38bd644574

data/MIGRATING.md

@@ -26,6 +26,10 @@ To summarize:
     specifies whether they are required or optional. Additionally, you can pass
     a proto request object instead of separate arguments. See
     [Passing Arguments](#passing-arguments) 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.
 
@@ -207,6 +211,53 @@ response = client.synthesize_speech(
 )
 ```
 
+### 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::TextToSpeech.new
+
+input = { text: "Hello, world!" }
+voice = { language_code: "en-US" }
+audio = { audio_encoding: Google::Cloud::Texttospeech::V1::AudioEncoding::MP3 }
+
+begin
+  response = client.synthesize_speech input, voice, audio
+rescue Google::Gax::Error => e
+  # Handle exceptions that subclass Google::Gax::Error
+end
+```
+
+New:
+```
+client = Google::Cloud::TextToSpeech.text_to_speech
+
+input = { text: "Hello, world!" }
+voice = { language_code: "en-US" }
+audio = { audio_encoding: Google::Cloud::TextToSpeech::V1::AudioEncoding::MP3 }
+
+begin
+  response = client.synthesize_speech input: input, voice: voice,
+                                      audio_config: audio
+rescue Google::Cloud::Error => e
+  # Handle exceptions that subclass Google::Cloud::Error
+end
+```
+
 ### Class Namespaces
 
 In older releases, some data type (protobuf) classes were located under the module

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

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-text_to_speech
 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