google-cloud-firestore 0.21.1 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a0e9fff59882f2965b8f56086b8627ec80d55275535bd889aa5a87c7c0877ff
-  data.tar.gz: d9e8f986e2fd220cd68179e6c2cd1e3c3795dcd2f45ba6a8c050d255f01bd99f
+  metadata.gz: 96192127f7ee4dafde2959f7d1f463fb7fa24ab09055e7764e6f83fd0aeda8be
+  data.tar.gz: 4848935ba22ddc1b1cb9a24825a03802651d9dfc206b3d93a71af91b4e06eb8d
 SHA512:
-  metadata.gz: 478dc298a9f6fd09b99c297e84c30e615ab7fe1e9ac6b5fa1b9f6eeb5c427719f96714cb3fc0ecb53bfe230c15b80a6b11a885692028bfdff3ed56b4acec49c9
-  data.tar.gz: 002bd881ad0a3bbe61ed09e69b3395577a63c1e1a8af8584256dc974d609108b047a8de3f2bd08dcd3dba263be48ae9cb31f30f1294d13cb0cf050cbd1970f62
+  metadata.gz: 523e76c8d3829de28395b9fffd54dc2cd098e08cbc204836ae6836f85f29028b36721b2f66ebb455e5d1895b9d19c1cd1c23f5aee4fffae0842a9df897ce227b
+  data.tar.gz: 5ec65a1d3ecce996ab3a1d344495df11f84e5cce44d1932c1aea44aa877e5acf7a5e4fec9f7661ff6eb9c49a99db7c2d17109d825a0f5ee2959efe9e6bf73b34

data/README.md

@@ -18,7 +18,37 @@ steps:
 $ gem install google-cloud-firestore
 ```
 
-### Supported Ruby Versions
+### Next Steps
+- Read the [Client Library Documentation][] for Google Cloud Firestore API
+  to see other available methods on the client.
+- Read the [Google Cloud Firestore API Product documentation][Product Documentation]
+  to learn more about the product and see How-to Guides.
+- View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
+  to see the full list of Cloud APIs that we cover.
+
+## Enabling Logging
+
+To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library. The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below, or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger) that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb) and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+
+Configuring a Ruby stdlib logger:
+
+```ruby
+require "logger"
+
+module MyLogger
+  LOGGER = Logger.new $stderr, level: Logger::WARN
+  def logger
+    LOGGER
+  end
+end
+
+# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+module GRPC
+  extend MyLogger
+end
+```
+
+## Supported Ruby Versions
 
 This library is supported on Ruby 2.0+.
 
@@ -29,13 +59,5 @@ supported by Ruby Core (that is, Ruby versions that are either in normal
 maintenance or in security maintenance).
 See https://www.ruby-lang.org/en/downloads/branches/ for further details.
 
-### Next Steps
-- Read the [Client Library Documentation][] for Google Cloud Firestore API
-  to see other available methods on the client.
-- Read the [Google Cloud Firestore API Product documentation][Product Documentation]
-  to learn more about the product and see How-to Guides.
-- View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
-  to see the full list of Cloud APIs that we cover.
-
 [Client Library Documentation]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-firestore/latest/google/firestore/v1beta1
 [Product Documentation]: https://cloud.google.com/firestore

data/lib/google/cloud/firestore.rb

@@ -40,6 +40,39 @@ module Google
     # options for connecting in the [Authentication
     # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
     #
+    # ## Enabling Logging
+    #
+    # To enable logging for this library, set the logger for the underlying
+    # [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library. The
+    # logger that you set may be a Ruby stdlib
+    # [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html)
+    # as shown below, or a
+    # [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+    # that will write logs to [Stackdriver
+    # Logging](https://cloud.google.com/logging/). See
+    # [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+    # and the gRPC
+    # [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb)
+    # for additional information.
+    #
+    # Configuring a Ruby stdlib logger:
+    #
+    # ```ruby
+    # require "logger"
+    #
+    # module MyLogger
+    #   LOGGER = Logger.new $stderr, level: Logger::WARN
+    #   def logger
+    #     LOGGER
+    #   end
+    # end
+    #
+    # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+    # module GRPC
+    #   extend MyLogger
+    # end
+    # ```
+    #
     # ## Adding data
     #
     # Cloud Firestore stores data in Documents, which are stored in Collections.

data/lib/google/cloud/firestore/convert.rb

@@ -70,7 +70,7 @@ module Google
             when :string_value
               value.string_value
             when :bytes_value
-              StringIO.new Base64.decode64 value.bytes_value
+              StringIO.new value.bytes_value
             when :reference_value
               Google::Cloud::Firestore::DocumentReference.from_path \
                 value.reference_value, context
@@ -115,8 +115,7 @@ module Google
             elsif obj.respond_to?(:read) && obj.respond_to?(:rewind)
               obj.rewind
               content = obj.read.force_encoding "ASCII-8BIT"
-              encoded_content = Base64.strict_encode64 content
-              Google::Firestore::V1beta1::Value.new bytes_value: encoded_content
+              Google::Firestore::V1beta1::Value.new bytes_value: content
             else
               raise ArgumentError,
                    "A value of type #{obj.class} is not supported."

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Firestore
-      VERSION = "0.21.1".freeze
+      VERSION = "0.22.0".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-firestore
 version: !ruby/object:Gem::Version
-  version: 0.21.1
+  version: 0.22.0
 platform: ruby
 authors:
 - Google Inc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-24 00:00:00.000000000 Z
+date: 2018-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core