mongoid 7.3.5 → 7.5.0

data/spec/support/models/threadlocker.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Threadlocker
   include Mongoid::Document

data/spec/support/models/title.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Title
   include Mongoid::Document

data/spec/support/models/tool.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Tool
   include Mongoid::Document

data/spec/support/models/topping.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Topping
   include Mongoid::Document

data/spec/support/models/toy.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Toy
   include Mongoid::Document

data/spec/support/models/track.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Track
   include Mongoid::Document

data/spec/support/models/translation.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Translation
   include Mongoid::Document

data/spec/support/models/tree.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Tree
   include Mongoid::Document

data/spec/support/models/truck.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Truck < Vehicle
   embeds_one :bed

data/spec/support/models/updatable.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Updatable
   include Mongoid::Document

data/spec/support/models/user.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class User
   include Mongoid::Document

data/spec/support/models/user_account.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class UserAccount
   include Mongoid::Document

data/spec/support/models/validation_callback.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class ValidationCallback
   include Mongoid::Document

data/spec/support/models/vehicle.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Vehicle
   include Mongoid::Document

data/spec/support/models/version.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Version
   include Mongoid::Document

data/spec/support/models/vertex.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Vertex
   include Mongoid::Document

data/spec/support/models/vet_visit.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class VetVisit
   include Mongoid::Document

data/spec/support/models/video.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Video
   include Mongoid::Document

data/spec/support/models/video_game.rb

@@ -1,4 +1,3 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class VideoGame < Game; end

data/spec/support/models/washer.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Washer
   include Mongoid::Document

data/spec/support/models/weapon.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Weapon
   include Mongoid::Document

data/spec/support/models/wiki_page.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class WikiPage
   include Mongoid::Document

data/spec/support/models/word.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Word
   include Mongoid::Document

data/spec/support/models/word_origin.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class WordOrigin
   include Mongoid::Document

data/spec/support/models/writer.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 class Writer
   include Mongoid::Document

data/spec/support/schema_maps/schema_map_aws.json

@@ -0,0 +1,17 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": [{
+          "$binary": {
+            "base64": "AWSAAAAAAAAAAAAAAAAAAA==",
+            "subType": "04"
+          }
+        }],
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/schema_maps/schema_map_aws_key_alt_names.json

@@ -0,0 +1,12 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": "/altname",
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Random"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/schema_maps/schema_map_azure.json

@@ -0,0 +1,17 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": [{
+          "$binary": {
+            "base64": "AZUREAAAAAAAAAAAAAAAAA==",
+            "subType": "04"
+          }
+        }],
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/schema_maps/schema_map_azure_key_alt_names.json

@@ -0,0 +1,12 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": "/altname",
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Random"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/schema_maps/schema_map_gcp.json

@@ -0,0 +1,17 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": [{
+          "$binary": {
+            "base64": "GCPAAAAAAAAAAAAAAAAAAA==",
+            "subType": "04"
+          }
+        }],
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/schema_maps/schema_map_gcp_key_alt_names.json

@@ -0,0 +1,12 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": "/altname",
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Random"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/schema_maps/schema_map_kmip.json

@@ -0,0 +1,17 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": [{
+          "$binary": {
+            "base64": "KMIPAAAAAAAAAAAAAAAAAA==",
+            "subType": "04"
+          }
+        }],
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/schema_maps/schema_map_kmip_key_alt_names.json

@@ -0,0 +1,12 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": "/altname",
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Random"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/schema_maps/schema_map_local.json

@@ -0,0 +1,18 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": [{
+          "$binary": {
+              "base64": "LOCALAAAAAAAAAAAAAAAAA==",
+              "subType": "04"
+
+              }
+        }],
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/schema_maps/schema_map_local_key_alt_names.json

@@ -0,0 +1,12 @@
+{
+  "properties": {
+    "ssn": {
+      "encrypt": {
+        "keyId": "/altname",
+        "bsonType": "string",
+        "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Random"
+      }
+    }
+  },
+  "bsonType": "object"
+}

data/spec/support/shared/time.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 shared_context 'using AS time zone' do
   before do

data/spec/support/spec_config.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 require 'singleton'
 
@@ -20,6 +19,9 @@ class SpecConfig
     if @uri
       @uri.servers
     else
+      STDERR.puts "Environment variable 'MONGODB_URI' is not set, so the default url will be used."
+      STDERR.puts "This may lead to unexpected test failures because service discovery will raise unexpected warnings."
+      STDERR.puts "Please consider providing the correct uri via MONGODB_URI environment variable."
       ['127.0.0.1:27017']
     end
   end
@@ -32,6 +34,10 @@ class SpecConfig
     RUBY_PLATFORM =~ /\bjava\b/
   end
 
