google-cloud-datastore-v1 0.3.5 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa99477dff9c2ddb432fa51e5714ecdc61e7179a259b19093c2feb102bfdaef4
-  data.tar.gz: a4161c7bc6daad45e845631819dddf8b8746e5052df3f6859712251b7ab26166
+  metadata.gz: 5756bbbfdf9b930addfb17ff508cd1ff58e698c1381a922a2a1d06c442cc3499
+  data.tar.gz: '0087211fa2c48a1c58801db241b387eb29543cabe28c5eca2b290ab96c0370cd'
 SHA512:
-  metadata.gz: c2f9f6e7b0b4a631dc31aa8170a9b7d0828acaaabfd28a0bda14d6c8906e58b07de7942a8c2bd1b1e89b4279a7561e33998bbdecbb783e10462b76df7ba1036a
-  data.tar.gz: dc8e68bcda3b91ec4115fb1c30a265e0866df16d76fa0a0870fbf34d0c4e93b98e1194b684d5873497bc20be4968c366c9322c973c4fa91e5fff4c288a4c21c2
+  metadata.gz: df7ce1dd9962a3e286eab555739ccbd3223b937b53d98f0f68ed5a3b2b3d2e163832f7298e8202e08c961b18788a1de3e7ce8ceec3576009e7ec3522576fedf0
+  data.tar.gz: e37399f05e9dae3dbec09a7c9f3d4d56cc525d76cda7ccf42b9da787246e387348f034bc5496e3c446c14a325eeba256adb01c4734fe6e85cea999d27c057452

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::Datastore::V1::LookupRequest.new # (request fields as
 response = client.lookup request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-datastore-v1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-datastore-v1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/datastore)
