google-cloud-web_risk 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2eb3417bc81eaf1b42b43e84f71b4cc37cce7d4a17f40cbc9fb067efe5b37b4
-  data.tar.gz: 8fc77bac242a0ab0c307ffe39274dd3c2dfae10f64ab1d16497702a7b81789bc
+  metadata.gz: 2741793e5ba601d0e4462f549c6eb09ba3d4af736e1e75decf292c53a3928241
+  data.tar.gz: 71a312ca78ec23068213f3f60aadc475a4526f2cef59e2f659f9002ddbf070c5
 SHA512:
-  metadata.gz: 799fbbf13a1926cab3fda8151bff14d3f8428e8a1e27e65ac24822d8f937127dc89243b5208301471e4c191c70e7c4aa99d60e71a34730affe73a1bf4c1f23bd
-  data.tar.gz: 4b5b89f28490b1a14a87a2af9f49d128601cc82c045f7eb4109ac7361cd40108e3087c49ef6c0a27edccc8986cff50ff45d76763119f873c40dfd6f853411b68
+  metadata.gz: b3135cfb4b1f33518f89e472d7b8422539e5d13332d67203083aa75f50a1646d23c28fbc4b9448aa83ede4e824260a944540ffe751330f5f4a43f6f1f6725c61
+  data.tar.gz: f87adb333824db667f56d10aeecd82fe157f422f22f8fe6164c54157a448ddbfce5aa54af235c76d1e9426cc878ec05f6a961695f5aaf57f732ccc2f96d1b299

data/MIGRATING.md

@@ -30,6 +30,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.
 
 ### Library Structure
 
@@ -227,3 +231,47 @@ response = client.search_uris(
   timeout: 10.0
 )
 ```
+
+### Handling Errors
+
+The client reports standard
+[gRPC error codes](https://github.com/grpc/grpc/blob/master/doc/statuscodes.md)
+by raising exceptions. In the older gem, 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 new 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::Webrisk.new
+
+uri = "http://example.com"
+threat_types = [Google::Cloud::Webrisk::V1beta1::ThreatType::MALWARE]
+
+begin
+  response = client.search_uris uri, threat_types
+rescue Google::Gax::Error => e
+  # Handle exceptions that subclass Google::Gax::Error
+end
+```
+
+New:
+```
+client = Google::Cloud::WebRisk.web_risk_service
+
+uri = "http://example.com"
+threat_types = [Google::Cloud::WebRisk::V1::ThreatType::MALWARE]
+
+begin
+  response = client.search_uris uri: uri, threat_types: threat_types
+rescue Google::Cloud::Error => e
+  # Handle exceptions that subclass Google::Cloud::Error
+end
+```

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

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-web_risk
 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-21 00:00:00.000000000 Z
+date: 2020-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core