+  def windows?
+    ENV['OS'] == 'Windows_NT' && !RUBY_PLATFORM.match?(/cygwin/)
+  end
+
   def platform
     RUBY_PLATFORM
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mongoid
 version: !ruby/object:Gem::Version
-  version: 7.3.5
+  version: 7.5.0
 platform: ruby
 authors:
 - Durran Jordan
@@ -10,9 +10,9 @@ bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIDfDCCAmSgAwIBAgIBATANBgkqhkiG9w0BAQsFADBCMRQwEgYDVQQDDAtkcml2
+  MIIDfDCCAmSgAwIBAgIBATANBgkqhkiG9w0BAQUFADBCMRQwEgYDVQQDDAtkcml2
   ZXItcnVieTEVMBMGCgmSJomT8ixkARkWBTEwZ2VuMRMwEQYKCZImiZPyLGQBGRYD
-  Y29tMB4XDTIyMDIyMjE4NDYwMloXDTIzMDIyMjE4NDYwMlowQjEUMBIGA1UEAwwL
+  Y29tMB4XDTIyMDMzMDE5MTcwMloXDTIzMDMzMDE5MTcwMlowQjEUMBIGA1UEAwwL
   ZHJpdmVyLXJ1YnkxFTATBgoJkiaJk/IsZAEZFgUxMGdlbjETMBEGCgmSJomT8ixk
   ARkWA2NvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANFdSAa8fRm1
   bAM9za6Z0fAH4g02bqM1NGnw8zJQrE/PFrFfY6IFCT2AsLfOwr1maVm7iU1+kdVI
@@ -23,12 +23,12 @@ cert_chain:
   u8KAcPHm5KkCAwEAAaN9MHswCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0O
   BBYEFFt3WbF+9JpUjAoj62cQBgNb8HzXMCAGA1UdEQQZMBeBFWRyaXZlci1ydWJ5
   QDEwZ2VuLmNvbTAgBgNVHRIEGTAXgRVkcml2ZXItcnVieUAxMGdlbi5jb20wDQYJ
-  KoZIhvcNAQELBQADggEBAKuc9439GmybuWBZ5j33NcqKu+nozTgjDOk+nWpe4SfG
-  tWbk6IsDypCYwJOjD/YoBn2betLRO6GWDbkviTCvf2QmS2pvpkUw3acTPefbnR/O
-  ytKOXzAuU24IN8Xp38O5uPoYA0xi4/9a2865AGT7y+XImus/Pd2ue6E21L4h6Eq1
-  IP/sZUO9yU/+PRSeMv55DSURuJGgDHh1TMjw0Td+xXfPbH47omLyI32JoMpRXJUE
-  1RLPCb/r/Y+pZ0OeAJRwTJ3+0HfJbZmRmjW1mo/9xC6/VMNY5S0va0DkNZVmAtW3
-  t07cSm70CtkeWPr1kLSbIuzWVW105PrOFqxZ5dP6oVA=
+  KoZIhvcNAQEFBQADggEBAM0s7jz2IGD8Ms035b1tMnbNP2CBPq3pen3KQj7IkGF7
+  x8LPDdOqUj4pUMLeefntX/PkSvwROo677TnWK6+GLayGm5xLHrZH3svybC6QtqTR
+  mVOLUoZ4TgUmtnMUa/ZvgrIsOeiCysjSf4WECuw7g+LE6jcpLepgYTLk2u1+5SgH
+  JVENj0BMkdeZIKkc2G97DSx3Zrmz7QWAaH+99XlajJbfcgvhDso+ffQkTBlOgLBg
+  +WyKQ+QTIdtDiyf2LQmxWnxt/W1CmScjdLS7/yXGkkB/D9Uy+sJD747O/B9P238Q
+  XnerrtyOu04RsWDvaZkCwSDVzoqfICh4CP1mlde73Ts=
   -----END CERTIFICATE-----
 date: 2022-07-20 00:00:00.000000000 Z
 dependencies:
@@ -216,8 +216,10 @@ files:
 - lib/mongoid/config/validators/client.rb
 - lib/mongoid/config/validators/option.rb
 - lib/mongoid/contextual.rb
+- lib/mongoid/contextual/aggregable.rb
 - lib/mongoid/contextual/aggregable/memory.rb
 - lib/mongoid/contextual/aggregable/mongo.rb
+- lib/mongoid/contextual/aggregable/none.rb
 - lib/mongoid/contextual/atomic.rb
 - lib/mongoid/contextual/command.rb
 - lib/mongoid/contextual/geo_near.rb
@@ -450,17 +452,19 @@ files:
 - lib/mongoid/validatable/queryable.rb
 - lib/mongoid/validatable/uniqueness.rb
 - lib/mongoid/version.rb
