google-cloud-language 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0e161151fa7a8c3ceaa9a034696d7831d8914541629ade9d5b75b9758b59b22
-  data.tar.gz: d849567e45b3b163e85842190047cec6b2df94867409df9e6632e41ef60287d1
+  metadata.gz: dc1193cbacb5d36f6b34cfab3d90e39e68c1ebe00014fc830589f697b1c2b102
+  data.tar.gz: e7646dcbb3930c4b2eb8cd9c675394431b7ef381ee91ee6e6948364ddd71e3c5
 SHA512:
-  metadata.gz: 91ab7af520fc9138a7562ea21a10059f1c0f8a35994a1aa8b9af510c9b74c681e62f9917fe1a61c25832c36e4f82f2f19edaa5f8348f3292a59e18a13c572df9
-  data.tar.gz: 79e65cb79e1ca8b87f1334fde53887e1685d271d045c13c83f9235f9ac4e7a56dd8671bcfaddb504b5c7fc129aebb692146428abd2d2fff1cfc20549aa2d6a0e
+  metadata.gz: 9e75189339140c7dfd71b1b71dc6b67f73beec0a6fc05529b027b29515ff2bf3ec7bbcbc6de6890f5eb0a079c3b14d4c66328702f2c17ab58deb0ac7041b4c41
+  data.tar.gz: 768af4b94d592bf21d0199c10dcc1b3ee19c81380cad10fd245e4e915236aa2eb3bb2a91fd63d280b9edcdb8efb12f924263c8496974a8369f86bdf887669c66

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.
 
@@ -216,6 +220,56 @@ response = client.analyze_sentiment(
 )
 ```
 
+### 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::Language.new
+
+document = {
+  content: "I love API calls!",
+  type: Google::Cloud::Language::V1::Document::Type::PLAIN_TEXT
+}
+encoding = Google:Cloud::Language::V1::EncodingType::UTF8
+
+begin
+  response = client.analyze_sentiment document, encoding_type: encoding
+rescue Google::Gax::Error => e
+  # Handle exceptions that subclass Google::Gax::Error
+end
+```
+
+New:
+```
+client = Google::Cloud::Language.language_service
+
+document = {
+  content: "I love API calls!",
+  type: Google::Cloud::Language::V1::Document::Type::PLAIN_TEXT
+}
+encoding = Google:Cloud::Language::V1::EncodingType::UTF8
+
+begin
+  response = client.analyze_sentiment document: document, encoding_type: encoding
+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/language/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Language
-      VERSION = "1.2.0".freeze
+      VERSION = "1.2.1".freeze
     end
   end
 end

metadata

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