google-cloud-speech 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 386e482dd167bd00b1bdf21ba06663d3ad97142d7a9982c2588bd5511865a571
-  data.tar.gz: 8c432052d0acbcc7d062ca51f618bd4e91839c2745b5e95310ae792b3dc91d65
+  metadata.gz: 739b2fc36b5ef0e935a5aba33a9b9514f6c977f6612ad645bb10284ce6031144
+  data.tar.gz: 9aea715a82dec588f3c92bfd8cd372267caf77da276a138e06dcde9f7c046ed1
 SHA512:
-  metadata.gz: fed8b322e431f842a7bcb3c377561d401d945ba6e925815a1f4f2e1844a52b703eea7397c01ea71f1a21e464c90ff786c17e65ae04e84f4dd85ef084f171ef2d
-  data.tar.gz: c67d1bd0f64f72f61293a8047556735ab7131142e89ca7c9e2d9c414e9500e5a2462964d050ee2db70e7ccd3245c80dc15740c48b3f3606bbeaa1ede1491a098
+  metadata.gz: 5b7e8a0c5332a6a12cab3fcf5276d703b44369b8085cd4ee84fc31ce015b87e16534f25845e2062dd7ceb9d8759c7485d0b90aa915950140fc4bdd0a3969e7e0
+  data.tar.gz: deeb990df0900e437ec5bdaf59a4f76fd462cb9129a0830a5b7a6cbf94f805c21788770fa143e61ff50d05f231e9ba9bada466b10184dbdd536f33d357c94743

data/MIGRATING.md

@@ -30,6 +30,10 @@ To summarize:
     current client retains this method, but simplifies the interface to match
     streaming methods in other Ruby clients. See
     [Streaming Interface](#streaming-interface) 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.
 
@@ -288,6 +292,62 @@ output_stream.each do |response|
 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::Speech.new
+
+config = {
+  language_code: "en-US",
+  sample_rate_hertz: 44_100,
+  encoding: :FLAC
+}
+audio = {
+  uri: "gs://cloud-samples-data/speech/brooklyn_bridge.flac"
+}
+
+begin
+  response = client.recognize config, audio
+rescue Google::Gax::Error => e
+  # Handle exceptions that subclass Google::Gax::Error
+end
+```
+
+New:
+```
+client = Google::Cloud::Speech.speech
+
+config = {
+  language_code: "en-US",
+  sample_rate_hertz: 44_100,
+  encoding: :FLAC
+}
+audio = {
+  uri: "gs://cloud-samples-data/speech/brooklyn_bridge.flac"
+}
+
+begin
+  response = client.recognize config: config, audio: audio
+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/speech/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Speech
-      VERSION = "1.1.0".freeze
+      VERSION = "1.1.1".freeze
     end
   end
 end

metadata

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