+- lib/mongoid/warnings.rb
 - lib/rails/generators/mongoid/config/config_generator.rb
 - lib/rails/generators/mongoid/config/templates/mongoid.yml
 - lib/rails/generators/mongoid/model/model_generator.rb
 - lib/rails/generators/mongoid/model/templates/model.rb.tt
 - lib/rails/generators/mongoid_generator.rb
 - lib/rails/mongoid.rb
-- lib/support/ruby_version.rb
 - spec/README.md
 - spec/config/mongoid.yml
+- spec/config/mongoid_with_schema_map_uuid.yml
 - spec/integration/app_spec.rb
 - spec/integration/associations/belongs_to_spec.rb
+- spec/integration/associations/embedded_dirty_spec.rb
 - spec/integration/associations/embedded_spec.rb
 - spec/integration/associations/embeds_many_spec.rb
 - spec/integration/associations/embeds_one_spec.rb
@@ -471,14 +475,17 @@ files:
 - spec/integration/associations/nested_attributes_assignment_spec.rb
 - spec/integration/associations/reverse_population_spec.rb
 - spec/integration/associations/reverse_population_spec_models.rb
+- spec/integration/associations/scope_option_spec.rb
 - spec/integration/atomic/modifiers_spec.rb
 - spec/integration/bson_regexp_raw_spec.rb
 - spec/integration/callbacks_models.rb
 - spec/integration/callbacks_spec.rb
 - spec/integration/contextual/empty_spec.rb
+- spec/integration/criteria/alias_query_spec.rb
 - spec/integration/criteria/date_field_spec.rb
 - spec/integration/criteria/default_scope_spec.rb
 - spec/integration/criteria/logical_spec.rb
+- spec/integration/criteria/range_spec.rb
 - spec/integration/criteria/time_with_zone_spec.rb
 - spec/integration/discriminator_key_spec.rb
 - spec/integration/discriminator_value_spec.rb
@@ -639,6 +646,7 @@ files:
 - spec/mongoid/config_spec.rb
 - spec/mongoid/contextual/aggregable/memory_spec.rb
 - spec/mongoid/contextual/aggregable/mongo_spec.rb
+- spec/mongoid/contextual/aggregable/none_spec.rb
 - spec/mongoid/contextual/atomic_spec.rb
 - spec/mongoid/contextual/geo_near_spec.rb
 - spec/mongoid/contextual/map_reduce_spec.rb
@@ -836,6 +844,7 @@ files:
 - spec/shared/lib/mrss/cluster_config.rb
 - spec/shared/lib/mrss/constraints.rb
 - spec/shared/lib/mrss/docker_runner.rb
+- spec/shared/lib/mrss/eg_config_utils.rb
 - spec/shared/lib/mrss/event_subscriber.rb
 - spec/shared/lib/mrss/lite_constraints.rb
 - spec/shared/lib/mrss/server_version_registry.rb
@@ -846,6 +855,7 @@ files:
 - spec/shared/share/Dockerfile.erb
 - spec/shared/share/haproxy-1.conf
 - spec/shared/share/haproxy-2.conf
+- spec/shared/shlib/config.sh
 - spec/shared/shlib/distro.sh
 - spec/shared/shlib/server.sh
 - spec/shared/shlib/set_env.sh
@@ -1032,6 +1042,7 @@ files:
 - spec/support/models/publication/encyclopedia.rb
 - spec/support/models/publication/review.rb
 - spec/support/models/purchase.rb
+- spec/support/models/purchased_item.rb
 - spec/support/models/question.rb
 - spec/support/models/quiz.rb
 - spec/support/models/rating.rb
@@ -1103,6 +1114,16 @@ files:
 - spec/support/models/word.rb
 - spec/support/models/word_origin.rb
 - spec/support/models/writer.rb
+- spec/support/schema_maps/schema_map_aws.json
+- spec/support/schema_maps/schema_map_aws_key_alt_names.json
+- spec/support/schema_maps/schema_map_azure.json
+- spec/support/schema_maps/schema_map_azure_key_alt_names.json
+- spec/support/schema_maps/schema_map_gcp.json
+- spec/support/schema_maps/schema_map_gcp_key_alt_names.json
+- spec/support/schema_maps/schema_map_kmip.json
+- spec/support/schema_maps/schema_map_kmip_key_alt_names.json
+- spec/support/schema_maps/schema_map_local.json
+- spec/support/schema_maps/schema_map_local_key_alt_names.json
 - spec/support/shared/time.rb
 - spec/support/spec_config.rb
 homepage: https://mongoid.org
@@ -1122,7 +1143,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -1146,16 +1167,20 @@ test_files:
 - spec/integration/callbacks_models.rb
 - spec/integration/matcher_spec.rb
 - spec/integration/contextual/empty_spec.rb
+- spec/integration/criteria/range_spec.rb
 - spec/integration/criteria/time_with_zone_spec.rb
 - spec/integration/criteria/logical_spec.rb
 - spec/integration/criteria/default_scope_spec.rb
