google-cloud-firestore 0.22.0 → 0.23.0

data/lib/google/cloud/firestore/watch/order.rb

@@ -0,0 +1,98 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "google/cloud/firestore/v1beta1"
+require "google/cloud/firestore/convert"
+require "google/cloud/firestore/document_reference"
+require "google/cloud/firestore/document_snapshot"
+require "google/cloud/firestore/document_change"
+require "google/cloud/firestore/query_snapshot"
+require "rbtree"
+
+module Google
+  module Cloud
+    module Firestore
+      ##
+      # @private
+      module Watch
+        # @private
+        module Order
+          module ClassMethods
+            def compare_field_values a_value, b_value
+              field_comparison(a_value) <=> field_comparison(b_value)
+            end
+
+            def field_comparison value
+              [field_type(value), field_value(value)]
+            end
+
+            def field_type value
+              return 0 if value.nil?
+              return 1 if value == false
+              return 1 if value == true
+              # The backend ordering semantics treats NaN and Numbers as the
+              # same type, and then internally orders NaNs before Numbers.
+              # Ruby's Float::NAN cannot be compared, similar to nil, so we need
+              # to use a stand in value instead. Therefore the desired sorting
+              # is achieved by separating NaN and Number types. This is an
+              # intentional divergence from type order that is used in the
+              # backend and in the other SDKs.
+              # (And because Ruby has to be special.)
+              return 2 if value.respond_to?(:nan?) && value.nan?
+              return 3 if value.is_a? Numeric
+              return 4 if value.is_a? Time
+              return 5 if value.is_a? String
+              return 6 if value.is_a? StringIO
+              return 7 if value.is_a? DocumentReference
+              return 9 if value.is_a? Array
+              if value.is_a? Hash
+                return 8 if Convert.hash_is_geo_point? value
+                return 10
+              end
+
+              raise "Can't determine field type for #{value.class}"
+            end
+
+            def field_value value
+              # nil can't be compared, so use 0 as a stand in.
+              return 0 if value.nil?
+              return 0 if value == false
+              return 1 if value == true
+              # NaN can't be compared, so use 0 as a stand in.
+              return 0 if value.respond_to?(:nan?) && value.nan?
+              return value if value.is_a? Numeric
+              return value if value.is_a? Time
+              return value if value.is_a? String
+              return value.string if value.is_a? StringIO
+              if value.is_a? DocumentReference
+                return value.path.split("/".freeze)
+              end
+              return value.map { |v| field_comparison(v) } if value.is_a? Array
+              if value.is_a? Hash
+                geo_pairs = Convert.hash_is_geo_point? value
+                return geo_pairs.map(&:last) if geo_pairs
+                return value.sort.map { |k, v| [k, field_comparison(v)] }
+              end
+
+              raise "Can't determine field value for #{value}"
+            end
+          end
+
+          extend ClassMethods
+        end
+      end
+    end
+  end
+end

data/lib/google/firestore/v1beta1/firestore_services_pb.rb

@@ -1,13 +1,13 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/firestore/v1beta1/firestore.proto for package 'google.firestore.v1beta1'
 # Original file comments:
-# Copyright 2017 Google Inc.
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#     https://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
@@ -23,8 +23,6 @@ module Google
   module Firestore
     module V1beta1
       module Firestore
-        # Specification of the Firestore API.
-        #
         # The Cloud Firestore service.
         #
         # This service exposes several types of comparable timestamps:

data/lib/google/firestore/v1beta1/query_pb.rb

@@ -48,6 +48,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     value :GREATER_THAN, 3
     value :GREATER_THAN_OR_EQUAL, 4
     value :EQUAL, 5
+    value :ARRAY_CONTAINS, 7
   end
   add_message "google.firestore.v1beta1.StructuredQuery.UnaryFilter" do
     optional :op, :enum, 1, "google.firestore.v1beta1.StructuredQuery.UnaryFilter.Operator"

data/lib/google/firestore/v1beta1/write_pb.rb

@@ -25,6 +25,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :field_path, :string, 1
     oneof :transform_type do
       optional :set_to_server_value, :enum, 2, "google.firestore.v1beta1.DocumentTransform.FieldTransform.ServerValue"