@@ -69,16 +69,21 @@ module GRPC
 end
 ```
 
+
+## Google Cloud Samples
+
+To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
+
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 2.6+.
 
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Currently, this means Ruby 2.5
-and later. Older versions of Ruby _may_ still work, but are unsupported and not
-recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
-about the Ruby support schedule.
+in security maintenance, and not end of life. Older versions of Ruby _may_
+still work, but are unsupported and not recommended. See
+https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
+support schedule.
 
 ## Which client should I use?
 

data/lib/google/cloud/datastore/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Datastore
       module V1
-        VERSION = "0.3.5"
+        VERSION = "0.6.0"
       end
     end
   end

data/lib/google/cloud/datastore/v1.rb

@@ -25,6 +25,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/datastore/v1"
       #     client = ::Google::Cloud::Datastore::V1::Datastore::Client.new
       #

data/lib/google/datastore/v1/datastore_pb.rb

@@ -1,12 +1,14 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/datastore/v1/datastore.proto
 
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/datastore/v1/entity_pb'
 require 'google/datastore/v1/query_pb'
-require 'google/protobuf'
+require 'google/protobuf/timestamp_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/datastore/v1/datastore.proto", :syntax => :proto3) do
@@ -19,6 +21,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :found, :message, 1, "google.datastore.v1.EntityResult"
       repeated :missing, :message, 2, "google.datastore.v1.EntityResult"
       repeated :deferred, :message, 3, "google.datastore.v1.Key"
+      optional :read_time, :message, 7, "google.protobuf.Timestamp"
     end
     add_message "google.datastore.v1.RunQueryRequest" do
       optional :project_id, :string, 8
@@ -62,6 +65,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.datastore.v1.CommitResponse" do
       repeated :mutation_results, :message, 3, "google.datastore.v1.MutationResult"
       optional :index_updates, :int32, 4
+      optional :commit_time, :message, 8, "google.protobuf.Timestamp"
     end
     add_message "google.datastore.v1.AllocateIdsRequest" do
       optional :project_id, :string, 8
@@ -86,17 +90,20 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       end
       oneof :conflict_detection_strategy do
         optional :base_version, :int64, 8
+        optional :update_time, :message, 11, "google.protobuf.Timestamp"
       end
     end
     add_message "google.datastore.v1.MutationResult" do
       optional :key, :message, 3, "google.datastore.v1.Key"
       optional :version, :int64, 4
+      optional :update_time, :message, 6, "google.protobuf.Timestamp"
       optional :conflict_detected, :bool, 5
     end
     add_message "google.datastore.v1.ReadOptions" do
       oneof :consistency_type do
         optional :read_consistency, :enum, 1, "google.datastore.v1.ReadOptions.ReadConsistency"
         optional :transaction, :bytes, 2
+        optional :read_time, :message, 4, "google.protobuf.Timestamp"
       end
     end
     add_enum "google.datastore.v1.ReadOptions.ReadConsistency" do
@@ -114,6 +121,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :previous_transaction, :bytes, 1
     end
     add_message "google.datastore.v1.TransactionOptions.ReadOnly" do
+      optional :read_time, :message, 1, "google.protobuf.Timestamp"
     end
   end
 end

data/lib/google/datastore/v1/datastore_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/datastore/v1/datastore.proto for package 'Google.Cloud.Datastore.V1'
 # Original file comments:
-# Copyright 2019 Google LLC.
+# Copyright 2022 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/datastore/v1/entity_pb.rb

@@ -1,11 +1,11 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/datastore/v1/entity.proto
 
-require 'google/api/annotations_pb'
+require 'google/protobuf'
+
 require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/type/latlng_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/datastore/v1/entity.proto", :syntax => :proto3) do

data/lib/google/datastore/v1/query_pb.rb

@@ -1,17 +1,18 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/datastore/v1/query.proto
 
-require 'google/api/annotations_pb'
+require 'google/protobuf'
+
 require 'google/datastore/v1/entity_pb'
+require 'google/protobuf/timestamp_pb'
 require 'google/protobuf/wrappers_pb'
-require 'google/type/latlng_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/datastore/v1/query.proto", :syntax => :proto3) do
     add_message "google.datastore.v1.EntityResult" do
       optional :entity, :message, 1, "google.datastore.v1.Entity"
       optional :version, :int64, 4
+      optional :update_time, :message, 5, "google.protobuf.Timestamp"
       optional :cursor, :bytes, 3
     end
     add_enum "google.datastore.v1.EntityResult.ResultType" do
@@ -75,7 +76,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :GREATER_THAN, 3
       value :GREATER_THAN_OR_EQUAL, 4
       value :EQUAL, 5
+      value :IN, 6
+      value :NOT_EQUAL, 9
       value :HAS_ANCESTOR, 11
+      value :NOT_IN, 13
     end
     add_message "google.datastore.v1.GqlQuery" do
       optional :query_string, :string, 1
@@ -97,6 +101,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :end_cursor, :bytes, 4
       optional :more_results, :enum, 5, "google.datastore.v1.QueryResultBatch.MoreResultsType"
       optional :snapshot_version, :int64, 7
+      optional :read_time, :message, 8, "google.protobuf.Timestamp"
     end
     add_enum "google.datastore.v1.QueryResultBatch.MoreResultsType" do
       value :MORE_RESULTS_TYPE_UNSPECIFIED, 0

data/proto_docs/google/datastore/v1/datastore.rb

@@ -52,6 +52,9 @@ module Google
         #     A list of keys that were not looked up due to resource constraints. The
         #     order of results in this field is undefined and has no relation to the
         #     order of the keys in the input.
+        # @!attribute [rw] read_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time at which these entities were read or found missing.
         class LookupResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -189,6 +192,9 @@ module Google
         #   @return [::Integer]
         #     The number of index entries updated during the commit, or zero if none were
         #     updated.
+        # @!attribute [rw] commit_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The transaction commit timestamp. Not set for non-transactional commits.
         class CommitResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -258,8 +264,14 @@ module Google
         #     Must have a complete key path and must not be reserved/read-only.
         # @!attribute [rw] base_version
         #   @return [::Integer]
-        #     The version of the entity that this mutation is being applied to. If this
-        #     does not match the current version on the server, the mutation conflicts.
+        #     The version of the entity that this mutation is being applied
+        #     to. If this does not match the current version on the server, the
+        #     mutation conflicts.
+        # @!attribute [rw] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The update time of the entity that this mutation is being applied
+        #     to. If this does not match the current update time on the server, the
+        #     mutation conflicts.
         class Mutation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -277,6 +289,12 @@ module Google
         #     be the version of the current entity or, if no entity is present, a version
         #     that is strictly greater than the version of any previous entity and less
         #     than the version of any possible future entity.
+        # @!attribute [rw] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The update time of the entity on the server after processing the mutation.
+        #     If the mutation doesn't change anything on the server, then the timestamp
+        #     will be the update timestamp of the current entity. This field will not be
+        #     set after a 'delete'.
         # @!attribute [rw] conflict_detected
         #   @return [::Boolean]
         #     Whether a conflict was detected for this mutation. Always false when a
@@ -296,6 +314,11 @@ module Google
         #     The identifier of the transaction in which to read. A
         #     transaction identifier is returned by a call to
         #     {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
+        # @!attribute [rw] read_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Reads entities as they were at the given time. This may not be older
+        #     than 270 seconds.  This value is only supported for Cloud Firestore in
+        #     Datastore mode.
         class ReadOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -338,6 +361,10 @@ module Google
           end
 
           # Options specific to read-only transactions.
+          # @!attribute [rw] read_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Reads entities at the given time.
+          #     This may not be older than 60 seconds.
           class ReadOnly
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/datastore/v1/entity.rb

@@ -39,8 +39,7 @@ module Google
         #
         # Foreign partition IDs (in which the project ID does
         # not match the context project ID ) are discouraged.
-        # Reads and writes of foreign partition IDs may fail if the project is not in
-        # an active state.
+        # Reads and writes of foreign partition IDs may fail if the project is not in an active state.
         # @!attribute [rw] project_id
         #   @return [::String]
         #     The ID of the project to which the entities belong.
@@ -90,20 +89,31 @@ module Google
           # @!attribute [rw] kind
           #   @return [::String]
           #     The kind of the entity.
+          #
           #     A kind matching regex `__.*__` is reserved/read-only.
           #     A kind must not contain more than 1500 bytes when UTF-8 encoded.
           #     Cannot be `""`.
+          #
+          #     Must be valid UTF-8 bytes. Legacy values that are not valid UTF-8 are
+          #     encoded as `__bytes<X>__` where `<X>` is the base-64 encoding of the
+          #     bytes.
           # @!attribute [rw] id
           #   @return [::Integer]
           #     The auto-allocated ID of the entity.
+          #
           #     Never equal to zero. Values less than zero are discouraged and may not
           #     be supported in the future.
           # @!attribute [rw] name
           #   @return [::String]
           #     The name of the entity.
+          #
           #     A name matching regex `__.*__` is reserved/read-only.
           #     A name must not be more than 1500 bytes when UTF-8 encoded.
           #     Cannot be `""`.
+          #
+          #     Must be valid UTF-8 bytes. Legacy values that are not valid UTF-8 are
+          #     encoded as `__bytes<X>__` where `<X>` is the base-64 encoding of the
+          #     bytes.
           class PathElement
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -146,8 +156,8 @@ module Google
         # @!attribute [rw] string_value
         #   @return [::String]
         #     A UTF-8 encoded string value.
-        #     When `exclude_from_indexes` is false (it is indexed), may have at most
-        #     1500 bytes. Otherwise, may be set to at most 1,000,000 bytes.
+        #     When `exclude_from_indexes` is false (it is indexed) , may have at most 1500 bytes.
+        #     Otherwise, may be set to at most 1,000,000 bytes.
         # @!attribute [rw] blob_value
         #   @return [::String]
         #     A blob value.

data/proto_docs/google/datastore/v1/query.rb

@@ -36,6 +36,12 @@ module Google
         #     For {::Google::Cloud::Datastore::V1::LookupResponse#missing missing} entities in `LookupResponse`, this
         #     is the version of the snapshot that was used to look up the entity, and it
         #     is always set except for eventually consistent reads.
+        # @!attribute [rw] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time at which the entity was last changed.
+        #     This field is set for {::Google::Cloud::Datastore::V1::EntityResult::ResultType::FULL `FULL`} entity
+        #     results.
+        #     If this entity is missing, this field will not be set.
         # @!attribute [rw] cursor
         #   @return [::String]
         #     A cursor that points to the position after the result entity.
@@ -215,23 +221,68 @@ module Google
             # Unspecified. This value must not be used.
             OPERATOR_UNSPECIFIED = 0
 
-            # Less than.
+            # The given `property` is less than the given `value`.
+            #
+            # Requires:
+            #
+            # * That `property` comes first in `order_by`.
             LESS_THAN = 1
 
-            # Less than or equal.
+            # The given `property` is less than or equal to the given `value`.
+            #
+            # Requires:
+            #
+            # * That `property` comes first in `order_by`.
             LESS_THAN_OR_EQUAL = 2
 
-            # Greater than.
+            # The given `property` is greater than the given `value`.
+            #
+            # Requires:
+            #
+            # * That `property` comes first in `order_by`.
             GREATER_THAN = 3
 
-            # Greater than or equal.
+            # The given `property` is greater than or equal to the given `value`.
+            #
+            # Requires:
+            #
+            # * That `property` comes first in `order_by`.
             GREATER_THAN_OR_EQUAL = 4
 
-            # Equal.
+            # The given `property` is equal to the given `value`.
             EQUAL = 5
 
-            # Has ancestor.
+            # The given `property` is equal to at least one value in the given array.
+            #
+            # Requires:
+            #
+            # * That `value` is a non-empty `ArrayValue` with at most 10 values.
+            # * No other `IN` or `NOT_IN` is in the same query.
+            IN = 6
+
+            # The given `property` is not equal to the given `value`.
+            #
+            # Requires:
+            #
+            # * No other `NOT_EQUAL` or `NOT_IN` is in the same query.
+            # * That `property` comes first in the `order_by`.
+            NOT_EQUAL = 9
+
+            # Limit the result set to the given entity and its descendants.
+            #
+            # Requires:
+            #
+            # * That `value` is an entity key.
             HAS_ANCESTOR = 11
+
+            # The value of the `property` is not in the given array.
+            #
+            # Requires:
+            #
+            # * That `value` is a non-empty `ArrayValue` with at most 10 values.
+            # * No other `IN`, `NOT_IN`, `NOT_EQUAL` is in the same query.
+            # * That `field` comes first in the `order_by`.
+            NOT_IN = 13
           end
         end
 
@@ -319,6 +370,18 @@ module Google
         #     can have a greater snapshot version number. Each batch's snapshot version
         #     is valid for all preceding batches.
         #     The value will be zero for eventually consistent queries.
+        # @!attribute [rw] read_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Read timestamp this batch was returned from.
+        #     This applies to the range of results from the query's `start_cursor` (or
+        #     the beginning of the query if no cursor was given) to this batch's
+        #     `end_cursor` (not the query's `end_cursor`).
+        #
+        #     In a single transaction, subsequent query result batches for the same query
+        #     can have a greater timestamp. Each batch's read timestamp
+        #     is valid for all preceding batches.
+        #     This value will not be set for eventually consistent queries in Cloud
+        #     Datastore.
         class QueryResultBatch
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/struct.rb

@@ -46,8 +46,8 @@ module Google
 
     # `Value` represents a dynamically typed value which can be either
     # null, a number, a string, a boolean, a recursive struct value, or a
-    # list of values. A producer of value is expected to set one of that
-    # variants, absence of any variant indicates an error.
+    # list of values. A producer of value is expected to set one of these
+    # variants. Absence of any variant indicates an error.
     #
     # The JSON representation for `Value` is JSON value.
     # @!attribute [rw] null_value

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-datastore-v1
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-11 00:00:00.000000000 Z
+date: 2022-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -50,28 +50,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
 - !ruby/object:Gem::Dependency
   name: minitest-focus
   requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -201,14 +201,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: API Client library for the Firestore in Datastore mode V1 API