+- spec/integration/criteria/alias_query_spec.rb
 - spec/integration/criteria/date_field_spec.rb
 - spec/integration/stringified_symbol_field_spec.rb
 - spec/integration/document_spec.rb
 - spec/integration/i18n_fallbacks_spec.rb
 - spec/integration/associations/belongs_to_spec.rb
 - spec/integration/associations/has_one_spec.rb
+- spec/integration/associations/scope_option_spec.rb
 - spec/integration/associations/has_many_spec.rb
+- spec/integration/associations/embedded_dirty_spec.rb
 - spec/integration/associations/foreign_key_spec.rb
 - spec/integration/associations/embeds_one_spec.rb
 - spec/integration/associations/reverse_population_spec_models.rb
@@ -1229,6 +1254,7 @@ test_files:
 - spec/integration/matcher_operator_spec.rb
 - spec/integration/app_spec.rb
 - spec/integration/matcher_examples_spec.rb
+- spec/config/mongoid_with_schema_map_uuid.yml
 - spec/config/mongoid.yml
 - spec/support/constraints.rb
 - spec/support/models/tree.rb
@@ -1314,6 +1340,7 @@ test_files:
 - spec/support/models/appointment.rb
 - spec/support/models/cat.rb
 - spec/support/models/thing.rb
+- spec/support/models/purchased_item.rb
 - spec/support/models/id_key.rb
 - spec/support/models/acolyte.rb
 - spec/support/models/vertex.rb
@@ -1481,6 +1508,16 @@ test_files:
 - spec/support/macros.rb
 - spec/support/spec_config.rb
 - spec/support/helpers.rb
+- spec/support/schema_maps/schema_map_local_key_alt_names.json
+- spec/support/schema_maps/schema_map_aws_key_alt_names.json
+- spec/support/schema_maps/schema_map_kmip.json
+- spec/support/schema_maps/schema_map_azure.json
+- spec/support/schema_maps/schema_map_kmip_key_alt_names.json
+- spec/support/schema_maps/schema_map_local.json
+- spec/support/schema_maps/schema_map_gcp_key_alt_names.json
+- spec/support/schema_maps/schema_map_aws.json
+- spec/support/schema_maps/schema_map_gcp.json
+- spec/support/schema_maps/schema_map_azure_key_alt_names.json
 - spec/support/client_registry.rb
 - spec/support/expectations.rb
 - spec/support/authorization.rb
@@ -1494,11 +1531,13 @@ test_files:
 - spec/shared/bin/s3-upload
 - spec/shared/shlib/distro.sh
 - spec/shared/shlib/set_env.sh
+- spec/shared/shlib/config.sh
 - spec/shared/shlib/server.sh
 - spec/shared/LICENSE
 - spec/shared/lib/mrss/constraints.rb
 - spec/shared/lib/mrss/cluster_config.rb
 - spec/shared/lib/mrss/child_process_helper.rb
+- spec/shared/lib/mrss/eg_config_utils.rb
 - spec/shared/lib/mrss/event_subscriber.rb
 - spec/shared/lib/mrss/utils.rb
 - spec/shared/lib/mrss/server_version_registry.rb
@@ -1608,6 +1647,7 @@ test_files:
 - spec/mongoid/contextual/atomic_spec.rb
 - spec/mongoid/contextual/aggregable/mongo_spec.rb
 - spec/mongoid/contextual/aggregable/memory_spec.rb
+- spec/mongoid/contextual/aggregable/none_spec.rb
 - spec/mongoid/criteria/options_spec.rb
 - spec/mongoid/criteria/queryable/smash_spec.rb
 - spec/mongoid/criteria/queryable/pipeline_spec.rb

data/lib/support/ruby_version.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-# encoding: utf-8
-
-# Go ahead and fail if not using Ruby 1.9.3, no since in letting people
-# squarm for answers
-def raise_version_error(message)
-  puts message
-  Rails.logger.info(message) if defined?(Rails) && Rails.logger
-  raise
-end
-
-def invalid_version?
-  RUBY_VERSION =~ /([\d]+)\.([\d]+)\.([\d]+)/
-  major, minor, revision = $1.to_i, $2.to_i, $3.to_i
-  if defined?(JRUBY_VERSION)
-    major <= 1 && minor <= 9 && revision <= 1
-  else
-    major <= 1 && minor <= 9 && revision <= 2
-  end
-end
-
-if invalid_version?
-  message = %{
-Mongoid requires MRI version 1.9.3+ or JRuby 1.6.0+ running in 1.9 mode.
-Your current Ruby version is defined as #{RUBY_VERSION}. Please see:
-http://mongoid.org/en/mongoid/docs/tips.html#ruby for details.
-  }
-  raise_version_error(message)
-end