+      optional :append_missing_elements, :message, 6, "google.firestore.v1beta1.ArrayValue"
+      optional :remove_all_from_array, :message, 7, "google.firestore.v1beta1.ArrayValue"
     end
   end
   add_enum "google.firestore.v1beta1.DocumentTransform.FieldTransform.ServerValue" do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-firestore
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.23.0
 platform: ruby
 authors:
 - Google Inc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-05 00:00:00.000000000 Z
+date: 2018-08-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rbtree
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -122,6 +136,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -196,28 +224,37 @@ files:
 - lib/google/cloud/firestore/commit_response.rb
 - lib/google/cloud/firestore/convert.rb
 - lib/google/cloud/firestore/credentials.rb
+- lib/google/cloud/firestore/document_change.rb
+- lib/google/cloud/firestore/document_listener.rb
 - lib/google/cloud/firestore/document_reference.rb
 - lib/google/cloud/firestore/document_snapshot.rb
 - lib/google/cloud/firestore/field_path.rb
 - lib/google/cloud/firestore/field_value.rb
 - lib/google/cloud/firestore/generate.rb
 - lib/google/cloud/firestore/query.rb
+- lib/google/cloud/firestore/query_listener.rb
+- lib/google/cloud/firestore/query_snapshot.rb
 - lib/google/cloud/firestore/service.rb
 - lib/google/cloud/firestore/transaction.rb
 - lib/google/cloud/firestore/v1beta1.rb
+- lib/google/cloud/firestore/v1beta1/credentials.rb
 - lib/google/cloud/firestore/v1beta1/doc/google/firestore/v1beta1/common.rb
 - lib/google/cloud/firestore/v1beta1/doc/google/firestore/v1beta1/document.rb
 - lib/google/cloud/firestore/v1beta1/doc/google/firestore/v1beta1/firestore.rb
 - lib/google/cloud/firestore/v1beta1/doc/google/firestore/v1beta1/query.rb
 - lib/google/cloud/firestore/v1beta1/doc/google/firestore/v1beta1/write.rb
 - lib/google/cloud/firestore/v1beta1/doc/google/protobuf/any.rb
+- lib/google/cloud/firestore/v1beta1/doc/google/protobuf/empty.rb
 - lib/google/cloud/firestore/v1beta1/doc/google/protobuf/timestamp.rb
 - lib/google/cloud/firestore/v1beta1/doc/google/protobuf/wrappers.rb
 - lib/google/cloud/firestore/v1beta1/doc/google/rpc/status.rb
-- lib/google/cloud/firestore/v1beta1/doc/overview.rb
 - lib/google/cloud/firestore/v1beta1/firestore_client.rb
 - lib/google/cloud/firestore/v1beta1/firestore_client_config.json
 - lib/google/cloud/firestore/version.rb
+- lib/google/cloud/firestore/watch/enumerator_queue.rb
+- lib/google/cloud/firestore/watch/inventory.rb
+- lib/google/cloud/firestore/watch/listener.rb
+- lib/google/cloud/firestore/watch/order.rb
 - lib/google/firestore/v1beta1/common_pb.rb
 - lib/google/firestore/v1beta1/document_pb.rb
 - lib/google/firestore/v1beta1/firestore_pb.rb

data/lib/google/cloud/firestore/v1beta1/doc/overview.rb

@@ -1,53 +0,0 @@
-# Copyright 2017 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Google
-  module Cloud
-    # rubocop:disable LineLength
-
-    ##
-    # # Ruby Client for Google Cloud Firestore API ([Beta](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
-    #
-    # [Google Cloud Firestore API][Product Documentation]:
-    #
-    # - [Product Documentation][]
-    #
-    # ## Quick Start
-    # In order to use this library, you first need to go through the following
-    # steps:
-    #
-    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-    # 2. [Enable the Google Cloud Firestore API.](https://console.cloud.google.com/apis/api/firestore)
-    # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
-    #
-    # ### Installation
-    # ```
-    # $ gem install google-cloud-firestore
-    # ```
-    #
-    # ### Next Steps
-    # - 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.
-    #
-    # [Product Documentation]: https://cloud.google.com/firestore
-    #
-    #
-    module Firestore
-      module V1beta1
-      end
-    end
-  end
-end