mongo 1.12.5 → 2.0.0.beta

data/spec/support/server_selection.rb

@@ -0,0 +1,140 @@
+module Mongo
+  module ServerSelection
+    module Read
+
+      # Represents a Server Selection specification test.
+      #
+      # @since 2.0.0
+      class Spec
+
+        # Mapping of topology description strings to topology type classes.
+        #
+        # @since 2.0.0
+        TOPOLOGY_TYPES = {
+          'ReplicaSetNoPrimary' => Mongo::Cluster::Topology::ReplicaSet,
+          'ReplicaSetWithPrimary' => Mongo::Cluster::Topology::ReplicaSet,
+          'Sharded' => Mongo::Cluster::Topology::Sharded,
+          'Single' => Mongo::Cluster::Topology::Standalone,
+          'Unknown' => Mongo::Cluster::Topology::Unknown
+        }
+
+        # Mapping of read preference modes.
+        #
+        # @since 2.0.0
+        READ_PREFERENCES = {
+          'Primary' => :primary,
+          'Secondary' => :secondary,
+          'PrimaryPreferred' => :primary_preferred,
+          'SecondaryPreferred' => :secondary_preferred,
+          'Nearest' => :nearest,
+        }
+
+        # @return [ String ] description The spec description.
+        #
+        # @since 2.0.0
+        attr_reader :description
+
+        # @return [ Hash ] read_preference The read preference to be used for selection.
+        #
+        # @since 2.0.0
+        attr_reader :read_preference
+
+        # @return [ Array<Hash> ] candidate_servers The candidate servers.
+        #
+        # @since 2.0.0
+        attr_reader :candidate_servers
+
+        # @return [ Array<Hash> ] eligible_servers The eligible servers before the latency
+        #   window is taken into account.
+        #
+        # @since 2.0.0
+        attr_reader :eligible_servers
+
+        # @return [ Array<Hash> ] suitable_servers The set of servers matching all server
+        #  selection logic. May be a subset of eligible_servers and/or candidate_servers.
+        #
+        # @since 2.0.0
+        attr_reader :suitable_servers
+
+        # @return [ Array<Hash> ] in_latency_window The subset of suitable servers that falls
+        #  within the allowable latency window.
+        #
+        # @since 2.0.0
+        attr_reader :in_latency_window
+
+        # @return [ Mongo::Cluster::Topology ] type The topology type.
+        #
+        # @since 2.0.0
+        attr_reader :type
+
+        # Instantiate the new spec.
+        #
+        # @example Create the spec.
+        #   Spec.new(file)
+        #
+        # @param [ String ] file The name of the file.
+        #
+        # @since 2.0.0
+        def initialize(file)
+          @test = YAML.load(ERB.new(File.new(file).read).result)
+          @description = "#{@test['topology_description']['type']}: #{File.basename(file)}"
+          @read_preference = @test['read_preference']
+          @read_preference['mode'] = READ_PREFERENCES[@read_preference['mode']]
+          @candidate_servers = @test['candidate_servers']
+          @eligible_servers = @test['eligible_servers']
+          @suitable_servers = @test['suitable_servers']
+          @in_latency_window = @test['in_latency_window']
+          @type = TOPOLOGY_TYPES[@test['topology_description']['type']]
+        end
+
+        # Whether this spec describes a replica set.
+        #
+        # @example Determine if the spec describes a replica set.
+        #   spec.replica_set?
+        #
+        # @return [true, false] If the spec describes a replica set.
+        #
+        # @since 2.0.0
+        def replica_set?
+          type == Mongo::Cluster::Topology::ReplicaSet
+        end
+
+        # Does this spec raise an exception.
+        #
+        # @example Determine if the spec raises an exception.
+        #   spec.raises_exception?
+        #
+        # @return [true, false] If the spec raises an exception.
+        #
+        # @since 2.0.0
+        def raises_exception?
+          !server_available? || invalid_server_preference?
+        end
+
+        # Does this spec expect a server to be found.
+        #
+        # @example Will a server be found with this spec.
+        #   spec.server_available?
+        #
+        # @return [true, false] If a server will be found with this spec.
+        #
+        # @since 2.0.0
+        def server_available?
+          !in_latency_window.empty?
+        end
+
+        # Is the read preference defined in the spec invalid.
+        #
+        # @example Determine if the spec's read preference is invalid.
+        #   spec.invalid_server_preference?
+        #
+        # @return [true, false] If the spec's read preference is invalid.
+        #
+        # @since 2.0.0
+        def invalid_server_preference?
+          read_preference['mode'] == 'Primary' && read_preference['tag_sets']
+        end
+      end
+    end
+  end
+end

data/spec/support/server_selection/rtt/first_value.yml

@@ -0,0 +1,4 @@
+---
+avg_rtt_ms: 'NULL'
+new_rtt_ms: 10
+new_avg_rtt: 10

data/spec/support/server_selection/rtt/first_value_zero.yml

@@ -0,0 +1,4 @@
+---
+avg_rtt_ms: 'NULL'
+new_rtt_ms: 0
+new_avg_rtt: 0

data/spec/support/server_selection/rtt/value_test_1.yml

@@ -0,0 +1,4 @@
+---
+avg_rtt_ms: 0
+new_rtt_ms: 5
+new_avg_rtt: 1.0

data/spec/support/server_selection/rtt/value_test_2.yml

@@ -0,0 +1,4 @@
+---
+avg_rtt_ms: 3.1
+new_rtt_ms: 36
+new_avg_rtt: 9.68

data/spec/support/server_selection/rtt/value_test_3.yml

@@ -0,0 +1,4 @@
+---
+avg_rtt_ms: 9.12
+new_rtt_ms: 9.12
+new_avg_rtt: 9.12

data/spec/support/server_selection/rtt/value_test_4.yml

@@ -0,0 +1,4 @@
+---
+avg_rtt_ms: 1
+new_rtt_ms: 1000
+new_avg_rtt: 200.8

data/spec/support/server_selection/rtt/value_test_5.yml

@@ -0,0 +1,4 @@
+---
+avg_rtt_ms: 0
+new_rtt_ms: 0.25
+new_avg_rtt: 0.05

data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Nearest.yml

@@ -0,0 +1,32 @@
+---
+topology_description:
+  type: ReplicaSetNoPrimary
+  servers:
+  - &1
+    address: b:27017
+    avg_rtt_ms: 5
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+  - &2
+    address: c:27017
+    avg_rtt_ms: 100
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+operation: read
+read_preference:
+  mode: Nearest
+  tag_sets:
+  - data_center: nyc
+candidate_servers:
+- *1
+- *2
+eligible_servers:
+- *1
+- *2
+suitable_servers:
+- *1
+- *2
+in_latency_window:
+- *1

data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Nearest_non_matching.yml

@@ -0,0 +1,27 @@
+---
+topology_description:
+  type: ReplicaSetNoPrimary
+  servers:
+  - &1
+    address: b:27017
+    avg_rtt_ms: 5
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+  - &2
+    address: c:27017
+    avg_rtt_ms: 100
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+operation: read
+read_preference:
+  mode: Nearest
+  tag_sets:
+  - data_center: sf
+candidate_servers:
+- *1
+- *2
+eligible_servers: []
+suitable_servers: []
+in_latency_window: []

data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Primary.yml

@@ -0,0 +1,23 @@
+---
+topology_description:
+  type: ReplicaSetNoPrimary
+  servers:
+  - address: b:27017
+    avg_rtt_ms: 5
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+  - address: c:27017
+    avg_rtt_ms: 100
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+operation: read
+read_preference:
+  mode: Primary
+  tag_sets:
+  - {}
+candidate_servers: []
+eligible_servers: []
+suitable_servers: []
+in_latency_window: []

data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/PrimaryPreferred.yml

@@ -0,0 +1,32 @@
+---
+topology_description:
+  type: ReplicaSetNoPrimary
+  servers:
+  - &1
+    address: b:27017
+    avg_rtt_ms: 5
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+  - &2
+    address: c:27017
+    avg_rtt_ms: 100
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+operation: read
+read_preference:
+  mode: PrimaryPreferred
+  tag_sets:
+  - {}
+candidate_servers:
+- *1
+- *2
+eligible_servers:
+- *1
+- *2
+suitable_servers:
+- *1
+- *2
+in_latency_window:
+- *1

data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/PrimaryPreferred_non_matching.yml

@@ -0,0 +1,27 @@
+---
+topology_description:
+  type: ReplicaSetNoPrimary
+  servers:
+  - &1
+    address: b:27017
+    avg_rtt_ms: 5
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+  - &2
+    address: c:27017
+    avg_rtt_ms: 100
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+operation: read
+read_preference:
+  mode: PrimaryPreferred
+  tag_sets:
+  - data_center: sf
+candidate_servers:
+- *1
+- *2
+eligible_servers: []
+suitable_servers: []
+in_latency_window: []

data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Secondary.yml

@@ -0,0 +1,32 @@
+---
+topology_description:
+  type: ReplicaSetNoPrimary
+  servers:
+  - &1
+    address: b:27017
+    avg_rtt_ms: 5
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+  - &2
+    address: c:27017
+    avg_rtt_ms: 100
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+operation: read
+read_preference:
+  mode: Secondary
+  tag_sets:
+  - data_center: nyc
+candidate_servers:
+- *1
+- *2
+eligible_servers:
+- *1
+- *2
+suitable_servers:
+- *1
+- *2
+in_latency_window:
+- *1

data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/SecondaryPreferred.yml

@@ -0,0 +1,32 @@
+---
+topology_description:
+  type: ReplicaSetNoPrimary
+  servers:
+  - &1
+    address: b:27017
+    avg_rtt_ms: 5
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+  - &2
+    address: c:27017
+    avg_rtt_ms: 100
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+operation: read
+read_preference:
+  mode: SecondaryPreferred
+  tag_sets:
+  - data_center: nyc
+candidate_servers:
+- *1
+- *2
+eligible_servers:
+- *1
+- *2
+suitable_servers:
+- *1
+- *2
+in_latency_window:
+- *1

data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/SecondaryPreferred_non_matching.yml

@@ -0,0 +1,27 @@
+---
+topology_description:
+  type: ReplicaSetNoPrimary
+  servers:
+  - &1
+    address: b:27017
+    avg_rtt_ms: 5
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+  - &2
+    address: c:27017
+    avg_rtt_ms: 100
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+operation: read
+read_preference:
+  mode: SecondaryPreferred
+  tag_sets:
+  - data_center: sf
+candidate_servers:
+- *1
+- *2
+eligible_servers: []
+suitable_servers: []
+in_latency_window: []

data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Secondary_non_matching.yml

@@ -0,0 +1,27 @@
+---
+topology_description:
+  type: ReplicaSetNoPrimary
+  servers:
+  - &1
+    address: b:27017
+    avg_rtt_ms: 5
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+  - &2
+    address: c:27017
+    avg_rtt_ms: 100
+    type: RSSecondary
+    tag_sets:
+    - data_center: nyc
+operation: read
+read_preference:
+  mode: Secondary
+  tag_sets:
+  - data_center: sf
+candidate_servers:
+- *1
+- *2
+eligible_servers: []
+suitable_servers: []
+in_latency_window: []