mongo 2.4.1 → 2.14.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (1703) hide show
  1. checksums.yaml +5 -5
  2. checksums.yaml.gz.sig +0 -0
  3. data/CONTRIBUTING.md +12 -54
  4. data/LICENSE +1 -1
  5. data/README.md +71 -44
  6. data/Rakefile +104 -9
  7. data/lib/mongo/active_support.rb +17 -0
  8. data/lib/mongo/address/ipv4.rb +38 -8
  9. data/lib/mongo/address/ipv6.rb +61 -12
  10. data/lib/mongo/address/unix.rb +9 -6
  11. data/lib/mongo/address/validator.rb +99 -0
  12. data/lib/mongo/address.rb +160 -59
  13. data/lib/mongo/auth/aws/conversation.rb +128 -0
  14. data/lib/mongo/auth/aws/credentials_retriever.rb +219 -0
  15. data/lib/mongo/auth/aws/request.rb +283 -0
  16. data/lib/mongo/auth/aws.rb +37 -0
  17. data/lib/mongo/auth/base.rb +129 -0
  18. data/lib/mongo/auth/conversation_base.rb +52 -0
  19. data/lib/mongo/auth/cr/conversation.rb +47 -71
  20. data/lib/mongo/auth/cr.rb +14 -35
  21. data/lib/mongo/auth/credential_cache.rb +51 -0
  22. data/lib/mongo/auth/gssapi/conversation.rb +108 -0
  23. data/lib/mongo/auth/gssapi.rb +38 -0
  24. data/lib/mongo/auth/ldap/conversation.rb +22 -53
  25. data/lib/mongo/auth/ldap.rb +11 -33
  26. data/lib/mongo/auth/roles.rb +1 -1
  27. data/lib/mongo/auth/sasl_conversation_base.rb +111 -0
  28. data/lib/mongo/auth/scram/conversation.rb +10 -411
  29. data/lib/mongo/auth/scram.rb +42 -37
  30. data/lib/mongo/auth/scram256/conversation.rb +63 -0
  31. data/lib/mongo/auth/scram256.rb +31 -0
  32. data/lib/mongo/auth/scram_conversation_base.rb +402 -0
  33. data/lib/mongo/auth/stringprep/profiles/sasl.rb +74 -0
  34. data/lib/mongo/auth/stringprep/tables.rb +3233 -0
  35. data/lib/mongo/auth/stringprep/unicode_normalize/normalize.rb +175 -0
  36. data/lib/mongo/auth/stringprep/unicode_normalize/tables.rb +1171 -0
  37. data/lib/mongo/auth/stringprep.rb +115 -0
  38. data/lib/mongo/auth/user/view.rb +53 -25
  39. data/lib/mongo/auth/user.rb +73 -10
  40. data/lib/mongo/auth/x509/conversation.rb +46 -52
  41. data/lib/mongo/auth/x509.rb +26 -31
  42. data/lib/mongo/auth.rb +93 -17
  43. data/lib/mongo/background_thread.rb +159 -0
  44. data/lib/mongo/bson.rb +1 -1
  45. data/lib/mongo/bulk_write/combineable.rb +22 -5
  46. data/lib/mongo/bulk_write/ordered_combiner.rb +1 -1
  47. data/lib/mongo/bulk_write/result.rb +2 -2
  48. data/lib/mongo/bulk_write/result_combiner.rb +18 -8
  49. data/lib/mongo/bulk_write/transformable.rb +20 -11
  50. data/lib/mongo/bulk_write/unordered_combiner.rb +1 -1
  51. data/lib/mongo/bulk_write/validatable.rb +10 -2
  52. data/lib/mongo/bulk_write.rb +134 -46
  53. data/lib/mongo/caching_cursor.rb +74 -0
  54. data/lib/mongo/client.rb +1050 -113
  55. data/lib/mongo/client_encryption.rb +103 -0
  56. data/lib/mongo/cluster/periodic_executor.rb +101 -0
  57. data/lib/mongo/cluster/reapers/cursor_reaper.rb +152 -0
  58. data/lib/mongo/cluster/reapers/socket_reaper.rb +62 -0
  59. data/lib/mongo/cluster/sdam_flow.rb +603 -0
  60. data/lib/mongo/cluster/topology/base.rb +218 -0
  61. data/lib/mongo/cluster/topology/no_replica_set_options.rb +34 -0
  62. data/lib/mongo/cluster/topology/replica_set_no_primary.rb +169 -0
  63. data/lib/mongo/cluster/topology/replica_set_with_primary.rb +27 -0
  64. data/lib/mongo/cluster/topology/sharded.rb +13 -116
  65. data/lib/mongo/cluster/topology/single.rb +19 -113
  66. data/lib/mongo/cluster/topology/unknown.rb +11 -152
  67. data/lib/mongo/cluster/topology.rb +65 -17
  68. data/lib/mongo/cluster.rb +798 -274
  69. data/lib/mongo/cluster_time.rb +139 -0
  70. data/lib/mongo/collection/view/aggregation.rb +47 -14
  71. data/lib/mongo/collection/view/builder/aggregation.rb +39 -8
  72. data/lib/mongo/collection/view/builder/find_command.rb +56 -23
  73. data/lib/mongo/collection/view/builder/flags.rb +2 -2
  74. data/lib/mongo/collection/view/builder/map_reduce.rb +17 -6
  75. data/lib/mongo/collection/view/builder/modifiers.rb +2 -2
  76. data/lib/mongo/collection/view/builder/op_query.rb +10 -2
  77. data/lib/mongo/collection/view/builder.rb +1 -1
  78. data/lib/mongo/collection/view/change_stream/retryable.rb +40 -0
  79. data/lib/mongo/collection/view/change_stream.rb +369 -0
  80. data/lib/mongo/collection/view/explainable.rb +29 -10
  81. data/lib/mongo/collection/view/immutable.rb +2 -2
  82. data/lib/mongo/collection/view/iterable.rb +107 -24
  83. data/lib/mongo/collection/view/map_reduce.rb +65 -36
  84. data/lib/mongo/collection/view/readable.rb +211 -52
  85. data/lib/mongo/collection/view/writable.rb +283 -60
  86. data/lib/mongo/collection/view.rb +52 -28
  87. data/lib/mongo/collection.rb +324 -60
  88. data/lib/mongo/crypt/auto_decryption_context.rb +40 -0
  89. data/lib/mongo/crypt/auto_encrypter.rb +179 -0
  90. data/lib/mongo/crypt/auto_encryption_context.rb +44 -0
  91. data/lib/mongo/crypt/binary.rb +155 -0
  92. data/lib/mongo/crypt/binding.rb +1229 -0
  93. data/lib/mongo/crypt/context.rb +135 -0
  94. data/lib/mongo/crypt/data_key_context.rb +162 -0
  95. data/lib/mongo/crypt/encryption_io.rb +306 -0
  96. data/lib/mongo/crypt/explicit_decryption_context.rb +40 -0
  97. data/lib/mongo/crypt/explicit_encrypter.rb +117 -0
  98. data/lib/mongo/crypt/explicit_encryption_context.rb +89 -0
  99. data/lib/mongo/crypt/handle.rb +315 -0
  100. data/lib/mongo/crypt/hooks.rb +90 -0
  101. data/lib/mongo/crypt/kms_context.rb +67 -0
  102. data/lib/mongo/crypt/status.rb +131 -0
  103. data/lib/mongo/crypt.rb +33 -0
  104. data/lib/mongo/cursor/builder/get_more_command.rb +9 -4
  105. data/lib/mongo/cursor/builder/kill_cursors_command.rb +24 -6
  106. data/lib/mongo/cursor/builder/op_get_more.rb +4 -4
  107. data/lib/mongo/cursor/builder/op_kill_cursors.rb +26 -7
  108. data/lib/mongo/cursor/builder.rb +1 -1
  109. data/lib/mongo/cursor.rb +226 -44
  110. data/lib/mongo/database/view.rb +104 -26
  111. data/lib/mongo/database.rb +214 -31
  112. data/lib/mongo/dbref.rb +10 -3
  113. data/lib/mongo/distinguishing_semaphore.rb +55 -0
  114. data/lib/mongo/error/auth_error.rb +29 -0
  115. data/lib/mongo/error/bulk_write_error.rb +20 -2
  116. data/lib/mongo/error/change_stream_resumable.rb +37 -0
  117. data/lib/mongo/error/closed_stream.rb +1 -1
  118. data/lib/mongo/error/connection_check_out_timeout.rb +48 -0
  119. data/lib/mongo/error/connection_perished.rb +23 -0
  120. data/lib/mongo/error/credential_check_error.rb +26 -0
  121. data/lib/mongo/error/crypt_error.rb +31 -0
  122. data/lib/mongo/error/extra_file_chunk.rb +1 -1
  123. data/lib/mongo/error/failed_string_prep_validation.rb +38 -0
  124. data/lib/mongo/error/file_not_found.rb +1 -1
  125. data/lib/mongo/error/handshake_error.rb +24 -0
  126. data/lib/mongo/error/insufficient_iteration_count.rb +38 -0
  127. data/lib/mongo/error/invalid_address.rb +24 -0
  128. data/lib/mongo/error/invalid_application_name.rb +1 -1
  129. data/lib/mongo/error/invalid_bulk_operation.rb +1 -1
  130. data/lib/mongo/error/invalid_bulk_operation_type.rb +1 -1
  131. data/lib/mongo/error/invalid_collection_name.rb +1 -1
  132. data/lib/mongo/error/invalid_cursor_operation.rb +27 -0
  133. data/lib/mongo/error/invalid_database_name.rb +1 -1
  134. data/lib/mongo/error/invalid_document.rb +1 -1
  135. data/lib/mongo/error/invalid_file.rb +1 -1
  136. data/lib/mongo/error/invalid_file_revision.rb +1 -1
  137. data/lib/mongo/error/invalid_min_pool_size.rb +35 -0
  138. data/lib/mongo/error/invalid_nonce.rb +2 -2
  139. data/lib/mongo/error/invalid_read_concern.rb +28 -0
  140. data/lib/mongo/error/invalid_read_option.rb +35 -0
  141. data/lib/mongo/error/invalid_replacement_document.rb +1 -1
  142. data/lib/mongo/error/invalid_server_auth_host.rb +22 -0
  143. data/lib/mongo/error/invalid_server_auth_response.rb +23 -0
  144. data/lib/mongo/error/invalid_server_preference.rb +7 -1
  145. data/lib/mongo/error/invalid_session.rb +37 -0
  146. data/lib/mongo/error/invalid_signature.rb +1 -1
  147. data/lib/mongo/error/invalid_transaction_operation.rb +82 -0
  148. data/lib/mongo/error/invalid_txt_record.rb +27 -0
  149. data/lib/mongo/error/invalid_update_document.rb +1 -1
  150. data/lib/mongo/error/invalid_uri.rb +8 -7
  151. data/lib/mongo/error/invalid_write_concern.rb +3 -3
  152. data/lib/mongo/error/kms_error.rb +22 -0
  153. data/lib/mongo/error/lint_error.rb +35 -0
  154. data/lib/mongo/error/max_bson_size.rb +15 -4
  155. data/lib/mongo/error/max_message_size.rb +1 -1
  156. data/lib/mongo/error/mismatched_domain.rb +27 -0
  157. data/lib/mongo/error/missing_file_chunk.rb +1 -1
  158. data/lib/mongo/error/missing_password.rb +29 -0
  159. data/lib/mongo/error/missing_resume_token.rb +39 -0
  160. data/lib/mongo/error/missing_scram_server_signature.rb +27 -0
  161. data/lib/mongo/error/mongocryptd_spawn_error.rb +22 -0
  162. data/lib/mongo/error/multi_index_drop.rb +1 -1
  163. data/lib/mongo/error/need_primary_server.rb +1 -1
  164. data/lib/mongo/error/no_server_available.rb +14 -5
  165. data/lib/mongo/error/no_srv_records.rb +26 -0
  166. data/lib/mongo/error/notable.rb +80 -0
  167. data/lib/mongo/error/operation_failure.rb +244 -13
  168. data/lib/mongo/error/parser.rb +156 -7
  169. data/lib/mongo/error/pool_closed_error.rb +50 -0
  170. data/lib/mongo/error/raise_original_error.rb +29 -0
  171. data/lib/mongo/error/sdam_error_detection.rb +72 -0
  172. data/lib/mongo/error/server_certificate_revoked.rb +22 -0
  173. data/lib/mongo/error/session_ended.rb +27 -0
  174. data/lib/mongo/error/sessions_not_supported.rb +35 -0
  175. data/lib/mongo/error/socket_error.rb +5 -2
  176. data/lib/mongo/error/socket_timeout_error.rb +5 -2
  177. data/lib/mongo/error/unchangeable_collection_option.rb +1 -1
  178. data/lib/mongo/error/unexpected_chunk_length.rb +1 -1
  179. data/lib/mongo/error/unexpected_response.rb +1 -1
  180. data/lib/mongo/error/unknown_payload_type.rb +41 -0
  181. data/lib/mongo/error/unsupported_array_filters.rb +56 -0
  182. data/lib/mongo/error/unsupported_collation.rb +7 -2
  183. data/lib/mongo/error/unsupported_features.rb +1 -19
  184. data/lib/mongo/error/unsupported_message_type.rb +23 -0
  185. data/lib/mongo/error/unsupported_option.rb +101 -0
  186. data/lib/mongo/error/write_retryable.rb +27 -0
  187. data/lib/mongo/error.rb +130 -1
  188. data/lib/mongo/event/base.rb +42 -0
  189. data/lib/mongo/event/listeners.rb +1 -1
  190. data/lib/mongo/event/publisher.rb +1 -1
  191. data/lib/mongo/event/subscriber.rb +1 -1
  192. data/lib/mongo/event.rb +10 -11
  193. data/lib/mongo/grid/file/chunk.rb +6 -6
  194. data/lib/mongo/grid/file/info.rb +35 -5
  195. data/lib/mongo/grid/file.rb +6 -1
  196. data/lib/mongo/grid/fs_bucket.rb +76 -34
  197. data/lib/mongo/grid/stream/read.rb +47 -24
  198. data/lib/mongo/grid/stream/write.rb +34 -12
  199. data/lib/mongo/grid/stream.rb +1 -1
  200. data/lib/mongo/grid.rb +1 -1
  201. data/lib/mongo/id.rb +64 -0
  202. data/lib/mongo/index/view.rb +98 -34
  203. data/lib/mongo/index.rb +2 -1
  204. data/lib/mongo/lint.rb +102 -0
  205. data/lib/mongo/loggable.rb +6 -2
  206. data/lib/mongo/logger.rb +4 -6
  207. data/lib/mongo/monitoring/cmap_log_subscriber.rb +53 -0
  208. data/lib/mongo/monitoring/command_log_subscriber.rb +22 -5
  209. data/lib/mongo/monitoring/event/cmap/base.rb +28 -0
  210. data/lib/mongo/monitoring/event/cmap/connection_check_out_failed.rb +85 -0
  211. data/lib/mongo/monitoring/event/cmap/connection_check_out_started.rb +56 -0
  212. data/lib/mongo/monitoring/event/cmap/connection_checked_in.rb +71 -0
  213. data/lib/mongo/monitoring/event/cmap/connection_checked_out.rb +72 -0
  214. data/lib/mongo/monitoring/event/cmap/connection_closed.rb +103 -0
  215. data/lib/mongo/monitoring/event/cmap/connection_created.rb +64 -0
  216. data/lib/mongo/monitoring/event/cmap/connection_ready.rb +64 -0
  217. data/lib/mongo/monitoring/event/cmap/pool_cleared.rb +57 -0
  218. data/lib/mongo/monitoring/event/cmap/pool_closed.rb +65 -0
  219. data/lib/mongo/monitoring/event/cmap/pool_created.rb +72 -0
  220. data/lib/mongo/monitoring/event/cmap.rb +25 -0
  221. data/lib/mongo/monitoring/event/command_failed.rb +30 -6
  222. data/lib/mongo/monitoring/event/command_started.rb +82 -6
  223. data/lib/mongo/monitoring/event/command_succeeded.rb +16 -3
  224. data/lib/mongo/monitoring/event/secure.rb +23 -3
  225. data/lib/mongo/monitoring/event/server_closed.rb +15 -2
  226. data/lib/mongo/monitoring/event/server_description_changed.rb +41 -3
  227. data/lib/mongo/monitoring/event/server_heartbeat_failed.rb +78 -0
  228. data/lib/mongo/monitoring/event/server_heartbeat_started.rb +62 -0
  229. data/lib/mongo/monitoring/event/server_heartbeat_succeeded.rb +70 -0
  230. data/lib/mongo/monitoring/event/server_opening.rb +15 -2
  231. data/lib/mongo/monitoring/event/topology_changed.rb +16 -2
  232. data/lib/mongo/monitoring/event/topology_closed.rb +15 -2
  233. data/lib/mongo/monitoring/event/topology_opening.rb +15 -2
  234. data/lib/mongo/monitoring/event.rb +6 -1
  235. data/lib/mongo/monitoring/publishable.rb +27 -45
  236. data/lib/mongo/monitoring/sdam_log_subscriber.rb +1 -1
  237. data/lib/mongo/monitoring/server_closed_log_subscriber.rb +1 -1
  238. data/lib/mongo/monitoring/server_description_changed_log_subscriber.rb +10 -2
  239. data/lib/mongo/monitoring/server_opening_log_subscriber.rb +1 -1
  240. data/lib/mongo/monitoring/topology_changed_log_subscriber.rb +5 -5
  241. data/lib/mongo/monitoring/topology_closed_log_subscriber.rb +30 -0
  242. data/lib/mongo/monitoring/topology_opening_log_subscriber.rb +2 -2
  243. data/lib/mongo/monitoring/unified_sdam_log_subscriber.rb +62 -0
  244. data/lib/mongo/monitoring.rb +198 -67
  245. data/lib/mongo/operation/aggregate/command.rb +44 -0
  246. data/lib/mongo/operation/aggregate/op_msg.rb +31 -0
  247. data/lib/mongo/operation/aggregate/result.rb +101 -0
  248. data/lib/mongo/operation/aggregate.rb +36 -0
  249. data/lib/mongo/operation/collections_info/command.rb +45 -0
  250. data/lib/mongo/operation/collections_info/result.rb +56 -0
  251. data/lib/mongo/operation/collections_info.rb +31 -0
  252. data/lib/mongo/operation/command/command.rb +38 -0
  253. data/lib/mongo/operation/command/op_msg.rb +28 -0
  254. data/lib/mongo/operation/command.rb +31 -0
  255. data/lib/mongo/operation/count/command.rb +38 -0
  256. data/lib/mongo/operation/count/op_msg.rb +29 -0
  257. data/lib/mongo/operation/count.rb +31 -0
  258. data/lib/mongo/operation/create/command.rb +38 -0
  259. data/lib/mongo/operation/create/op_msg.rb +29 -0
  260. data/lib/mongo/operation/create.rb +31 -0
  261. data/lib/mongo/operation/create_index/command.rb +42 -0
  262. data/lib/mongo/operation/create_index/op_msg.rb +38 -0
  263. data/lib/mongo/operation/create_index.rb +31 -0
  264. data/lib/mongo/operation/create_user/command.rb +43 -0
  265. data/lib/mongo/operation/create_user/op_msg.rb +35 -0
  266. data/lib/mongo/operation/create_user.rb +31 -0
  267. data/lib/mongo/operation/delete/bulk_result.rb +48 -0
  268. data/lib/mongo/operation/delete/command.rb +46 -0
  269. data/lib/mongo/operation/delete/legacy.rb +54 -0
  270. data/lib/mongo/operation/delete/op_msg.rb +45 -0
  271. data/lib/mongo/operation/delete/result.rb +45 -0
  272. data/lib/mongo/operation/delete.rb +38 -0
  273. data/lib/mongo/operation/distinct/command.rb +38 -0
  274. data/lib/mongo/operation/distinct/op_msg.rb +30 -0
  275. data/lib/mongo/operation/distinct.rb +31 -0
  276. data/lib/mongo/operation/drop/command.rb +38 -0
  277. data/lib/mongo/operation/drop/op_msg.rb +29 -0
  278. data/lib/mongo/operation/drop.rb +31 -0
  279. data/lib/mongo/operation/drop_database/command.rb +38 -0
  280. data/lib/mongo/operation/drop_database/op_msg.rb +29 -0
  281. data/lib/mongo/operation/drop_database.rb +31 -0
  282. data/lib/mongo/operation/drop_index/command.rb +42 -0
  283. data/lib/mongo/operation/drop_index/op_msg.rb +35 -0
  284. data/lib/mongo/operation/drop_index.rb +31 -0
  285. data/lib/mongo/operation/explain/command.rb +43 -0
  286. data/lib/mongo/operation/explain/legacy.rb +42 -0
  287. data/lib/mongo/operation/explain/op_msg.rb +37 -0
  288. data/lib/mongo/operation/explain/result.rb +53 -0
  289. data/lib/mongo/operation/explain.rb +33 -0
  290. data/lib/mongo/operation/find/command.rb +39 -0
  291. data/lib/mongo/operation/find/legacy/result.rb +43 -0
  292. data/lib/mongo/operation/find/legacy.rb +40 -0
  293. data/lib/mongo/operation/find/op_msg.rb +31 -0
  294. data/lib/mongo/operation/find/result.rb +73 -0
  295. data/lib/mongo/operation/find.rb +33 -0
  296. data/lib/mongo/operation/get_more/command.rb +39 -0
  297. data/lib/mongo/operation/get_more/legacy.rb +36 -0
  298. data/lib/mongo/operation/get_more/op_msg.rb +30 -0
  299. data/lib/mongo/operation/get_more/result.rb +72 -0
  300. data/lib/mongo/operation/get_more.rb +33 -0
  301. data/lib/mongo/operation/indexes/command.rb +39 -0
  302. data/lib/mongo/operation/indexes/legacy.rb +45 -0
  303. data/lib/mongo/operation/indexes/op_msg.rb +31 -0
  304. data/lib/mongo/operation/indexes/result.rb +102 -0
  305. data/lib/mongo/operation/indexes.rb +33 -0
  306. data/lib/mongo/operation/insert/bulk_result.rb +109 -0
  307. data/lib/mongo/operation/insert/command.rb +56 -0
  308. data/lib/mongo/operation/insert/legacy.rb +65 -0
  309. data/lib/mongo/operation/insert/op_msg.rb +51 -0
  310. data/lib/mongo/operation/insert/result.rb +72 -0
  311. data/lib/mongo/operation/insert.rb +41 -0
  312. data/lib/mongo/operation/kill_cursors/command.rb +37 -0
  313. data/lib/mongo/operation/kill_cursors/legacy.rb +37 -0
  314. data/lib/mongo/operation/kill_cursors/op_msg.rb +29 -0
  315. data/lib/mongo/operation/kill_cursors.rb +8 -16
  316. data/lib/mongo/operation/list_collections/command.rb +43 -0
  317. data/lib/mongo/operation/list_collections/op_msg.rb +36 -0
  318. data/lib/mongo/operation/list_collections/result.rb +107 -0
  319. data/lib/mongo/operation/list_collections.rb +32 -0
  320. data/lib/mongo/operation/map_reduce/command.rb +40 -0
  321. data/lib/mongo/operation/map_reduce/op_msg.rb +31 -0
  322. data/lib/mongo/operation/map_reduce/result.rb +139 -0
  323. data/lib/mongo/operation/map_reduce.rb +32 -0
  324. data/lib/mongo/operation/op_msg_base.rb +30 -0
  325. data/lib/mongo/operation/parallel_scan/command.rb +55 -0
  326. data/lib/mongo/operation/parallel_scan/op_msg.rb +43 -0
  327. data/lib/mongo/operation/parallel_scan/result.rb +65 -0
  328. data/lib/mongo/operation/parallel_scan.rb +32 -0
  329. data/lib/mongo/operation/remove_user/command.rb +43 -0
  330. data/lib/mongo/operation/remove_user/op_msg.rb +35 -0
  331. data/lib/mongo/operation/remove_user.rb +31 -0
  332. data/lib/mongo/operation/result.rb +190 -39
  333. data/lib/mongo/operation/shared/bypass_document_validation.rb +43 -0
  334. data/lib/mongo/operation/shared/causal_consistency_supported.rb +42 -0
  335. data/lib/mongo/operation/shared/collections_info_or_list_collections.rb +58 -0
  336. data/lib/mongo/operation/shared/executable.rb +106 -0
  337. data/lib/mongo/operation/shared/executable_no_validate.rb +29 -0
  338. data/lib/mongo/operation/shared/executable_transaction_label.rb +27 -0
  339. data/lib/mongo/operation/shared/idable.rb +65 -0
  340. data/lib/mongo/operation/shared/limited.rb +39 -0
  341. data/lib/mongo/operation/shared/object_id_generator.rb +37 -0
  342. data/lib/mongo/operation/shared/op_msg_or_command.rb +44 -0
  343. data/lib/mongo/operation/shared/op_msg_or_find_command.rb +47 -0
  344. data/lib/mongo/operation/shared/op_msg_or_list_indexes_command.rb +47 -0
  345. data/lib/mongo/operation/shared/polymorphic_lookup.rb +33 -0
  346. data/lib/mongo/operation/shared/polymorphic_result.rb +47 -0
  347. data/lib/mongo/operation/shared/read_preference_supported.rb +109 -0
  348. data/lib/mongo/operation/shared/response_handling.rb +169 -0
  349. data/lib/mongo/operation/shared/result/aggregatable.rb +71 -0
  350. data/lib/mongo/operation/shared/result/use_legacy_error_parser.rb +29 -0
  351. data/lib/mongo/operation/shared/sessions_supported.rb +239 -0
  352. data/lib/mongo/operation/shared/specifiable.rb +582 -0
  353. data/lib/mongo/operation/shared/write.rb +97 -0
  354. data/lib/mongo/operation/shared/write_concern_supported.rb +40 -0
  355. data/lib/mongo/operation/update/bulk_result.rb +126 -0
  356. data/lib/mongo/operation/update/command.rb +47 -0
  357. data/lib/mongo/operation/update/legacy/result.rb +109 -0
  358. data/lib/mongo/operation/update/legacy.rb +65 -0
  359. data/lib/mongo/operation/update/op_msg.rb +45 -0
  360. data/lib/mongo/operation/update/result.rb +110 -0
  361. data/lib/mongo/operation/update.rb +38 -0
  362. data/lib/mongo/operation/update_user/command.rb +42 -0
  363. data/lib/mongo/operation/update_user/op_msg.rb +35 -0
  364. data/lib/mongo/operation/update_user.rb +31 -0
  365. data/lib/mongo/operation/users_info/command.rb +43 -0
  366. data/lib/mongo/operation/users_info/op_msg.rb +36 -0
  367. data/lib/mongo/operation/users_info/result.rb +45 -0
  368. data/lib/mongo/operation/users_info.rb +32 -0
  369. data/lib/mongo/operation.rb +65 -22
  370. data/lib/mongo/options/mapper.rb +10 -3
  371. data/lib/mongo/options/redacted.rb +1 -1
  372. data/lib/mongo/options.rb +1 -1
  373. data/lib/mongo/protocol/bit_vector.rb +5 -4
  374. data/lib/mongo/protocol/compressed.rb +135 -0
  375. data/lib/mongo/protocol/delete.rb +9 -7
  376. data/lib/mongo/protocol/get_more.rb +17 -14
  377. data/lib/mongo/protocol/insert.rb +12 -8
  378. data/lib/mongo/protocol/kill_cursors.rb +15 -20
  379. data/lib/mongo/protocol/message.rb +166 -27
  380. data/lib/mongo/protocol/msg.rb +381 -0
  381. data/lib/mongo/protocol/query.rb +65 -10
  382. data/lib/mongo/protocol/registry.rb +76 -0
  383. data/lib/mongo/protocol/reply.rb +20 -15
  384. data/lib/mongo/protocol/serializers.rb +280 -12
  385. data/lib/mongo/protocol/update.rb +15 -9
  386. data/lib/mongo/protocol.rb +3 -0
  387. data/lib/mongo/query_cache.rb +242 -0
  388. data/lib/mongo/retryable.rb +411 -47
  389. data/lib/mongo/semaphore.rb +46 -0
  390. data/lib/mongo/server/app_metadata.rb +211 -0
  391. data/lib/mongo/server/connection.rb +223 -109
  392. data/lib/mongo/server/connection_base.rb +250 -0
  393. data/lib/mongo/server/connection_common.rb +135 -0
  394. data/lib/mongo/server/connection_pool/populator.rb +58 -0
  395. data/lib/mongo/server/connection_pool.rb +717 -58
  396. data/lib/mongo/server/context.rb +13 -13
  397. data/lib/mongo/server/description/features.rb +71 -14
  398. data/lib/mongo/server/description.rb +257 -70
  399. data/lib/mongo/server/monitor/app_metadata.rb +34 -0
  400. data/lib/mongo/server/monitor/connection.rb +177 -66
  401. data/lib/mongo/server/monitor.rb +232 -93
  402. data/lib/mongo/server/pending_connection.rb +255 -0
  403. data/lib/mongo/server/push_monitor/connection.rb +28 -0
  404. data/lib/mongo/server/push_monitor.rb +173 -0
  405. data/lib/mongo/server/round_trip_time_averager.rb +73 -0
  406. data/lib/mongo/server.rb +365 -54
  407. data/lib/mongo/server_selector/base.rb +622 -0
  408. data/lib/mongo/server_selector/nearest.rb +31 -20
  409. data/lib/mongo/server_selector/primary.rb +30 -14
  410. data/lib/mongo/server_selector/primary_preferred.rb +37 -24
  411. data/lib/mongo/server_selector/secondary.rb +31 -20
  412. data/lib/mongo/server_selector/secondary_preferred.rb +37 -22
  413. data/lib/mongo/server_selector.rb +14 -3
  414. data/lib/mongo/session/server_session.rb +119 -0
  415. data/lib/mongo/session/session_pool.rb +150 -0
  416. data/lib/mongo/session.rb +1067 -0
  417. data/lib/mongo/socket/ocsp_cache.rb +97 -0
  418. data/lib/mongo/socket/ocsp_verifier.rb +368 -0
  419. data/lib/mongo/socket/ssl.rb +278 -67
  420. data/lib/mongo/socket/tcp.rb +45 -32
  421. data/lib/mongo/socket/unix.rb +21 -34
  422. data/lib/mongo/socket.rb +273 -49
  423. data/lib/mongo/srv/monitor.rb +121 -0
  424. data/lib/mongo/srv/resolver.rb +134 -0
  425. data/lib/mongo/srv/result.rb +125 -0
  426. data/lib/mongo/srv.rb +17 -0
  427. data/lib/mongo/timeout.rb +51 -0
  428. data/lib/mongo/topology_version.rb +89 -0
  429. data/lib/mongo/uri/options_mapper.rb +582 -0
  430. data/lib/mongo/uri/srv_protocol.rb +238 -0
  431. data/lib/mongo/uri.rb +269 -320
  432. data/lib/mongo/utils.rb +73 -0
  433. data/lib/mongo/version.rb +2 -2
  434. data/lib/mongo/write_concern/acknowledged.rb +14 -4
  435. data/lib/mongo/write_concern/base.rb +67 -0
  436. data/lib/mongo/write_concern/unacknowledged.rb +14 -4
  437. data/lib/mongo/write_concern.rb +16 -35
  438. data/lib/mongo.rb +43 -5
  439. data/mongo.gemspec +14 -6
  440. data/spec/NOTES.aws-auth.md +296 -0
  441. data/spec/README.aws-auth.md +318 -0
  442. data/spec/README.md +692 -0
  443. data/spec/USERS.md +72 -0
  444. data/spec/atlas/atlas_connectivity_spec.rb +24 -0
  445. data/spec/atlas/operations_spec.rb +25 -0
  446. data/spec/integration/auth_spec.rb +266 -0
  447. data/spec/integration/awaited_ismaster_spec.rb +28 -0
  448. data/spec/integration/aws_auth_request_spec.rb +74 -0
  449. data/spec/integration/aws_credentials_retriever_spec.rb +103 -0
  450. data/spec/integration/bson_symbol_spec.rb +36 -0
  451. data/spec/integration/bulk_insert_spec.rb +80 -0
  452. data/spec/integration/bulk_write_spec.rb +67 -0
  453. data/spec/integration/change_stream_examples_spec.rb +205 -0
  454. data/spec/integration/change_stream_spec.rb +805 -0
  455. data/spec/integration/check_clean_slate_spec.rb +16 -0
  456. data/spec/integration/client_authentication_options_spec.rb +501 -0
  457. data/spec/integration/client_connectivity_spec.rb +38 -0
  458. data/spec/integration/client_construction_aws_auth_spec.rb +191 -0
  459. data/spec/integration/client_construction_spec.rb +236 -0
  460. data/spec/integration/client_side_encryption/auto_encryption_bulk_writes_spec.rb +357 -0
  461. data/spec/integration/client_side_encryption/auto_encryption_command_monitoring_spec.rb +303 -0
  462. data/spec/integration/client_side_encryption/auto_encryption_mongocryptd_spawn_spec.rb +72 -0
  463. data/spec/integration/client_side_encryption/auto_encryption_old_wire_version_spec.rb +79 -0
  464. data/spec/integration/client_side_encryption/auto_encryption_reconnect_spec.rb +221 -0
  465. data/spec/integration/client_side_encryption/auto_encryption_spec.rb +601 -0
  466. data/spec/integration/client_side_encryption/bson_size_limit_spec.rb +187 -0
  467. data/spec/integration/client_side_encryption/bypass_mongocryptd_spawn_spec.rb +78 -0
  468. data/spec/integration/client_side_encryption/client_close_spec.rb +63 -0
  469. data/spec/integration/client_side_encryption/corpus_spec.rb +233 -0
  470. data/spec/integration/client_side_encryption/custom_endpoint_spec.rb +132 -0
  471. data/spec/integration/client_side_encryption/data_key_spec.rb +165 -0
  472. data/spec/integration/client_side_encryption/explicit_encryption_spec.rb +114 -0
  473. data/spec/integration/client_side_encryption/external_key_vault_spec.rb +141 -0
  474. data/spec/integration/client_side_encryption/views_spec.rb +44 -0
  475. data/spec/integration/client_spec.rb +44 -0
  476. data/spec/integration/client_update_spec.rb +154 -0
  477. data/spec/integration/collection_indexes_prose_spec.rb +55 -0
  478. data/spec/integration/command_monitoring_spec.rb +146 -0
  479. data/spec/integration/command_spec.rb +176 -0
  480. data/spec/integration/connect_single_rs_name_spec.rb +72 -0
  481. data/spec/integration/connection_pool_populator_spec.rb +302 -0
  482. data/spec/integration/connection_spec.rb +331 -0
  483. data/spec/integration/crud_spec.rb +162 -0
  484. data/spec/integration/cursor_reaping_spec.rb +136 -0
  485. data/spec/integration/docs_examples_spec.rb +197 -0
  486. data/spec/integration/error_detection_spec.rb +39 -0
  487. data/spec/integration/fork_reconnect_spec.rb +198 -0
  488. data/spec/integration/get_more_spec.rb +39 -0
  489. data/spec/integration/grid_fs_bucket_spec.rb +48 -0
  490. data/spec/integration/heartbeat_events_spec.rb +99 -0
  491. data/spec/integration/mmapv1_spec.rb +28 -0
  492. data/spec/integration/mongos_pinning_spec.rb +34 -0
  493. data/spec/integration/ocsp_connectivity_spec.rb +26 -0
  494. data/spec/integration/ocsp_verifier_cache_spec.rb +188 -0
  495. data/spec/integration/ocsp_verifier_spec.rb +334 -0
  496. data/spec/integration/operation_failure_code_spec.rb +26 -0
  497. data/spec/integration/query_cache_spec.rb +1045 -0
  498. data/spec/integration/query_cache_transactions_spec.rb +190 -0
  499. data/spec/integration/read_concern_spec.rb +89 -0
  500. data/spec/integration/read_preference_spec.rb +541 -0
  501. data/spec/integration/reconnect_spec.rb +174 -0
  502. data/spec/integration/retryable_errors_spec.rb +283 -0
  503. data/spec/integration/retryable_writes/retryable_writes_36_and_older_spec.rb +761 -0
  504. data/spec/integration/retryable_writes/retryable_writes_40_and_newer_spec.rb +402 -0
  505. data/spec/integration/retryable_writes/shared/adds_diagnostics.rb +15 -0
  506. data/spec/integration/retryable_writes/shared/does_not_support_retries.rb +24 -0
  507. data/spec/integration/retryable_writes/shared/only_supports_legacy_retries.rb +25 -0
  508. data/spec/integration/retryable_writes/shared/performs_legacy_retries.rb +217 -0
  509. data/spec/integration/retryable_writes/shared/performs_modern_retries.rb +232 -0
  510. data/spec/integration/retryable_writes/shared/performs_no_retries.rb +110 -0
  511. data/spec/integration/retryable_writes/shared/supports_legacy_retries.rb +19 -0
  512. data/spec/integration/retryable_writes/shared/supports_modern_retries.rb +25 -0
  513. data/spec/integration/retryable_writes/shared/supports_retries.rb +16 -0
  514. data/spec/integration/retryable_writes_errors_spec.rb +31 -0
  515. data/spec/integration/sdam_error_handling_spec.rb +421 -0
  516. data/spec/integration/sdam_events_spec.rb +118 -0
  517. data/spec/integration/sdam_prose_spec.rb +64 -0
  518. data/spec/integration/server_description_spec.rb +45 -0
  519. data/spec/integration/server_monitor_spec.rb +52 -0
  520. data/spec/integration/server_selection_spec.rb +36 -0
  521. data/spec/integration/server_selector_spec.rb +85 -0
  522. data/spec/integration/server_spec.rb +64 -0
  523. data/spec/integration/shell_examples_spec.rb +981 -0
  524. data/spec/integration/size_limit_spec.rb +112 -0
  525. data/spec/integration/srv_monitoring_spec.rb +403 -0
  526. data/spec/integration/srv_spec.rb +56 -0
  527. data/spec/integration/ssl_uri_options_spec.rb +25 -0
  528. data/spec/integration/step_down_spec.rb +204 -0
  529. data/spec/integration/time_zone_querying_spec.rb +52 -0
  530. data/spec/integration/transactions_api_examples_spec.rb +59 -0
  531. data/spec/integration/transactions_examples_spec.rb +226 -0
  532. data/spec/integration/x509_auth_spec.rb +109 -0
  533. data/spec/integration/zlib_compression_spec.rb +25 -0
  534. data/spec/kerberos/kerberos_spec.rb +91 -0
  535. data/spec/lite_spec_helper.rb +158 -0
  536. data/spec/mongo/address/ipv4_spec.rb +5 -1
  537. data/spec/mongo/address/ipv6_spec.rb +33 -1
  538. data/spec/mongo/address/unix_spec.rb +1 -1
  539. data/spec/mongo/address/validator_spec.rb +51 -0
  540. data/spec/mongo/address_spec.rb +113 -7
  541. data/spec/mongo/auth/aws/request_region_spec.rb +42 -0
  542. data/spec/mongo/auth/aws/request_spec.rb +76 -0
  543. data/spec/mongo/auth/cr_spec.rb +30 -32
  544. data/spec/mongo/auth/gssapi/conversation_spec.rb +121 -0
  545. data/spec/mongo/auth/invalid_mechanism_spec.rb +11 -0
  546. data/spec/mongo/auth/ldap/conversation_spec.rb +2 -2
  547. data/spec/mongo/auth/ldap_spec.rb +11 -30
  548. data/spec/mongo/auth/scram/conversation_spec.rb +63 -58
  549. data/spec/mongo/auth/scram256/conversation_spec.rb +171 -0
  550. data/spec/mongo/auth/scram_negotiation_spec.rb +528 -0
  551. data/spec/mongo/auth/scram_spec.rb +92 -47
  552. data/spec/mongo/auth/stringprep/profiles/sasl_spec.rb +113 -0
  553. data/spec/mongo/auth/stringprep_spec.rb +188 -0
  554. data/spec/mongo/auth/user/view_spec.rb +401 -70
  555. data/spec/mongo/auth/user_spec.rb +162 -12
  556. data/spec/mongo/auth/x509/conversation_spec.rb +2 -2
  557. data/spec/mongo/auth/x509_spec.rb +40 -29
  558. data/spec/mongo/auth_spec.rb +4 -4
  559. data/spec/mongo/bulk_write/ordered_combiner_spec.rb +6 -6
  560. data/spec/mongo/bulk_write/result_spec.rb +124 -0
  561. data/spec/mongo/bulk_write/unordered_combiner_spec.rb +4 -4
  562. data/spec/mongo/bulk_write_spec.rb +803 -236
  563. data/spec/mongo/caching_cursor_spec.rb +70 -0
  564. data/spec/mongo/client_construction_spec.rb +2210 -0
  565. data/spec/mongo/client_encryption_spec.rb +411 -0
  566. data/spec/mongo/client_spec.rb +492 -431
  567. data/spec/mongo/cluster/cursor_reaper_spec.rb +40 -69
  568. data/spec/mongo/cluster/periodic_executor_spec.rb +16 -0
  569. data/spec/mongo/cluster/socket_reaper_spec.rb +43 -0
  570. data/spec/mongo/cluster/topology/replica_set_spec.rb +247 -226
  571. data/spec/mongo/cluster/topology/sharded_spec.rb +56 -55
  572. data/spec/mongo/cluster/topology/single_spec.rb +91 -31
  573. data/spec/mongo/cluster/topology/unknown_spec.rb +30 -115
  574. data/spec/mongo/cluster/topology_spec.rb +132 -19
  575. data/spec/mongo/cluster_spec.rb +447 -159
  576. data/spec/mongo/cluster_time_spec.rb +148 -0
  577. data/spec/mongo/collection/view/aggregation_spec.rb +143 -41
  578. data/spec/mongo/collection/view/builder/find_command_spec.rb +76 -10
  579. data/spec/mongo/collection/view/change_stream_resume_spec.rb +392 -0
  580. data/spec/mongo/collection/view/change_stream_spec.rb +531 -0
  581. data/spec/mongo/collection/view/explainable_spec.rb +88 -5
  582. data/spec/mongo/collection/view/immutable_spec.rb +1 -1
  583. data/spec/mongo/collection/view/iterable_spec.rb +38 -0
  584. data/spec/mongo/collection/view/map_reduce_spec.rb +253 -32
  585. data/spec/mongo/collection/view/readable_spec.rb +125 -60
  586. data/spec/mongo/collection/view/writable_spec.rb +273 -34
  587. data/spec/mongo/collection/view_spec.rb +10 -9
  588. data/spec/mongo/collection_spec.rb +2533 -232
  589. data/spec/mongo/crypt/auto_decryption_context_spec.rb +90 -0
  590. data/spec/mongo/crypt/auto_encrypter_spec.rb +187 -0
  591. data/spec/mongo/crypt/auto_encryption_context_spec.rb +107 -0
  592. data/spec/mongo/crypt/binary_spec.rb +110 -0
  593. data/spec/mongo/crypt/binding/binary_spec.rb +51 -0
  594. data/spec/mongo/crypt/binding/context_spec.rb +252 -0
  595. data/spec/mongo/crypt/binding/helpers_spec.rb +41 -0
  596. data/spec/mongo/crypt/binding/mongocrypt_spec.rb +139 -0
  597. data/spec/mongo/crypt/binding/status_spec.rb +94 -0
  598. data/spec/mongo/crypt/binding/version_spec.rb +17 -0
  599. data/spec/mongo/crypt/binding_unloaded_spec.rb +20 -0
  600. data/spec/mongo/crypt/data_key_context_spec.rb +213 -0
  601. data/spec/mongo/crypt/encryption_io_spec.rb +136 -0
  602. data/spec/mongo/crypt/explicit_decryption_context_spec.rb +72 -0
  603. data/spec/mongo/crypt/explicit_encryption_context_spec.rb +170 -0
  604. data/spec/mongo/crypt/handle_spec.rb +232 -0
  605. data/spec/mongo/crypt/helpers/mongo_crypt_spec_helper.rb +108 -0
  606. data/spec/mongo/crypt/status_spec.rb +147 -0
  607. data/spec/mongo/cursor/builder/get_more_command_spec.rb +37 -11
  608. data/spec/mongo/cursor/builder/op_get_more_spec.rb +11 -4
  609. data/spec/mongo/cursor/builder/op_kill_cursors_spec.rb +61 -0
  610. data/spec/mongo/cursor_spec.rb +317 -46
  611. data/spec/mongo/database_spec.rb +739 -65
  612. data/spec/mongo/distinguishing_semaphore_spec.rb +63 -0
  613. data/spec/mongo/error/bulk_write_error_spec.rb +49 -0
  614. data/spec/mongo/error/crypt_error_spec.rb +26 -0
  615. data/spec/mongo/error/max_bson_size_spec.rb +35 -0
  616. data/spec/mongo/error/no_server_available_spec.rb +32 -0
  617. data/spec/mongo/error/notable_spec.rb +59 -0
  618. data/spec/mongo/error/operation_failure_heavy_spec.rb +58 -0
  619. data/spec/mongo/error/operation_failure_spec.rb +490 -0
  620. data/spec/mongo/error/parser_spec.rb +392 -5
  621. data/spec/mongo/error/unsupported_option_spec.rb +54 -0
  622. data/spec/mongo/grid/file/info_spec.rb +3 -3
  623. data/spec/mongo/grid/fs_bucket_spec.rb +299 -191
  624. data/spec/mongo/grid/stream/read_spec.rb +13 -19
  625. data/spec/mongo/grid/stream/write_spec.rb +88 -28
  626. data/spec/mongo/id_spec.rb +35 -0
  627. data/spec/mongo/index/view_spec.rb +511 -140
  628. data/spec/mongo/lint_spec.rb +228 -0
  629. data/spec/mongo/logger_spec.rb +14 -12
  630. data/spec/mongo/monitoring/event/cmap/connection_check_out_failed_spec.rb +23 -0
  631. data/spec/mongo/monitoring/event/cmap/connection_check_out_started_spec.rb +19 -0
  632. data/spec/mongo/monitoring/event/cmap/connection_checked_in_spec.rb +30 -0
  633. data/spec/mongo/monitoring/event/cmap/connection_checked_out_spec.rb +30 -0
  634. data/spec/mongo/monitoring/event/cmap/connection_closed_spec.rb +27 -0
  635. data/spec/mongo/monitoring/event/cmap/connection_created_spec.rb +24 -0
  636. data/spec/mongo/monitoring/event/cmap/connection_ready_spec.rb +24 -0
  637. data/spec/mongo/monitoring/event/cmap/pool_cleared_spec.rb +19 -0
  638. data/spec/mongo/monitoring/event/cmap/pool_closed_spec.rb +26 -0
  639. data/spec/mongo/monitoring/event/cmap/pool_created_spec.rb +33 -0
  640. data/spec/mongo/monitoring/event/command_failed_spec.rb +30 -0
  641. data/spec/mongo/monitoring/event/command_started_spec.rb +27 -5
  642. data/spec/mongo/monitoring/event/command_succeeded_spec.rb +30 -8
  643. data/spec/mongo/monitoring/event/secure_spec.rb +43 -1
  644. data/spec/mongo/monitoring/event/server_closed_spec.rb +35 -0
  645. data/spec/mongo/monitoring/event/server_description_changed_spec.rb +35 -0
  646. data/spec/mongo/monitoring/event/server_heartbeat_failed_spec.rb +31 -0
  647. data/spec/mongo/monitoring/event/server_heartbeat_started_spec.rb +31 -0
  648. data/spec/mongo/monitoring/event/server_heartbeat_succeeded_spec.rb +31 -0
  649. data/spec/mongo/monitoring/event/server_opening_spec.rb +35 -0
  650. data/spec/mongo/monitoring/event/topology_changed_spec.rb +41 -0
  651. data/spec/mongo/monitoring/event/topology_closed_spec.rb +35 -0
  652. data/spec/mongo/monitoring/event/topology_opening_spec.rb +35 -0
  653. data/spec/mongo/monitoring_spec.rb +30 -5
  654. data/spec/mongo/operation/aggregate/result_spec.rb +85 -0
  655. data/spec/mongo/operation/aggregate_spec.rb +72 -0
  656. data/spec/mongo/operation/collections_info_spec.rb +42 -0
  657. data/spec/mongo/operation/command_spec.rb +80 -0
  658. data/spec/mongo/operation/create_index_spec.rb +56 -0
  659. data/spec/mongo/operation/create_user_spec.rb +47 -0
  660. data/spec/mongo/operation/delete/bulk_spec.rb +239 -0
  661. data/spec/mongo/operation/delete/command_spec.rb +112 -0
  662. data/spec/mongo/operation/delete/op_msg_spec.rb +254 -0
  663. data/spec/mongo/operation/delete_spec.rb +226 -0
  664. data/spec/mongo/operation/drop_index_spec.rb +54 -0
  665. data/spec/mongo/operation/find/legacy_spec.rb +125 -0
  666. data/spec/mongo/operation/get_more_spec.rb +58 -0
  667. data/spec/mongo/operation/indexes_spec.rb +34 -0
  668. data/spec/mongo/operation/insert/bulk_spec.rb +267 -0
  669. data/spec/mongo/operation/insert/command_spec.rb +115 -0
  670. data/spec/mongo/operation/insert/op_msg_spec.rb +285 -0
  671. data/spec/mongo/operation/insert_spec.rb +284 -0
  672. data/spec/mongo/operation/kill_cursors_spec.rb +4 -4
  673. data/spec/mongo/operation/limited_spec.rb +5 -3
  674. data/spec/mongo/operation/map_reduce_spec.rb +125 -0
  675. data/spec/mongo/operation/read_preference_legacy_spec.rb +363 -0
  676. data/spec/mongo/operation/read_preference_op_msg_spec.rb +304 -0
  677. data/spec/mongo/operation/remove_user_spec.rb +46 -0
  678. data/spec/mongo/operation/result_spec.rb +39 -4
  679. data/spec/mongo/operation/specifiable_spec.rb +2 -2
  680. data/spec/mongo/operation/update/bulk_spec.rb +233 -0
  681. data/spec/mongo/operation/update/command_spec.rb +119 -0
  682. data/spec/mongo/operation/update/op_msg_spec.rb +260 -0
  683. data/spec/mongo/operation/update_spec.rb +258 -0
  684. data/spec/mongo/operation/update_user_spec.rb +46 -0
  685. data/spec/mongo/protocol/compressed_spec.rb +66 -0
  686. data/spec/mongo/protocol/delete_spec.rb +24 -9
  687. data/spec/mongo/protocol/get_more_spec.rb +26 -11
  688. data/spec/mongo/protocol/insert_spec.rb +24 -9
  689. data/spec/mongo/protocol/kill_cursors_spec.rb +21 -6
  690. data/spec/mongo/protocol/msg_spec.rb +525 -0
  691. data/spec/mongo/protocol/query_spec.rb +56 -11
  692. data/spec/mongo/protocol/registry_spec.rb +31 -0
  693. data/spec/mongo/protocol/reply_spec.rb +15 -1
  694. data/spec/mongo/protocol/update_spec.rb +25 -10
  695. data/spec/mongo/query_cache_spec.rb +280 -0
  696. data/spec/mongo/retryable_spec.rb +464 -97
  697. data/spec/mongo/semaphore_spec.rb +51 -0
  698. data/spec/mongo/server/app_metadata_shared.rb +136 -0
  699. data/spec/mongo/server/app_metadata_spec.rb +145 -0
  700. data/spec/mongo/server/connection_auth_spec.rb +139 -0
  701. data/spec/mongo/server/connection_pool/populator_spec.rb +101 -0
  702. data/spec/mongo/server/connection_pool_spec.rb +894 -88
  703. data/spec/mongo/server/connection_spec.rb +786 -164
  704. data/spec/mongo/server/description/features_spec.rb +51 -37
  705. data/spec/mongo/server/description_query_methods_spec.rb +288 -0
  706. data/spec/mongo/server/description_spec.rb +186 -242
  707. data/spec/mongo/server/monitor/app_metadata_spec.rb +23 -0
  708. data/spec/mongo/server/monitor/connection_spec.rb +125 -0
  709. data/spec/mongo/server/monitor_spec.rb +165 -100
  710. data/spec/mongo/server/round_trip_time_averager_spec.rb +45 -0
  711. data/spec/mongo/server_selector/nearest_spec.rb +24 -23
  712. data/spec/mongo/server_selector/primary_preferred_spec.rb +27 -26
  713. data/spec/mongo/server_selector/primary_spec.rb +27 -9
  714. data/spec/mongo/server_selector/secondary_preferred_spec.rb +40 -23
  715. data/spec/mongo/server_selector/secondary_spec.rb +19 -18
  716. data/spec/mongo/server_selector_spec.rb +260 -4
  717. data/spec/mongo/server_spec.rb +294 -78
  718. data/spec/mongo/session/server_session_spec.rb +59 -0
  719. data/spec/mongo/session/session_pool_spec.rb +237 -0
  720. data/spec/mongo/session_spec.rb +345 -0
  721. data/spec/mongo/session_transaction_spec.rb +226 -0
  722. data/spec/mongo/socket/ssl_spec.rb +459 -168
  723. data/spec/mongo/socket/tcp_spec.rb +14 -0
  724. data/spec/mongo/socket/unix_spec.rb +9 -9
  725. data/spec/mongo/socket_spec.rb +116 -0
  726. data/spec/mongo/srv/monitor_spec.rb +230 -0
  727. data/spec/mongo/srv/result_spec.rb +54 -0
  728. data/spec/mongo/timeout_spec.rb +39 -0
  729. data/spec/mongo/uri/srv_protocol_spec.rb +1104 -0
  730. data/spec/mongo/uri_option_parsing_spec.rb +589 -0
  731. data/spec/mongo/uri_spec.rb +443 -93
  732. data/spec/mongo/utils_spec.rb +39 -0
  733. data/spec/mongo/write_concern/acknowledged_spec.rb +11 -0
  734. data/spec/mongo/write_concern/unacknowledged_spec.rb +11 -0
  735. data/spec/mongo/write_concern_spec.rb +69 -4
  736. data/spec/runners/auth.rb +119 -0
  737. data/spec/runners/change_streams/outcome.rb +42 -0
  738. data/spec/runners/change_streams/spec.rb +57 -0
  739. data/spec/runners/change_streams/test.rb +229 -0
  740. data/spec/runners/cmap/verifier.rb +45 -0
  741. data/spec/runners/cmap.rb +370 -0
  742. data/spec/runners/command_monitoring.rb +343 -0
  743. data/spec/runners/connection_string.rb +382 -0
  744. data/spec/runners/crud/context.rb +27 -0
  745. data/spec/runners/crud/operation.rb +466 -0
  746. data/spec/runners/crud/outcome.rb +53 -0
  747. data/spec/runners/crud/requirement.rb +69 -0
  748. data/spec/runners/crud/spec.rb +70 -0
  749. data/spec/runners/crud/test.rb +120 -0
  750. data/spec/runners/crud/test_base.rb +50 -0
  751. data/spec/runners/crud/verifier.rb +206 -0
  752. data/spec/runners/crud.rb +235 -0
  753. data/spec/runners/gridfs.rb +638 -0
  754. data/spec/runners/read_write_concern_document.rb +67 -0
  755. data/spec/runners/sdam/verifier.rb +109 -0
  756. data/spec/runners/sdam.rb +275 -0
  757. data/spec/runners/server_selection.rb +362 -0
  758. data/spec/runners/server_selection_rtt.rb +38 -0
  759. data/spec/runners/transactions/operation.rb +314 -0
  760. data/spec/runners/transactions/spec.rb +26 -0
  761. data/spec/runners/transactions/test.rb +322 -0
  762. data/spec/runners/transactions.rb +101 -0
  763. data/spec/shared/LICENSE +20 -0
  764. data/spec/shared/lib/mrss/child_process_helper.rb +80 -0
  765. data/spec/shared/lib/mrss/constraints.rb +303 -0
  766. data/spec/shared/lib/mrss/lite_constraints.rb +175 -0
  767. data/spec/shared/lib/mrss/spec_organizer.rb +149 -0
  768. data/spec/spec_helper.rb +17 -197
  769. data/spec/spec_tests/auth_spec.rb +41 -0
  770. data/spec/spec_tests/change_streams_spec.rb +90 -0
  771. data/spec/spec_tests/client_side_encryption_spec.rb +11 -0
  772. data/spec/spec_tests/cmap_spec.rb +106 -0
  773. data/spec/spec_tests/command_monitoring_spec.rb +66 -0
  774. data/spec/spec_tests/connection_string_spec.rb +7 -0
  775. data/spec/spec_tests/crud_spec.rb +19 -0
  776. data/spec/spec_tests/data/auth/connection-string.yml +366 -0
  777. data/spec/spec_tests/data/change_streams/change-streams-errors.yml +101 -0
  778. data/spec/spec_tests/data/change_streams/change-streams-resume-errorLabels.yml +1105 -0
  779. data/spec/spec_tests/data/change_streams/change-streams-resume-whitelist.yml +1173 -0
  780. data/spec/spec_tests/data/change_streams/change-streams.yml +536 -0
  781. data/spec/spec_tests/data/client_side_encryption/aggregate.yml +134 -0
  782. data/spec/spec_tests/data/client_side_encryption/badQueries.yml +526 -0
  783. data/spec/spec_tests/data/client_side_encryption/badSchema.yml +73 -0
  784. data/spec/spec_tests/data/client_side_encryption/basic.yml +116 -0
  785. data/spec/spec_tests/data/client_side_encryption/bulk.yml +88 -0
  786. data/spec/spec_tests/data/client_side_encryption/bypassAutoEncryption.yml +100 -0
  787. data/spec/spec_tests/data/client_side_encryption/bypassedCommand.yml +42 -0
  788. data/spec/spec_tests/data/client_side_encryption/count.yml +61 -0
  789. data/spec/spec_tests/data/client_side_encryption/countDocuments.yml +59 -0
  790. data/spec/spec_tests/data/client_side_encryption/delete.yml +105 -0
  791. data/spec/spec_tests/data/client_side_encryption/distinct.yml +73 -0
  792. data/spec/spec_tests/data/client_side_encryption/explain.yml +64 -0
  793. data/spec/spec_tests/data/client_side_encryption/find.yml +119 -0
  794. data/spec/spec_tests/data/client_side_encryption/findOneAndDelete.yml +57 -0
  795. data/spec/spec_tests/data/client_side_encryption/findOneAndReplace.yml +57 -0
  796. data/spec/spec_tests/data/client_side_encryption/findOneAndUpdate.yml +57 -0
  797. data/spec/spec_tests/data/client_side_encryption/getMore.yml +68 -0
  798. data/spec/spec_tests/data/client_side_encryption/insert.yml +102 -0
  799. data/spec/spec_tests/data/client_side_encryption/keyAltName.yml +71 -0
  800. data/spec/spec_tests/data/client_side_encryption/localKMS.yml +54 -0
  801. data/spec/spec_tests/data/client_side_encryption/localSchema.yml +72 -0
  802. data/spec/spec_tests/data/client_side_encryption/malformedCiphertext.yml +69 -0
  803. data/spec/spec_tests/data/client_side_encryption/maxWireVersion.yml +20 -0
  804. data/spec/spec_tests/data/client_side_encryption/missingKey.yml +49 -0
  805. data/spec/spec_tests/data/client_side_encryption/replaceOne.yml +64 -0
  806. data/spec/spec_tests/data/client_side_encryption/types.yml +527 -0
  807. data/spec/spec_tests/data/client_side_encryption/unsupportedCommand.yml +25 -0
  808. data/spec/spec_tests/data/client_side_encryption/updateMany.yml +77 -0
  809. data/spec/spec_tests/data/client_side_encryption/updateOne.yml +171 -0
  810. data/spec/spec_tests/data/cmap/connection-must-have-id.yml +27 -0
  811. data/spec/spec_tests/data/cmap/connection-must-order-ids.yml +27 -0
  812. data/spec/spec_tests/data/cmap/pool-checkin-destroy-closed.yml +27 -0
  813. data/spec/spec_tests/data/cmap/pool-checkin-destroy-stale.yml +27 -0
  814. data/spec/spec_tests/data/cmap/pool-checkin-make-available.yml +24 -0
  815. data/spec/spec_tests/data/cmap/pool-checkin.yml +19 -0
  816. data/spec/spec_tests/data/cmap/pool-checkout-connection.yml +19 -0
  817. data/spec/spec_tests/data/cmap/pool-checkout-error-closed.yml +36 -0
  818. data/spec/spec_tests/data/cmap/pool-checkout-multiple.yml +37 -0
  819. data/spec/spec_tests/data/cmap/pool-checkout-no-idle.yml +35 -0
  820. data/spec/spec_tests/data/cmap/pool-checkout-no-stale.yml +33 -0
  821. data/spec/spec_tests/data/cmap/pool-close-destroy-conns.yml +28 -0
  822. data/spec/spec_tests/data/cmap/pool-close.yml +11 -0
  823. data/spec/spec_tests/data/cmap/pool-create-max-size.yml +71 -0
  824. data/spec/spec_tests/data/cmap/pool-create-min-size.yml +34 -0
  825. data/spec/spec_tests/data/cmap/pool-create-with-options.yml +21 -0
  826. data/spec/spec_tests/data/cmap/pool-create.yml +12 -0
  827. data/spec/spec_tests/data/cmap/wait-queue-fairness.yml +124 -0
  828. data/spec/spec_tests/data/cmap/wait-queue-timeout.yml +46 -0
  829. data/spec/spec_tests/data/command_monitoring/bulkWrite.yml +49 -0
  830. data/spec/spec_tests/data/command_monitoring/command.yml +61 -0
  831. data/spec/spec_tests/data/command_monitoring/find.yml +266 -0
  832. data/spec/spec_tests/data/command_monitoring/insertMany.yml +75 -0
  833. data/spec/spec_tests/data/command_monitoring/unacknowledgedBulkWrite.yml +34 -0
  834. data/spec/spec_tests/data/command_monitoring/updateMany.yml +65 -0
  835. data/spec/spec_tests/data/command_monitoring/updateOne.yml +90 -0
  836. data/spec/spec_tests/data/connection_string/invalid-uris.yml +261 -0
  837. data/spec/spec_tests/data/connection_string/valid-auth.yml +257 -0
  838. data/spec/spec_tests/data/connection_string/valid-db-with-dotted-name.yml +77 -0
  839. data/spec/spec_tests/data/connection_string/valid-options.yml +17 -0
  840. data/spec/spec_tests/data/connection_string/valid-unix_socket-absolute.yml +197 -0
  841. data/spec/spec_tests/data/connection_string/valid-unix_socket-relative.yml +213 -0
  842. data/spec/spec_tests/data/connection_string/valid-warnings.yml +75 -0
  843. data/spec/spec_tests/data/crud/read/aggregate-out.yml +43 -0
  844. data/spec/spec_tests/data/crud/read/count-collation.yml +25 -0
  845. data/spec/spec_tests/data/crud/read/count-empty.yml +29 -0
  846. data/spec/spec_tests/data/crud/read/count.yml +74 -0
  847. data/spec/spec_tests/data/crud/write/bulkWrite-arrayFilters.yml +45 -0
  848. data/spec/spec_tests/data/crud/write/bulkWrite-collation.yml +101 -0
  849. data/spec/spec_tests/data/crud/write/bulkWrite.yml +401 -0
  850. data/spec/spec_tests/data/crud/write/findOneAndReplace-upsert.yml +91 -0
  851. data/spec/spec_tests/data/crud/write/findOneAndReplace-upsert_pre_2.6.yml +88 -0
  852. data/spec/spec_tests/data/crud/write/findOneAndReplace.yml +113 -0
  853. data/spec/spec_tests/data/crud/write/findOneAndUpdate-arrayFilters.yml +69 -0
  854. data/spec/spec_tests/data/crud/write/findOneAndUpdate.yml +163 -0
  855. data/spec/spec_tests/data/crud/write/insertMany.yml +77 -0
  856. data/spec/spec_tests/data/crud/write/replaceOne-collation.yml +24 -0
  857. data/spec/spec_tests/data/crud/write/replaceOne-pre_2.6.yml +98 -0
  858. data/spec/spec_tests/data/crud/write/replaceOne.yml +102 -0
  859. data/spec/spec_tests/data/crud/write/updateMany-arrayFilters.yml +66 -0
  860. data/spec/spec_tests/data/crud/write/updateMany-collation.yml +28 -0
  861. data/spec/spec_tests/data/crud/write/updateMany-pre_2.6.yml +86 -0
  862. data/spec/spec_tests/data/crud/write/updateMany.yml +87 -0
  863. data/spec/spec_tests/data/crud/write/updateOne-arrayFilters.yml +114 -0
  864. data/spec/spec_tests/data/crud/write/updateOne-collation.yml +25 -0
  865. data/spec/spec_tests/data/crud/write/updateOne-pre_2.6.yml +83 -0
  866. data/spec/spec_tests/data/crud/write/updateOne.yml +84 -0
  867. data/spec/spec_tests/data/crud_v2/aggregate-merge.yml +103 -0
  868. data/spec/spec_tests/data/crud_v2/aggregate-out-readConcern.yml +110 -0
  869. data/spec/spec_tests/data/crud_v2/bulkWrite-arrayFilters.yml +103 -0
  870. data/spec/spec_tests/data/crud_v2/bulkWrite-delete-hint-clientError.yml +63 -0
  871. data/spec/spec_tests/data/crud_v2/bulkWrite-delete-hint-serverError.yml +92 -0
  872. data/spec/spec_tests/data/crud_v2/bulkWrite-delete-hint.yml +103 -0
  873. data/spec/spec_tests/data/crud_v2/bulkWrite-update-hint-clientError.yml +90 -0
  874. data/spec/spec_tests/data/crud_v2/bulkWrite-update-hint-serverError.yml +147 -0
  875. data/spec/spec_tests/data/crud_v2/bulkWrite-update-hint.yml +164 -0
  876. data/spec/spec_tests/data/crud_v2/db-aggregate.yml +38 -0
  877. data/spec/spec_tests/data/crud_v2/deleteMany-hint-clientError.yml +43 -0
  878. data/spec/spec_tests/data/crud_v2/deleteMany-hint-serverError.yml +62 -0
  879. data/spec/spec_tests/data/crud_v2/deleteMany-hint.yml +58 -0
  880. data/spec/spec_tests/data/crud_v2/deleteOne-hint-clientError.yml +41 -0
  881. data/spec/spec_tests/data/crud_v2/deleteOne-hint-serverError.yml +60 -0
  882. data/spec/spec_tests/data/crud_v2/deleteOne-hint.yml +57 -0
  883. data/spec/spec_tests/data/crud_v2/find-allowdiskuse-clientError.yml +28 -0
  884. data/spec/spec_tests/data/crud_v2/find-allowdiskuse-serverError.yml +44 -0
  885. data/spec/spec_tests/data/crud_v2/find-allowdiskuse.yml +50 -0
  886. data/spec/spec_tests/data/crud_v2/findOneAndDelete-hint-clientError.yml +45 -0
  887. data/spec/spec_tests/data/crud_v2/findOneAndDelete-hint-serverError.yml +60 -0
  888. data/spec/spec_tests/data/crud_v2/findOneAndDelete-hint.yml +56 -0
  889. data/spec/spec_tests/data/crud_v2/findOneAndReplace-hint-clientError.yml +40 -0
  890. data/spec/spec_tests/data/crud_v2/findOneAndReplace-hint-serverError.yml +59 -0
  891. data/spec/spec_tests/data/crud_v2/findOneAndReplace-hint.yml +55 -0
  892. data/spec/spec_tests/data/crud_v2/findOneAndUpdate-hint-clientError.yml +40 -0
  893. data/spec/spec_tests/data/crud_v2/findOneAndUpdate-hint-serverError.yml +58 -0
  894. data/spec/spec_tests/data/crud_v2/findOneAndUpdate-hint.yml +55 -0
  895. data/spec/spec_tests/data/crud_v2/replaceOne-hint.yml +61 -0
  896. data/spec/spec_tests/data/crud_v2/unacknowledged-bulkWrite-delete-hint-clientError.yml +60 -0
  897. data/spec/spec_tests/data/crud_v2/unacknowledged-bulkWrite-update-hint-clientError.yml +88 -0
  898. data/spec/spec_tests/data/crud_v2/unacknowledged-deleteMany-hint-clientError.yml +40 -0
  899. data/spec/spec_tests/data/crud_v2/unacknowledged-deleteOne-hint-clientError.yml +38 -0
  900. data/spec/spec_tests/data/crud_v2/unacknowledged-findOneAndDelete-hint-clientError.yml +42 -0
  901. data/spec/spec_tests/data/crud_v2/unacknowledged-findOneAndReplace-hint-clientError.yml +40 -0
  902. data/spec/spec_tests/data/crud_v2/unacknowledged-findOneAndUpdate-hint-clientError.yml +40 -0
  903. data/spec/spec_tests/data/crud_v2/unacknowledged-replaceOne-hint-clientError.yml +40 -0
  904. data/spec/spec_tests/data/crud_v2/unacknowledged-updateMany-hint-clientError.yml +43 -0
  905. data/spec/spec_tests/data/crud_v2/unacknowledged-updateOne-hint-clientError.yml +40 -0
  906. data/spec/spec_tests/data/crud_v2/updateMany-hint-clientError.yml +45 -0
  907. data/spec/spec_tests/data/crud_v2/updateMany-hint-serverError.yml +66 -0
  908. data/spec/spec_tests/data/crud_v2/updateMany-hint.yml +65 -0
  909. data/spec/spec_tests/data/crud_v2/updateOne-hint-clientError.yml +43 -0
  910. data/spec/spec_tests/data/crud_v2/updateOne-hint-serverError.yml +62 -0
  911. data/spec/spec_tests/data/crud_v2/updateOne-hint.yml +61 -0
  912. data/spec/spec_tests/data/crud_v2/updateWithPipelines.yml +157 -0
  913. data/spec/spec_tests/data/dns_seedlist_discovery/direct-connection-false.yml +10 -0
  914. data/spec/spec_tests/data/dns_seedlist_discovery/direct-connection-true.yml +5 -0
  915. data/spec/spec_tests/data/dns_seedlist_discovery/longer-parent-in-return.yml +11 -0
  916. data/spec/spec_tests/data/dns_seedlist_discovery/misformatted-option.yml +5 -0
  917. data/spec/spec_tests/data/dns_seedlist_discovery/no-results.yml +5 -0
  918. data/spec/spec_tests/data/dns_seedlist_discovery/not-enough-parts.yml +5 -0
  919. data/spec/spec_tests/data/dns_seedlist_discovery/one-result-default-port.yml +10 -0
  920. data/spec/spec_tests/data/dns_seedlist_discovery/one-txt-record-multiple-strings.yml +10 -0
  921. data/spec/spec_tests/data/dns_seedlist_discovery/one-txt-record.yml +11 -0
  922. data/spec/spec_tests/data/dns_seedlist_discovery/parent-part-mismatch1.yml +5 -0
  923. data/spec/spec_tests/data/dns_seedlist_discovery/parent-part-mismatch2.yml +5 -0
  924. data/spec/spec_tests/data/dns_seedlist_discovery/parent-part-mismatch3.yml +5 -0
  925. data/spec/spec_tests/data/dns_seedlist_discovery/parent-part-mismatch4.yml +5 -0
  926. data/spec/spec_tests/data/dns_seedlist_discovery/parent-part-mismatch5.yml +5 -0
  927. data/spec/spec_tests/data/dns_seedlist_discovery/returned-parent-too-short.yml +5 -0
  928. data/spec/spec_tests/data/dns_seedlist_discovery/returned-parent-wrong.yml +5 -0
  929. data/spec/spec_tests/data/dns_seedlist_discovery/two-results-default-port.yml +11 -0
  930. data/spec/spec_tests/data/dns_seedlist_discovery/two-results-nonstandard-port.yml +11 -0
  931. data/spec/spec_tests/data/dns_seedlist_discovery/two-txt-records.yml +5 -0
  932. data/spec/spec_tests/data/dns_seedlist_discovery/txt-record-not-allowed-option.yml +5 -0
  933. data/spec/spec_tests/data/dns_seedlist_discovery/txt-record-with-overridden-ssl-option.yml +11 -0
  934. data/spec/spec_tests/data/dns_seedlist_discovery/txt-record-with-overridden-uri-option.yml +11 -0
  935. data/spec/spec_tests/data/dns_seedlist_discovery/txt-record-with-unallowed-option.yml +5 -0
  936. data/spec/spec_tests/data/dns_seedlist_discovery/uri-with-port.yml +5 -0
  937. data/spec/spec_tests/data/dns_seedlist_discovery/uri-with-two-hosts.yml +5 -0
  938. data/spec/spec_tests/data/gridfs/delete.yml +123 -0
  939. data/spec/spec_tests/data/gridfs/download.yml +192 -0
  940. data/spec/spec_tests/data/max_staleness/ReplicaSetNoPrimary/NoKnownServers.yml +16 -0
  941. data/spec/spec_tests/data/max_staleness/Unknown/SmallMaxStaleness.yml +15 -0
  942. data/spec/spec_tests/data/read_write_concern/connection-string/read-concern.yml +32 -0
  943. data/spec/spec_tests/data/read_write_concern/connection-string/write-concern.yml +79 -0
  944. data/spec/spec_tests/data/read_write_concern/document/read-concern.yml +37 -0
  945. data/spec/spec_tests/data/read_write_concern/document/write-concern.yml +100 -0
  946. data/spec/spec_tests/data/read_write_concern/operation/default-write-concern-2.6.yml +215 -0
  947. data/spec/spec_tests/data/read_write_concern/operation/default-write-concern-3.2.yml +58 -0
  948. data/spec/spec_tests/data/read_write_concern/operation/default-write-concern-3.4.yml +95 -0
  949. data/spec/spec_tests/data/read_write_concern/operation/default-write-concern-4.2.yml +36 -0
  950. data/spec/spec_tests/data/retryable_reads/aggregate-merge.yml +39 -0
  951. data/spec/spec_tests/data/retryable_reads/aggregate-serverErrors.yml +157 -0
  952. data/spec/spec_tests/data/retryable_reads/aggregate.yml +87 -0
  953. data/spec/spec_tests/data/retryable_reads/changeStreams-client.watch-serverErrors.yml +149 -0
  954. data/spec/spec_tests/data/retryable_reads/changeStreams-client.watch.yml +61 -0
  955. data/spec/spec_tests/data/retryable_reads/changeStreams-db.coll.watch-serverErrors.yml +149 -0
  956. data/spec/spec_tests/data/retryable_reads/changeStreams-db.coll.watch.yml +65 -0
  957. data/spec/spec_tests/data/retryable_reads/changeStreams-db.watch-serverErrors.yml +153 -0
  958. data/spec/spec_tests/data/retryable_reads/changeStreams-db.watch.yml +61 -0
  959. data/spec/spec_tests/data/retryable_reads/count-serverErrors.yml +150 -0
  960. data/spec/spec_tests/data/retryable_reads/count.yml +64 -0
  961. data/spec/spec_tests/data/retryable_reads/countDocuments-serverErrors.yml +150 -0
  962. data/spec/spec_tests/data/retryable_reads/countDocuments.yml +64 -0
  963. data/spec/spec_tests/data/retryable_reads/distinct-serverErrors.yml +156 -0
  964. data/spec/spec_tests/data/retryable_reads/distinct.yml +71 -0
  965. data/spec/spec_tests/data/retryable_reads/estimatedDocumentCount-serverErrors.yml +148 -0
  966. data/spec/spec_tests/data/retryable_reads/estimatedDocumentCount.yml +62 -0
  967. data/spec/spec_tests/data/retryable_reads/find-serverErrors.yml +160 -0
  968. data/spec/spec_tests/data/retryable_reads/find.yml +86 -0
  969. data/spec/spec_tests/data/retryable_reads/findOne-serverErrors.yml +154 -0
  970. data/spec/spec_tests/data/retryable_reads/findOne.yml +68 -0
  971. data/spec/spec_tests/data/retryable_reads/gridfs-download-serverErrors.yml +173 -0
  972. data/spec/spec_tests/data/retryable_reads/gridfs-download.yml +79 -0
  973. data/spec/spec_tests/data/retryable_reads/gridfs-downloadByName-serverErrors.yml +174 -0
  974. data/spec/spec_tests/data/retryable_reads/gridfs-downloadByName.yml +79 -0
  975. data/spec/spec_tests/data/retryable_reads/listCollectionNames-serverErrors.yml +143 -0
  976. data/spec/spec_tests/data/retryable_reads/listCollectionNames.yml +59 -0
  977. data/spec/spec_tests/data/retryable_reads/listCollectionObjects-serverErrors.yml +144 -0
  978. data/spec/spec_tests/data/retryable_reads/listCollectionObjects.yml +59 -0
  979. data/spec/spec_tests/data/retryable_reads/listCollections-serverErrors.yml +143 -0
  980. data/spec/spec_tests/data/retryable_reads/listCollections.yml +59 -0
  981. data/spec/spec_tests/data/retryable_reads/listDatabaseNames-serverErrors.yml +143 -0
  982. data/spec/spec_tests/data/retryable_reads/listDatabaseNames.yml +59 -0
  983. data/spec/spec_tests/data/retryable_reads/listDatabaseObjects-serverErrors.yml +144 -0
  984. data/spec/spec_tests/data/retryable_reads/listDatabaseObjects.yml +59 -0
  985. data/spec/spec_tests/data/retryable_reads/listDatabases-serverErrors.yml +144 -0
  986. data/spec/spec_tests/data/retryable_reads/listDatabases.yml +59 -0
  987. data/spec/spec_tests/data/retryable_reads/listIndexNames-serverErrors.yml +144 -0
  988. data/spec/spec_tests/data/retryable_reads/listIndexNames.yml +60 -0
  989. data/spec/spec_tests/data/retryable_reads/listIndexes-serverErrors.yml +145 -0
  990. data/spec/spec_tests/data/retryable_reads/listIndexes.yml +60 -0
  991. data/spec/spec_tests/data/retryable_reads/mapReduce.yml +60 -0
  992. data/spec/spec_tests/data/retryable_writes/bulkWrite-errorLabels.yml +77 -0
  993. data/spec/spec_tests/data/retryable_writes/bulkWrite-serverErrors.yml +130 -0
  994. data/spec/spec_tests/data/retryable_writes/bulkWrite.yml +396 -0
  995. data/spec/spec_tests/data/retryable_writes/deleteMany.yml +22 -0
  996. data/spec/spec_tests/data/retryable_writes/deleteOne-errorLabels.yml +48 -0
  997. data/spec/spec_tests/data/retryable_writes/deleteOne-serverErrors.yml +73 -0
  998. data/spec/spec_tests/data/retryable_writes/deleteOne.yml +57 -0
  999. data/spec/spec_tests/data/retryable_writes/findOneAndDelete-errorLabels.yml +49 -0
  1000. data/spec/spec_tests/data/retryable_writes/findOneAndDelete-serverErrors.yml +74 -0
  1001. data/spec/spec_tests/data/retryable_writes/findOneAndDelete.yml +58 -0
  1002. data/spec/spec_tests/data/retryable_writes/findOneAndReplace-errorLabels.yml +52 -0
  1003. data/spec/spec_tests/data/retryable_writes/findOneAndReplace-serverErrors.yml +80 -0
  1004. data/spec/spec_tests/data/retryable_writes/findOneAndReplace.yml +63 -0
  1005. data/spec/spec_tests/data/retryable_writes/findOneAndUpdate-errorLabels.yml +52 -0
  1006. data/spec/spec_tests/data/retryable_writes/findOneAndUpdate-serverErrors.yml +79 -0
  1007. data/spec/spec_tests/data/retryable_writes/findOneAndUpdate.yml +62 -0
  1008. data/spec/spec_tests/data/retryable_writes/insertMany-errorLabels.yml +54 -0
  1009. data/spec/spec_tests/data/retryable_writes/insertMany-serverErrors.yml +84 -0
  1010. data/spec/spec_tests/data/retryable_writes/insertMany.yml +74 -0
  1011. data/spec/spec_tests/data/retryable_writes/insertOne-errorLabels.yml +44 -0
  1012. data/spec/spec_tests/data/retryable_writes/insertOne-serverErrors.yml +526 -0
  1013. data/spec/spec_tests/data/retryable_writes/insertOne.yml +61 -0
  1014. data/spec/spec_tests/data/retryable_writes/replaceOne-errorLabels.yml +53 -0
  1015. data/spec/spec_tests/data/retryable_writes/replaceOne-serverErrors.yml +82 -0
  1016. data/spec/spec_tests/data/retryable_writes/replaceOne.yml +66 -0
  1017. data/spec/spec_tests/data/retryable_writes/updateMany.yml +27 -0
  1018. data/spec/spec_tests/data/retryable_writes/updateOne-errorLabels.yml +53 -0
  1019. data/spec/spec_tests/data/retryable_writes/updateOne-serverErrors.yml +82 -0
  1020. data/spec/spec_tests/data/retryable_writes/updateOne.yml +129 -0
  1021. data/spec/spec_tests/data/sdam/errors/error_handling_handshake.yml +54 -0
  1022. data/spec/spec_tests/data/sdam/errors/non-stale-network-error.yml +46 -0
  1023. data/spec/spec_tests/data/sdam/errors/non-stale-network-timeout-error.yml +37 -0
  1024. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-greater-InterruptedAtShutdown.yml +60 -0
  1025. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-greater-InterruptedDueToReplStateChange.yml +60 -0
  1026. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-greater-NotMaster.yml +60 -0
  1027. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-greater-NotMasterNoSlaveOk.yml +60 -0
  1028. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-greater-NotMasterOrSecondary.yml +60 -0
  1029. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-greater-PrimarySteppedDown.yml +60 -0
  1030. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-greater-ShutdownInProgress.yml +60 -0
  1031. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-missing-InterruptedAtShutdown.yml +51 -0
  1032. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-missing-InterruptedDueToReplStateChange.yml +51 -0
  1033. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-missing-NotMaster.yml +51 -0
  1034. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-missing-NotMasterNoSlaveOk.yml +51 -0
  1035. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-missing-NotMasterOrSecondary.yml +51 -0
  1036. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-missing-PrimarySteppedDown.yml +51 -0
  1037. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-missing-ShutdownInProgress.yml +51 -0
  1038. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-proccessId-changed-InterruptedAtShutdown.yml +60 -0
  1039. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-proccessId-changed-InterruptedDueToReplStateChange.yml +60 -0
  1040. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-proccessId-changed-NotMaster.yml +60 -0
  1041. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-proccessId-changed-NotMasterNoSlaveOk.yml +60 -0
  1042. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-proccessId-changed-NotMasterOrSecondary.yml +60 -0
  1043. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-proccessId-changed-PrimarySteppedDown.yml +60 -0
  1044. data/spec/spec_tests/data/sdam/errors/non-stale-topologyVersion-proccessId-changed-ShutdownInProgress.yml +60 -0
  1045. data/spec/spec_tests/data/sdam/errors/post-42-InterruptedAtShutdown.yml +46 -0
  1046. data/spec/spec_tests/data/sdam/errors/post-42-InterruptedDueToReplStateChange.yml +46 -0
  1047. data/spec/spec_tests/data/sdam/errors/post-42-NotMaster.yml +46 -0
  1048. data/spec/spec_tests/data/sdam/errors/post-42-NotMasterNoSlaveOk.yml +46 -0
  1049. data/spec/spec_tests/data/sdam/errors/post-42-NotMasterOrSecondary.yml +46 -0
  1050. data/spec/spec_tests/data/sdam/errors/post-42-PrimarySteppedDown.yml +46 -0
  1051. data/spec/spec_tests/data/sdam/errors/post-42-ShutdownInProgress.yml +46 -0
  1052. data/spec/spec_tests/data/sdam/errors/pre-42-InterruptedAtShutdown.yml +46 -0
  1053. data/spec/spec_tests/data/sdam/errors/pre-42-InterruptedDueToReplStateChange.yml +46 -0
  1054. data/spec/spec_tests/data/sdam/errors/pre-42-NotMaster.yml +46 -0
  1055. data/spec/spec_tests/data/sdam/errors/pre-42-NotMasterNoSlaveOk.yml +46 -0
  1056. data/spec/spec_tests/data/sdam/errors/pre-42-NotMasterOrSecondary.yml +46 -0
  1057. data/spec/spec_tests/data/sdam/errors/pre-42-PrimarySteppedDown.yml +46 -0
  1058. data/spec/spec_tests/data/sdam/errors/pre-42-ShutdownInProgress.yml +46 -0
  1059. data/spec/spec_tests/data/sdam/errors/stale-generation-InterruptedAtShutdown.yml +89 -0
  1060. data/spec/spec_tests/data/sdam/errors/stale-generation-InterruptedDueToReplStateChange.yml +89 -0
  1061. data/spec/spec_tests/data/sdam/errors/stale-generation-NotMaster.yml +89 -0
  1062. data/spec/spec_tests/data/sdam/errors/stale-generation-NotMasterNoSlaveOk.yml +89 -0
  1063. data/spec/spec_tests/data/sdam/errors/stale-generation-NotMasterOrSecondary.yml +89 -0
  1064. data/spec/spec_tests/data/sdam/errors/stale-generation-PrimarySteppedDown.yml +89 -0
  1065. data/spec/spec_tests/data/sdam/errors/stale-generation-ShutdownInProgress.yml +89 -0
  1066. data/spec/spec_tests/data/sdam/errors/stale-generation-afterHandshakeCompletes-InterruptedAtShutdown.yml +89 -0
  1067. data/spec/spec_tests/data/sdam/errors/stale-generation-afterHandshakeCompletes-InterruptedDueToReplStateChange.yml +89 -0
  1068. data/spec/spec_tests/data/sdam/errors/stale-generation-afterHandshakeCompletes-NotMaster.yml +89 -0
  1069. data/spec/spec_tests/data/sdam/errors/stale-generation-afterHandshakeCompletes-NotMasterNoSlaveOk.yml +89 -0
  1070. data/spec/spec_tests/data/sdam/errors/stale-generation-afterHandshakeCompletes-NotMasterOrSecondary.yml +89 -0
  1071. data/spec/spec_tests/data/sdam/errors/stale-generation-afterHandshakeCompletes-PrimarySteppedDown.yml +89 -0
  1072. data/spec/spec_tests/data/sdam/errors/stale-generation-afterHandshakeCompletes-ShutdownInProgress.yml +89 -0
  1073. data/spec/spec_tests/data/sdam/errors/stale-generation-afterHandshakeCompletes-network.yml +80 -0
  1074. data/spec/spec_tests/data/sdam/errors/stale-generation-afterHandshakeCompletes-timeout.yml +80 -0
  1075. data/spec/spec_tests/data/sdam/errors/stale-generation-beforeHandshakeCompletes-InterruptedAtShutdown.yml +89 -0
  1076. data/spec/spec_tests/data/sdam/errors/stale-generation-beforeHandshakeCompletes-InterruptedDueToReplStateChange.yml +89 -0
  1077. data/spec/spec_tests/data/sdam/errors/stale-generation-beforeHandshakeCompletes-NotMaster.yml +89 -0
  1078. data/spec/spec_tests/data/sdam/errors/stale-generation-beforeHandshakeCompletes-NotMasterNoSlaveOk.yml +89 -0
  1079. data/spec/spec_tests/data/sdam/errors/stale-generation-beforeHandshakeCompletes-NotMasterOrSecondary.yml +89 -0
  1080. data/spec/spec_tests/data/sdam/errors/stale-generation-beforeHandshakeCompletes-PrimarySteppedDown.yml +89 -0
  1081. data/spec/spec_tests/data/sdam/errors/stale-generation-beforeHandshakeCompletes-ShutdownInProgress.yml +89 -0
  1082. data/spec/spec_tests/data/sdam/errors/stale-generation-beforeHandshakeCompletes-network.yml +80 -0
  1083. data/spec/spec_tests/data/sdam/errors/stale-generation-beforeHandshakeCompletes-timeout.yml +80 -0
  1084. data/spec/spec_tests/data/sdam/errors/stale-topologyVersion-InterruptedAtShutdown.yml +64 -0
  1085. data/spec/spec_tests/data/sdam/errors/stale-topologyVersion-InterruptedDueToReplStateChange.yml +64 -0
  1086. data/spec/spec_tests/data/sdam/errors/stale-topologyVersion-NotMaster.yml +64 -0
  1087. data/spec/spec_tests/data/sdam/errors/stale-topologyVersion-NotMasterNoSlaveOk.yml +64 -0
  1088. data/spec/spec_tests/data/sdam/errors/stale-topologyVersion-NotMasterOrSecondary.yml +64 -0
  1089. data/spec/spec_tests/data/sdam/errors/stale-topologyVersion-PrimarySteppedDown.yml +64 -0
  1090. data/spec/spec_tests/data/sdam/errors/stale-topologyVersion-ShutdownInProgress.yml +64 -0
  1091. data/spec/spec_tests/data/sdam/rs/compatible.yml +43 -0
  1092. data/spec/spec_tests/data/sdam/rs/compatible_unknown.yml +33 -0
  1093. data/spec/spec_tests/data/sdam/rs/discover_arbiters.yml +43 -0
  1094. data/spec/spec_tests/data/sdam/rs/discover_arbiters_replicaset.yml +43 -0
  1095. data/spec/spec_tests/data/sdam/rs/discover_ghost.yml +35 -0
  1096. data/spec/spec_tests/data/sdam/rs/discover_ghost_replicaset.yml +41 -0
  1097. data/spec/spec_tests/data/sdam/rs/discover_hidden.yml +50 -0
  1098. data/spec/spec_tests/data/sdam/rs/discover_hidden_replicaset.yml +50 -0
  1099. data/spec/spec_tests/data/sdam/rs/discover_passives.yml +81 -0
  1100. data/spec/spec_tests/data/sdam/rs/discover_passives_replicaset.yml +81 -0
  1101. data/spec/spec_tests/data/sdam/rs/discover_primary.yml +42 -0
  1102. data/spec/spec_tests/data/sdam/rs/discover_primary_replicaset.yml +42 -0
  1103. data/spec/spec_tests/data/sdam/rs/discover_rsother.yml +49 -0
  1104. data/spec/spec_tests/data/sdam/rs/discover_rsother_replicaset.yml +66 -0
  1105. data/spec/spec_tests/data/sdam/rs/discover_secondary.yml +43 -0
  1106. data/spec/spec_tests/data/sdam/rs/discover_secondary_replicaset.yml +43 -0
  1107. data/spec/spec_tests/data/sdam/rs/discovery.yml +203 -0
  1108. data/spec/spec_tests/data/sdam/rs/equal_electionids.yml +55 -0
  1109. data/spec/spec_tests/data/sdam/rs/hosts_differ_from_seeds.yml +36 -0
  1110. data/spec/spec_tests/data/sdam/rs/incompatible_arbiter.yml +34 -0
  1111. data/spec/spec_tests/data/sdam/rs/incompatible_ghost.yml +32 -0
  1112. data/spec/spec_tests/data/sdam/rs/incompatible_other.yml +34 -0
  1113. data/spec/spec_tests/data/sdam/rs/ls_timeout.yml +243 -0
  1114. data/spec/spec_tests/data/sdam/rs/member_reconfig.yml +72 -0
  1115. data/spec/spec_tests/data/sdam/rs/member_standalone.yml +64 -0
  1116. data/spec/spec_tests/data/sdam/rs/new_primary.yml +78 -0
  1117. data/spec/spec_tests/data/sdam/rs/new_primary_new_electionid.yml +116 -0
  1118. data/spec/spec_tests/data/sdam/rs/new_primary_new_setversion.yml +116 -0
  1119. data/spec/spec_tests/data/sdam/rs/new_primary_wrong_set_name.yml +75 -0
  1120. data/spec/spec_tests/data/sdam/rs/non_rs_member.yml +32 -0
  1121. data/spec/spec_tests/data/sdam/rs/normalize_case.yml +51 -0
  1122. data/spec/spec_tests/data/sdam/rs/normalize_case_me.yml +100 -0
  1123. data/spec/spec_tests/data/sdam/rs/null_election_id.yml +171 -0
  1124. data/spec/spec_tests/data/sdam/rs/primary_becomes_ghost.yml +63 -0
  1125. data/spec/spec_tests/data/sdam/rs/primary_becomes_mongos.yml +56 -0
  1126. data/spec/spec_tests/data/sdam/rs/primary_becomes_standalone.yml +54 -0
  1127. data/spec/spec_tests/data/sdam/rs/primary_changes_set_name.yml +61 -0
  1128. data/spec/spec_tests/data/sdam/rs/primary_disconnect.yml +58 -0
  1129. data/spec/spec_tests/data/sdam/rs/primary_disconnect_electionid.yml +184 -0
  1130. data/spec/spec_tests/data/sdam/rs/primary_disconnect_setversion.yml +184 -0
  1131. data/spec/spec_tests/data/sdam/rs/primary_hint_from_secondary_with_mismatched_me.yml +62 -0
  1132. data/spec/spec_tests/data/sdam/rs/primary_mismatched_me.yml +26 -0
  1133. data/spec/spec_tests/data/sdam/rs/primary_mismatched_me_not_removed.yml +73 -0
  1134. data/spec/spec_tests/data/sdam/rs/primary_reports_new_member.yml +171 -0
  1135. data/spec/spec_tests/data/sdam/rs/primary_to_no_primary_mismatched_me.yml +79 -0
  1136. data/spec/spec_tests/data/sdam/rs/primary_wrong_set_name.yml +29 -0
  1137. data/spec/spec_tests/data/sdam/rs/repeated.yml +101 -0
  1138. data/spec/spec_tests/data/sdam/rs/replicaset_rsnp.yml +20 -0
  1139. data/spec/spec_tests/data/sdam/rs/response_from_removed.yml +67 -0
  1140. data/spec/spec_tests/data/sdam/rs/ruby_primary_address_change.yml +31 -0
  1141. data/spec/spec_tests/data/sdam/rs/ruby_secondary_wrong_set_name_with_primary_second.yml +73 -0
  1142. data/spec/spec_tests/data/sdam/rs/sec_not_auth.yml +53 -0
  1143. data/spec/spec_tests/data/sdam/rs/secondary_ignore_ok_0.yml +85 -0
  1144. data/spec/spec_tests/data/sdam/rs/secondary_mismatched_me.yml +27 -0
  1145. data/spec/spec_tests/data/sdam/rs/secondary_wrong_set_name.yml +30 -0
  1146. data/spec/spec_tests/data/sdam/rs/secondary_wrong_set_name_with_primary.yml +73 -0
  1147. data/spec/spec_tests/data/sdam/rs/setversion_without_electionid.yml +77 -0
  1148. data/spec/spec_tests/data/sdam/rs/stepdown_change_set_name.yml +63 -0
  1149. data/spec/spec_tests/data/sdam/rs/too_new.yml +43 -0
  1150. data/spec/spec_tests/data/sdam/rs/too_old.yml +39 -0
  1151. data/spec/spec_tests/data/sdam/rs/topology_version_equal.yml +66 -0
  1152. data/spec/spec_tests/data/sdam/rs/topology_version_greater.yml +189 -0
  1153. data/spec/spec_tests/data/sdam/rs/topology_version_less.yml +62 -0
  1154. data/spec/spec_tests/data/sdam/rs/unexpected_mongos.yml +28 -0
  1155. data/spec/spec_tests/data/sdam/rs/use_setversion_without_electionid.yml +114 -0
  1156. data/spec/spec_tests/data/sdam/rs/wrong_set_name.yml +37 -0
  1157. data/spec/spec_tests/data/sdam/sharded/compatible.yml +38 -0
  1158. data/spec/spec_tests/data/sdam/sharded/discover_single_mongos.yml +23 -0
  1159. data/spec/spec_tests/data/sdam/sharded/ls_timeout_mongos.yml +97 -0
  1160. data/spec/spec_tests/data/sdam/sharded/mongos_disconnect.yml +110 -0
  1161. data/spec/spec_tests/data/sdam/sharded/multiple_mongoses.yml +50 -0
  1162. data/spec/spec_tests/data/sdam/sharded/non_mongos_removed.yml +45 -0
  1163. data/spec/spec_tests/data/sdam/sharded/normalize_uri_case.yml +32 -0
  1164. data/spec/spec_tests/data/sdam/sharded/ruby_primary_different_address.yml +21 -0
  1165. data/spec/spec_tests/data/sdam/sharded/ruby_primary_mismatched_me.yml +22 -0
  1166. data/spec/spec_tests/data/sdam/sharded/too_new.yml +36 -0
  1167. data/spec/spec_tests/data/sdam/sharded/too_old.yml +36 -0
  1168. data/spec/spec_tests/data/sdam/single/compatible.yml +26 -0
  1169. data/spec/spec_tests/data/sdam/single/direct_connection_external_ip.yml +36 -0
  1170. data/spec/spec_tests/data/sdam/single/direct_connection_mongos.yml +35 -0
  1171. data/spec/spec_tests/data/sdam/single/direct_connection_replicaset.yml +22 -0
  1172. data/spec/spec_tests/data/sdam/single/direct_connection_rsarbiter.yml +37 -0
  1173. data/spec/spec_tests/data/sdam/single/direct_connection_rsprimary.yml +36 -0
  1174. data/spec/spec_tests/data/sdam/single/direct_connection_rssecondary.yml +37 -0
  1175. data/spec/spec_tests/data/sdam/single/direct_connection_slave.yml +34 -0
  1176. data/spec/spec_tests/data/sdam/single/direct_connection_standalone.yml +34 -0
  1177. data/spec/spec_tests/data/sdam/single/direct_connection_unavailable_seed.yml +28 -0
  1178. data/spec/spec_tests/data/sdam/single/direct_connection_wrong_set_name.yml +38 -0
  1179. data/spec/spec_tests/data/sdam/single/discover_standalone.yml +34 -0
  1180. data/spec/spec_tests/data/sdam/single/discover_unavailable_seed.yml +28 -0
  1181. data/spec/spec_tests/data/sdam/single/ls_timeout_standalone.yml +35 -0
  1182. data/spec/spec_tests/data/sdam/single/not_ok_response.yml +42 -0
  1183. data/spec/spec_tests/data/sdam/single/ruby_primary_different_address.yml +24 -0
  1184. data/spec/spec_tests/data/sdam/single/ruby_primary_mismatched_me.yml +25 -0
  1185. data/spec/spec_tests/data/sdam/single/standalone_removed.yml +34 -0
  1186. data/spec/spec_tests/data/sdam/single/too_new.yml +26 -0
  1187. data/spec/spec_tests/data/sdam/single/too_old.yml +24 -0
  1188. data/spec/spec_tests/data/sdam/single/too_old_then_upgraded.yml +46 -0
  1189. data/spec/spec_tests/data/sdam_integration/cancel-server-check.yml +96 -0
  1190. data/spec/spec_tests/data/sdam_integration/connectTimeoutMS.yml +88 -0
  1191. data/spec/spec_tests/data/sdam_integration/find-network-error.yml +83 -0
  1192. data/spec/spec_tests/data/sdam_integration/find-shutdown-error.yml +116 -0
  1193. data/spec/spec_tests/data/sdam_integration/insert-network-error.yml +86 -0
  1194. data/spec/spec_tests/data/sdam_integration/insert-shutdown-error.yml +115 -0
  1195. data/spec/spec_tests/data/sdam_integration/isMaster-command-error.yml +168 -0
  1196. data/spec/spec_tests/data/sdam_integration/isMaster-network-error.yml +162 -0
  1197. data/spec/spec_tests/data/sdam_integration/isMaster-timeout.yml +229 -0
  1198. data/spec/spec_tests/data/sdam_integration/rediscover-quickly-after-step-down.yml +87 -0
  1199. data/spec/spec_tests/data/sdam_monitoring/discovered_standalone.yml +70 -0
  1200. data/spec/spec_tests/data/sdam_monitoring/replica_set_other_chain.yml +222 -0
  1201. data/spec/spec_tests/data/sdam_monitoring/replica_set_other_change.yml +225 -0
  1202. data/spec/spec_tests/data/sdam_monitoring/replica_set_primary_address_change.yml +251 -0
  1203. data/spec/spec_tests/data/sdam_monitoring/replica_set_with_me_mismatch.yml +111 -0
  1204. data/spec/spec_tests/data/sdam_monitoring/replica_set_with_primary_and_secondary.yml +198 -0
  1205. data/spec/spec_tests/data/sdam_monitoring/replica_set_with_primary_removal.yml +175 -0
  1206. data/spec/spec_tests/data/sdam_monitoring/replica_set_with_removal.yml +110 -0
  1207. data/spec/spec_tests/data/sdam_monitoring/replica_set_with_second_seed_removal.yml +106 -0
  1208. data/spec/spec_tests/data/sdam_monitoring/required_replica_set.yml +107 -0
  1209. data/spec/spec_tests/data/sdam_monitoring/standalone.yml +70 -0
  1210. data/spec/spec_tests/data/sdam_monitoring/standalone_repeated.yml +86 -0
  1211. data/spec/spec_tests/data/sdam_monitoring/standalone_suppress_equal_description_changes.yml +73 -0
  1212. data/spec/spec_tests/data/sdam_monitoring/standalone_to_rs_with_me_mismatch.yml +90 -0
  1213. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/Nearest.yml +25 -0
  1214. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/Nearest_multiple.yml +26 -0
  1215. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/Nearest_non_matching.yml +20 -0
  1216. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/PossiblePrimary.yml +15 -0
  1217. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/PossiblePrimaryNearest.yml +15 -0
  1218. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/Primary.yml +18 -0
  1219. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/PrimaryPreferred.yml +25 -0
  1220. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/PrimaryPreferred_non_matching.yml +20 -0
  1221. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/Secondary.yml +25 -0
  1222. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/SecondaryPreferred.yml +25 -0
  1223. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/SecondaryPreferred_non_matching.yml +20 -0
  1224. data/spec/spec_tests/data/server_selection/ReplicaSetNoPrimary/read/Secondary_non_matching.yml +20 -0
  1225. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/Nearest.yml +32 -0
  1226. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/Nearest_multiple.yml +33 -0
  1227. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/Nearest_non_matching.yml +25 -0
  1228. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/Primary.yml +26 -0
  1229. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/PrimaryPreferred.yml +28 -0
  1230. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/PrimaryPreferred_non_matching.yml +28 -0
  1231. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/Secondary.yml +30 -0
  1232. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/SecondaryPreferred.yml +30 -0
  1233. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/SecondaryPreferred_non_matching.yml +28 -0
  1234. data/spec/spec_tests/data/server_selection/ReplicaSetWithPrimary/read/Secondary_non_matching.yml +25 -0
  1235. data/spec/spec_tests/data/server_selection/Sharded/read/Nearest.yml +21 -0
  1236. data/spec/spec_tests/data/server_selection/Sharded/read/Primary.yml +19 -0
  1237. data/spec/spec_tests/data/server_selection/Sharded/read/PrimaryPreferred.yml +21 -0
  1238. data/spec/spec_tests/data/server_selection/Sharded/read/Secondary.yml +21 -0
  1239. data/spec/spec_tests/data/server_selection/Sharded/read/SecondaryPreferred.yml +21 -0
  1240. data/spec/spec_tests/data/server_selection/Single/read/SecondaryPreferred.yml +18 -0
  1241. data/spec/spec_tests/data/server_selection/Unknown/read/SecondaryPreferred.yml +10 -0
  1242. data/spec/spec_tests/data/transactions/abort.yml +413 -0
  1243. data/spec/spec_tests/data/transactions/bulk.yml +267 -0
  1244. data/spec/spec_tests/data/transactions/causal-consistency.yml +175 -0
  1245. data/spec/spec_tests/data/transactions/commit.yml +603 -0
  1246. data/spec/spec_tests/data/transactions/count.yml +67 -0
  1247. data/spec/spec_tests/data/transactions/create-collection.yml +131 -0
  1248. data/spec/spec_tests/data/transactions/create-index.yml +152 -0
  1249. data/spec/spec_tests/data/transactions/delete.yml +192 -0
  1250. data/spec/spec_tests/data/transactions/error-labels.yml +1027 -0
  1251. data/spec/spec_tests/data/transactions/errors-client.yml +56 -0
  1252. data/spec/spec_tests/data/transactions/errors.yml +133 -0
  1253. data/spec/spec_tests/data/transactions/findOneAndDelete.yml +134 -0
  1254. data/spec/spec_tests/data/transactions/findOneAndReplace.yml +148 -0
  1255. data/spec/spec_tests/data/transactions/findOneAndUpdate.yml +236 -0
  1256. data/spec/spec_tests/data/transactions/insert.yml +390 -0
  1257. data/spec/spec_tests/data/transactions/isolation.yml +133 -0
  1258. data/spec/spec_tests/data/transactions/mongos-pin-auto.yml +1671 -0
  1259. data/spec/spec_tests/data/transactions/mongos-recovery-token.yml +348 -0
  1260. data/spec/spec_tests/data/transactions/pin-mongos.yml +556 -0
  1261. data/spec/spec_tests/data/transactions/read-concern.yml +623 -0
  1262. data/spec/spec_tests/data/transactions/read-pref.yml +348 -0
  1263. data/spec/spec_tests/data/transactions/reads.yml +261 -0
  1264. data/spec/spec_tests/data/transactions/retryable-abort-errorLabels.yml +124 -0
  1265. data/spec/spec_tests/data/transactions/retryable-abort.yml +1315 -0
  1266. data/spec/spec_tests/data/transactions/retryable-commit-errorLabels.yml +132 -0
  1267. data/spec/spec_tests/data/transactions/retryable-commit.yml +1460 -0
  1268. data/spec/spec_tests/data/transactions/retryable-writes.yml +216 -0
  1269. data/spec/spec_tests/data/transactions/run-command.yml +197 -0
  1270. data/spec/spec_tests/data/transactions/transaction-options-repl.yml +117 -0
  1271. data/spec/spec_tests/data/transactions/transaction-options.yml +781 -0
  1272. data/spec/spec_tests/data/transactions/update.yml +246 -0
  1273. data/spec/spec_tests/data/transactions/write-concern.yml +554 -0
  1274. data/spec/spec_tests/data/transactions_api/callback-aborts.yml +170 -0
  1275. data/spec/spec_tests/data/transactions_api/callback-commits.yml +204 -0
  1276. data/spec/spec_tests/data/transactions_api/callback-retry.yml +215 -0
  1277. data/spec/spec_tests/data/transactions_api/commit-retry.yml +324 -0
  1278. data/spec/spec_tests/data/transactions_api/commit-transienttransactionerror-4.2.yml +139 -0
  1279. data/spec/spec_tests/data/transactions_api/commit-transienttransactionerror.yml +175 -0
  1280. data/spec/spec_tests/data/transactions_api/commit-writeconcernerror.yml +216 -0
  1281. data/spec/spec_tests/data/transactions_api/commit.yml +193 -0
  1282. data/spec/spec_tests/data/transactions_api/transaction-options.yml +274 -0
  1283. data/spec/spec_tests/data/uri_options/auth-options.yml +49 -0
  1284. data/spec/spec_tests/data/uri_options/compression-options.yml +51 -0
  1285. data/spec/spec_tests/data/uri_options/concern-options.yml +55 -0
  1286. data/spec/spec_tests/data/uri_options/connection-options.yml +149 -0
  1287. data/spec/spec_tests/data/uri_options/connection-pool-options.yml +26 -0
  1288. data/spec/spec_tests/data/uri_options/read-preference-options.yml +66 -0
  1289. data/spec/spec_tests/data/uri_options/ruby-auth-options.yml +12 -0
  1290. data/spec/spec_tests/data/uri_options/ruby-connection-options.yml +58 -0
  1291. data/spec/spec_tests/data/uri_options/tls-options.yml +364 -0
  1292. data/spec/spec_tests/dns_seedlist_discovery_spec.rb +76 -0
  1293. data/spec/spec_tests/gridfs_spec.rb +52 -0
  1294. data/spec/spec_tests/max_staleness_spec.rb +9 -0
  1295. data/spec/spec_tests/read_write_concern_connection_string_spec.rb +10 -0
  1296. data/spec/spec_tests/read_write_concern_document_spec.rb +74 -0
  1297. data/spec/spec_tests/read_write_concern_operaton_spec.rb +10 -0
  1298. data/spec/spec_tests/retryable_reads_spec.rb +47 -0
  1299. data/spec/spec_tests/retryable_writes_spec.rb +19 -0
  1300. data/spec/spec_tests/sdam_integration_spec.rb +13 -0
  1301. data/spec/spec_tests/sdam_monitoring_spec.rb +93 -0
  1302. data/spec/spec_tests/sdam_spec.rb +239 -0
  1303. data/spec/spec_tests/server_selection_rtt_spec.rb +30 -0
  1304. data/spec/spec_tests/server_selection_spec.rb +9 -0
  1305. data/spec/spec_tests/transactions_api_spec.rb +10 -0
  1306. data/spec/spec_tests/transactions_spec.rb +10 -0
  1307. data/spec/spec_tests/uri_options_spec.rb +74 -0
  1308. data/spec/stress/cleanup_spec.rb +58 -0
  1309. data/spec/stress/connection_pool_stress_spec.rb +201 -0
  1310. data/spec/stress/connection_pool_timing_spec.rb +181 -0
  1311. data/spec/stress/fork_reconnect_stress_spec.rb +109 -0
  1312. data/spec/support/authorization.rb +51 -153
  1313. data/spec/support/aws_utils/base.rb +134 -0
  1314. data/spec/support/aws_utils/inspector.rb +224 -0
  1315. data/spec/support/aws_utils/orchestrator.rb +370 -0
  1316. data/spec/support/aws_utils/provisioner.rb +360 -0
  1317. data/spec/support/aws_utils.rb +62 -0
  1318. data/spec/support/background_thread_registry.rb +67 -0
  1319. data/spec/support/certificates/README.md +105 -0
  1320. data/spec/support/certificates/atlas-ocsp-ca.crt +28 -0
  1321. data/spec/support/certificates/atlas-ocsp.crt +41 -0
  1322. data/spec/support/certificates/ca.crt +76 -0
  1323. data/spec/support/certificates/client-encrypted.key +30 -0
  1324. data/spec/support/certificates/client-int.crt +78 -0
  1325. data/spec/support/certificates/client-second-level-bundle.pem +179 -0
  1326. data/spec/support/certificates/client-second-level.crt +74 -0
  1327. data/spec/support/certificates/client-second-level.key +27 -0
  1328. data/spec/support/certificates/client-second-level.pem +101 -0
  1329. data/spec/support/certificates/client-x509.crt +78 -0
  1330. data/spec/support/certificates/client-x509.key +27 -0
  1331. data/spec/support/certificates/client-x509.pem +105 -0
  1332. data/spec/support/certificates/client.crt +74 -0
  1333. data/spec/support/certificates/client.key +27 -0
  1334. data/spec/support/certificates/client.pem +90 -90
  1335. data/spec/support/certificates/crl.pem +10 -8
  1336. data/spec/support/certificates/crl_client_revoked.pem +11 -10
  1337. data/spec/support/certificates/multi-ca.crt +152 -0
  1338. data/spec/support/certificates/python-ca.crt +76 -0
  1339. data/spec/support/certificates/server-int.crt +78 -0
  1340. data/spec/support/certificates/server-second-level-bundle.pem +179 -0
  1341. data/spec/support/certificates/server-second-level.crt +74 -0
  1342. data/spec/support/certificates/server-second-level.key +27 -0
  1343. data/spec/support/certificates/server-second-level.pem +101 -0
  1344. data/spec/support/certificates/server.pem +99 -32
  1345. data/spec/support/client_registry.rb +247 -0
  1346. data/spec/support/client_registry_macros.rb +23 -0
  1347. data/spec/support/cluster_config.rb +207 -0
  1348. data/spec/support/cluster_tools.rb +376 -0
  1349. data/spec/support/common_shortcuts.rb +342 -0
  1350. data/spec/support/constraints.rb +16 -0
  1351. data/spec/support/crypt/corpus/corpus-key-aws.json +33 -0
  1352. data/spec/support/crypt/corpus/corpus-key-local.json +31 -0
  1353. data/spec/support/crypt/corpus/corpus-schema.json +2057 -0
  1354. data/spec/support/crypt/corpus/corpus.json +3657 -0
  1355. data/spec/support/crypt/corpus/corpus_encrypted.json +4152 -0
  1356. data/spec/support/crypt/data_keys/key_document_aws.json +34 -0
  1357. data/spec/support/crypt/data_keys/key_document_local.json +31 -0
  1358. data/spec/support/crypt/external/external-key.json +31 -0
  1359. data/spec/support/crypt/external/external-schema.json +19 -0
  1360. data/spec/support/crypt/limits/limits-doc.json +102 -0
  1361. data/spec/support/crypt/limits/limits-key.json +31 -0
  1362. data/spec/support/crypt/limits/limits-schema.json +1405 -0
  1363. data/spec/support/crypt/schema_maps/schema_map_aws.json +17 -0
  1364. data/spec/support/crypt/schema_maps/schema_map_aws_key_alt_names.json +12 -0
  1365. data/spec/support/crypt/schema_maps/schema_map_local.json +18 -0
  1366. data/spec/support/crypt/schema_maps/schema_map_local_key_alt_names.json +12 -0
  1367. data/spec/support/crypt.rb +154 -0
  1368. data/spec/support/dns.rb +13 -0
  1369. data/spec/support/event_subscriber.rb +212 -0
  1370. data/spec/support/json_ext_formatter.rb +13 -0
  1371. data/spec/support/keyword_struct.rb +26 -0
  1372. data/spec/support/local_resource_registry.rb +34 -0
  1373. data/spec/support/matchers.rb +35 -0
  1374. data/spec/support/monitoring_ext.rb +16 -0
  1375. data/spec/support/ocsp +1 -0
  1376. data/spec/support/primary_socket.rb +21 -0
  1377. data/spec/support/sdam_formatter_integration.rb +116 -0
  1378. data/spec/support/session_registry.rb +52 -0
  1379. data/spec/support/shared/protocol.rb +2 -0
  1380. data/spec/support/shared/scram_conversation.rb +100 -0
  1381. data/spec/support/shared/server_selector.rb +109 -63
  1382. data/spec/support/shared/session.rb +907 -0
  1383. data/spec/support/spec_config.rb +560 -0
  1384. data/spec/support/spec_setup.rb +70 -0
  1385. data/spec/support/utils.rb +534 -0
  1386. data.tar.gz.sig +0 -0
  1387. metadata +2229 -653
  1388. metadata.gz.sig +0 -0
  1389. data/lib/csasl/csasl.bundle +0 -0
  1390. data/lib/mongo/cluster/app_metadata.rb +0 -146
  1391. data/lib/mongo/cluster/cursor_reaper.rb +0 -174
  1392. data/lib/mongo/cluster/topology/replica_set.rb +0 -317
  1393. data/lib/mongo/event/description_changed.rb +0 -72
  1394. data/lib/mongo/event/member_discovered.rb +0 -65
  1395. data/lib/mongo/event/primary_elected.rb +0 -55
  1396. data/lib/mongo/event/standalone_discovered.rb +0 -53
  1397. data/lib/mongo/operation/commands/aggregate/result.rb +0 -89
  1398. data/lib/mongo/operation/commands/aggregate.rb +0 -64
  1399. data/lib/mongo/operation/commands/collections_info/result.rb +0 -41
  1400. data/lib/mongo/operation/commands/collections_info.rb +0 -71
  1401. data/lib/mongo/operation/commands/command.rb +0 -47
  1402. data/lib/mongo/operation/commands/create.rb +0 -45
  1403. data/lib/mongo/operation/commands/drop.rb +0 -45
  1404. data/lib/mongo/operation/commands/drop_database.rb +0 -45
  1405. data/lib/mongo/operation/commands/find/result.rb +0 -62
  1406. data/lib/mongo/operation/commands/find.rb +0 -27
  1407. data/lib/mongo/operation/commands/get_more/result.rb +0 -62
  1408. data/lib/mongo/operation/commands/get_more.rb +0 -27
  1409. data/lib/mongo/operation/commands/indexes.rb +0 -73
  1410. data/lib/mongo/operation/commands/list_collections/result.rb +0 -94
  1411. data/lib/mongo/operation/commands/list_collections.rb +0 -48
  1412. data/lib/mongo/operation/commands/list_indexes/result.rb +0 -98
  1413. data/lib/mongo/operation/commands/list_indexes.rb +0 -48
  1414. data/lib/mongo/operation/commands/map_reduce/result.rb +0 -119
  1415. data/lib/mongo/operation/commands/map_reduce.rb +0 -60
  1416. data/lib/mongo/operation/commands/parallel_scan/result.rb +0 -64
  1417. data/lib/mongo/operation/commands/parallel_scan.rb +0 -53
  1418. data/lib/mongo/operation/commands/user_query.rb +0 -72
  1419. data/lib/mongo/operation/commands/users_info/result.rb +0 -44
  1420. data/lib/mongo/operation/commands/users_info.rb +0 -48
  1421. data/lib/mongo/operation/commands.rb +0 -29
  1422. data/lib/mongo/operation/executable.rb +0 -42
  1423. data/lib/mongo/operation/limited.rb +0 -37
  1424. data/lib/mongo/operation/object_id_generator.rb +0 -36
  1425. data/lib/mongo/operation/read/get_more.rb +0 -52
  1426. data/lib/mongo/operation/read/query/result.rb +0 -40
  1427. data/lib/mongo/operation/read/query.rb +0 -55
  1428. data/lib/mongo/operation/read.rb +0 -16
  1429. data/lib/mongo/operation/read_preference.rb +0 -61
  1430. data/lib/mongo/operation/specifiable.rb +0 -507
  1431. data/lib/mongo/operation/takes_write_concern.rb +0 -35
  1432. data/lib/mongo/operation/write/bulk/bulkable.rb +0 -83
  1433. data/lib/mongo/operation/write/bulk/delete/result.rb +0 -71
  1434. data/lib/mongo/operation/write/bulk/delete.rb +0 -71
  1435. data/lib/mongo/operation/write/bulk/insert/result.rb +0 -129
  1436. data/lib/mongo/operation/write/bulk/insert.rb +0 -96
  1437. data/lib/mongo/operation/write/bulk/legacy_mergable.rb +0 -87
  1438. data/lib/mongo/operation/write/bulk/mergable.rb +0 -71
  1439. data/lib/mongo/operation/write/bulk/update/result.rb +0 -205
  1440. data/lib/mongo/operation/write/bulk/update.rb +0 -81
  1441. data/lib/mongo/operation/write/bulk.rb +0 -20
  1442. data/lib/mongo/operation/write/command/create_index.rb +0 -55
  1443. data/lib/mongo/operation/write/command/create_user.rb +0 -42
  1444. data/lib/mongo/operation/write/command/delete.rb +0 -56
  1445. data/lib/mongo/operation/write/command/drop_index.rb +0 -56
  1446. data/lib/mongo/operation/write/command/insert.rb +0 -66
  1447. data/lib/mongo/operation/write/command/remove_user.rb +0 -41
  1448. data/lib/mongo/operation/write/command/update.rb +0 -63
  1449. data/lib/mongo/operation/write/command/update_user.rb +0 -42
  1450. data/lib/mongo/operation/write/command/writable.rb +0 -57
  1451. data/lib/mongo/operation/write/command.rb +0 -23
  1452. data/lib/mongo/operation/write/create_index.rb +0 -67
  1453. data/lib/mongo/operation/write/create_user.rb +0 -50
  1454. data/lib/mongo/operation/write/delete/result.rb +0 -40
  1455. data/lib/mongo/operation/write/delete.rb +0 -75
  1456. data/lib/mongo/operation/write/drop_index.rb +0 -63
  1457. data/lib/mongo/operation/write/gle.rb +0 -49
  1458. data/lib/mongo/operation/write/idable.rb +0 -63
  1459. data/lib/mongo/operation/write/insert/result.rb +0 -62
  1460. data/lib/mongo/operation/write/insert.rb +0 -71
  1461. data/lib/mongo/operation/write/remove_user.rb +0 -48
  1462. data/lib/mongo/operation/write/update/result.rb +0 -160
  1463. data/lib/mongo/operation/write/update.rb +0 -85
  1464. data/lib/mongo/operation/write/update_user.rb +0 -50
  1465. data/lib/mongo/operation/write/write_command_enabled.rb +0 -62
  1466. data/lib/mongo/operation/write.rb +0 -27
  1467. data/lib/mongo/server/connectable.rb +0 -119
  1468. data/lib/mongo/server/connection_pool/queue.rb +0 -197
  1469. data/lib/mongo/server/description/inspector/description_changed.rb +0 -57
  1470. data/lib/mongo/server/description/inspector/member_discovered.rb +0 -59
  1471. data/lib/mongo/server/description/inspector/primary_elected.rb +0 -60
  1472. data/lib/mongo/server/description/inspector/standalone_discovered.rb +0 -56
  1473. data/lib/mongo/server/description/inspector.rb +0 -81
  1474. data/lib/mongo/server_selector/selectable.rb +0 -281
  1475. data/lib/mongo/write_concern/normalizable.rb +0 -52
  1476. data/spec/mongo/cluster/app_metadata_spec.rb +0 -104
  1477. data/spec/mongo/command_monitoring_spec.rb +0 -64
  1478. data/spec/mongo/connection_string_spec.rb +0 -115
  1479. data/spec/mongo/crud_spec.rb +0 -41
  1480. data/spec/mongo/gridfs_spec.rb +0 -50
  1481. data/spec/mongo/max_staleness_spec.rb +0 -126
  1482. data/spec/mongo/operation/commands/aggregate/result_spec.rb +0 -80
  1483. data/spec/mongo/operation/commands/aggregate_spec.rb +0 -72
  1484. data/spec/mongo/operation/commands/collections_info_spec.rb +0 -40
  1485. data/spec/mongo/operation/commands/command_spec.rb +0 -80
  1486. data/spec/mongo/operation/commands/indexes_spec.rb +0 -31
  1487. data/spec/mongo/operation/commands/map_reduce_spec.rb +0 -125
  1488. data/spec/mongo/operation/read/get_more_spec.rb +0 -53
  1489. data/spec/mongo/operation/read/query_spec.rb +0 -102
  1490. data/spec/mongo/operation/read_preference_spec.rb +0 -245
  1491. data/spec/mongo/operation/write/bulk/delete_spec.rb +0 -223
  1492. data/spec/mongo/operation/write/bulk/insert_spec.rb +0 -250
  1493. data/spec/mongo/operation/write/bulk/update_spec.rb +0 -220
  1494. data/spec/mongo/operation/write/command/delete_spec.rb +0 -106
  1495. data/spec/mongo/operation/write/command/insert_spec.rb +0 -105
  1496. data/spec/mongo/operation/write/command/update_spec.rb +0 -110
  1497. data/spec/mongo/operation/write/create_index_spec.rb +0 -63
  1498. data/spec/mongo/operation/write/create_user_spec.rb +0 -44
  1499. data/spec/mongo/operation/write/delete_spec.rb +0 -215
  1500. data/spec/mongo/operation/write/drop_index_spec.rb +0 -51
  1501. data/spec/mongo/operation/write/insert_spec.rb +0 -291
  1502. data/spec/mongo/operation/write/remove_user_spec.rb +0 -46
  1503. data/spec/mongo/operation/write/update_spec.rb +0 -256
  1504. data/spec/mongo/operation/write/update_user_spec.rb +0 -46
  1505. data/spec/mongo/sdam_monitoring_spec.rb +0 -60
  1506. data/spec/mongo/sdam_spec.rb +0 -84
  1507. data/spec/mongo/server/connection_pool/queue_spec.rb +0 -190
  1508. data/spec/mongo/server/description/inspector/description_changed_spec.rb +0 -78
  1509. data/spec/mongo/server/description/inspector/primary_elected_spec.rb +0 -94
  1510. data/spec/mongo/server_selection_rtt_spec.rb +0 -85
  1511. data/spec/mongo/server_selection_spec.rb +0 -93
  1512. data/spec/support/certificates/ca.pem +0 -17
  1513. data/spec/support/certificates/client_cert.pem +0 -21
  1514. data/spec/support/certificates/client_key.pem +0 -28
  1515. data/spec/support/certificates/client_key_encrypted.pem +0 -30
  1516. data/spec/support/certificates/password_protected.pem +0 -51
  1517. data/spec/support/command_monitoring/bulkWrite.yml +0 -73
  1518. data/spec/support/command_monitoring/command.yml +0 -42
  1519. data/spec/support/command_monitoring/find.yml +0 -268
  1520. data/spec/support/command_monitoring/insertMany.yml +0 -81
  1521. data/spec/support/command_monitoring/updateMany.yml +0 -67
  1522. data/spec/support/command_monitoring/updateOne.yml +0 -95
  1523. data/spec/support/command_monitoring.rb +0 -376
  1524. data/spec/support/connection_string.rb +0 -228
  1525. data/spec/support/connection_string_tests/invalid-uris.yml +0 -193
  1526. data/spec/support/connection_string_tests/valid-auth.yml +0 -256
  1527. data/spec/support/connection_string_tests/valid-options.yml +0 -30
  1528. data/spec/support/connection_string_tests/valid-unix_socket-absolute.yml +0 -197
  1529. data/spec/support/connection_string_tests/valid-unix_socket-relative.yml +0 -213
  1530. data/spec/support/connection_string_tests/valid-warnings.yml +0 -55
  1531. data/spec/support/crud/read.rb +0 -154
  1532. data/spec/support/crud/write.rb +0 -224
  1533. data/spec/support/crud.rb +0 -271
  1534. data/spec/support/crud_tests/read/aggregate-out.yml +0 -28
  1535. data/spec/support/crud_tests/read/count-collation.yml +0 -15
  1536. data/spec/support/crud_tests/read/count.yml +0 -36
  1537. data/spec/support/crud_tests/write/findOneAndReplace-upsert.yml +0 -47
  1538. data/spec/support/crud_tests/write/findOneAndReplace.yml +0 -142
  1539. data/spec/support/crud_tests/write/findOneAndUpdate.yml +0 -160
  1540. data/spec/support/crud_tests/write/insertMany.yml +0 -23
  1541. data/spec/support/crud_tests/write/replaceOne-collation.yml +0 -23
  1542. data/spec/support/crud_tests/write/replaceOne.yml +0 -86
  1543. data/spec/support/crud_tests/write/updateMany-collation.yml +0 -27
  1544. data/spec/support/crud_tests/write/updateMany.yml +0 -82
  1545. data/spec/support/crud_tests/write/updateOne-collation.yml +0 -24
  1546. data/spec/support/crud_tests/write/updateOne.yml +0 -79
  1547. data/spec/support/gridfs.rb +0 -637
  1548. data/spec/support/gridfs_tests/delete.yml +0 -157
  1549. data/spec/support/gridfs_tests/download.yml +0 -210
  1550. data/spec/support/helpers.rb +0 -140
  1551. data/spec/support/max_staleness/Unknown/SmallMaxStaleness.yml +0 -14
  1552. data/spec/support/sdam/rs/discover_arbiters.yml +0 -41
  1553. data/spec/support/sdam/rs/discover_passives.yml +0 -77
  1554. data/spec/support/sdam/rs/discover_primary.yml +0 -40
  1555. data/spec/support/sdam/rs/discover_secondary.yml +0 -41
  1556. data/spec/support/sdam/rs/discovery.yml +0 -195
  1557. data/spec/support/sdam/rs/equal_electionids.yml +0 -48
  1558. data/spec/support/sdam/rs/ghost_discovered.yml +0 -39
  1559. data/spec/support/sdam/rs/hosts_differ_from_seeds.yml +0 -34
  1560. data/spec/support/sdam/rs/member_reconfig.yml +0 -68
  1561. data/spec/support/sdam/rs/member_standalone.yml +0 -60
  1562. data/spec/support/sdam/rs/new_primary.yml +0 -74
  1563. data/spec/support/sdam/rs/new_primary_new_electionid.yml +0 -101
  1564. data/spec/support/sdam/rs/new_primary_new_setversion.yml +0 -101
  1565. data/spec/support/sdam/rs/new_primary_wrong_set_name.yml +0 -71
  1566. data/spec/support/sdam/rs/non_rs_member.yml +0 -31
  1567. data/spec/support/sdam/rs/normalize_case.yml +0 -49
  1568. data/spec/support/sdam/rs/null_election_id.yml +0 -152
  1569. data/spec/support/sdam/rs/primary_becomes_standalone.yml +0 -52
  1570. data/spec/support/sdam/rs/primary_changes_set_name.yml +0 -57
  1571. data/spec/support/sdam/rs/primary_disconnect.yml +0 -56
  1572. data/spec/support/sdam/rs/primary_disconnect_electionid.yml +0 -159
  1573. data/spec/support/sdam/rs/primary_disconnect_setversion.yml +0 -159
  1574. data/spec/support/sdam/rs/primary_mismatched_me.yml +0 -37
  1575. data/spec/support/sdam/rs/primary_reports_new_member.yml +0 -163
  1576. data/spec/support/sdam/rs/primary_to_no_primary_mismatched_me.yml +0 -75
  1577. data/spec/support/sdam/rs/primary_wrong_set_name.yml +0 -27
  1578. data/spec/support/sdam/rs/response_from_removed.yml +0 -63
  1579. data/spec/support/sdam/rs/rsother_discovered.yml +0 -62
  1580. data/spec/support/sdam/rs/sec_not_auth.yml +0 -49
  1581. data/spec/support/sdam/rs/secondary_mismatched_me.yml +0 -37
  1582. data/spec/support/sdam/rs/secondary_wrong_set_name.yml +0 -28
  1583. data/spec/support/sdam/rs/secondary_wrong_set_name_with_primary.yml +0 -69
  1584. data/spec/support/sdam/rs/set_version_without_electionid.yml +0 -69
  1585. data/spec/support/sdam/rs/setversion_without_electionid.yml +0 -69
  1586. data/spec/support/sdam/rs/stepdown_change_set_name.yml +0 -59
  1587. data/spec/support/sdam/rs/unexpected_mongos.yml +0 -26
  1588. data/spec/support/sdam/rs/use_setversion_without_electionid.yml +0 -99
  1589. data/spec/support/sdam/rs/wrong_set_name.yml +0 -35
  1590. data/spec/support/sdam/sharded/mongos_disconnect.yml +0 -104
  1591. data/spec/support/sdam/sharded/multiple_mongoses.yml +0 -46
  1592. data/spec/support/sdam/sharded/non_mongos_removed.yml +0 -41
  1593. data/spec/support/sdam/sharded/normalize_uri_case.yml +0 -32
  1594. data/spec/support/sdam/sharded/single_mongos.yml +0 -33
  1595. data/spec/support/sdam/single/direct_connection_external_ip.yml +0 -34
  1596. data/spec/support/sdam/single/direct_connection_mongos.yml +0 -33
  1597. data/spec/support/sdam/single/direct_connection_rsarbiter.yml +0 -35
  1598. data/spec/support/sdam/single/direct_connection_rsprimary.yml +0 -34
  1599. data/spec/support/sdam/single/direct_connection_rssecondary.yml +0 -35
  1600. data/spec/support/sdam/single/direct_connection_slave.yml +0 -32
  1601. data/spec/support/sdam/single/direct_connection_standalone.yml +0 -32
  1602. data/spec/support/sdam/single/not_ok_response.yml +0 -38
  1603. data/spec/support/sdam/single/standalone_removed.yml +0 -32
  1604. data/spec/support/sdam/single/unavailable_seed.yml +0 -28
  1605. data/spec/support/sdam_monitoring/replica_set_with_removal.yml +0 -106
  1606. data/spec/support/sdam_monitoring/required_replica_set.yml +0 -84
  1607. data/spec/support/sdam_monitoring/standalone.yml +0 -70
  1608. data/spec/support/sdam_monitoring.rb +0 -144
  1609. data/spec/support/server_discovery_and_monitoring.rb +0 -219
  1610. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Nearest.yml +0 -26
  1611. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Nearest_multiple.yml +0 -27
  1612. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Nearest_non_matching.yml +0 -21
  1613. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Primary.yml +0 -21
  1614. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/PrimaryPreferred.yml +0 -26
  1615. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/PrimaryPreferred_non_matching.yml +0 -21
  1616. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Secondary.yml +0 -26
  1617. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/SecondaryPreferred.yml +0 -26
  1618. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/SecondaryPreferred_non_matching.yml +0 -21
  1619. data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Secondary_non_matching.yml +0 -21
  1620. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Nearest.yml +0 -33
  1621. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Nearest_multiple.yml +0 -34
  1622. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Nearest_non_matching.yml +0 -26
  1623. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Primary.yml +0 -29
  1624. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/PrimaryPreferred.yml +0 -29
  1625. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/PrimaryPreferred_non_matching.yml +0 -29
  1626. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Secondary.yml +0 -31
  1627. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/SecondaryPreferred.yml +0 -31
  1628. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/SecondaryPreferred_non_matching.yml +0 -29
  1629. data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Secondary_non_matching.yml +0 -26
  1630. data/spec/support/server_selection/selection/Sharded/read/SecondaryPreferred.yml +0 -26
  1631. data/spec/support/server_selection/selection/Single/read/SecondaryPreferred.yml +0 -19
  1632. data/spec/support/server_selection/selection/Unknown/read/SecondaryPreferred.yml +0 -11
  1633. data/spec/support/server_selection.rb +0 -163
  1634. data/spec/support/server_selection_rtt.rb +0 -41
  1635. data/spec/support/travis.rb +0 -14
  1636. /data/spec/{support → spec_tests/data}/command_monitoring/deleteMany.yml +0 -0
  1637. /data/spec/{support → spec_tests/data}/command_monitoring/deleteOne.yml +0 -0
  1638. /data/spec/{support → spec_tests/data}/command_monitoring/insertOne.yml +0 -0
  1639. /data/spec/{support/connection_string_tests → spec_tests/data/connection_string}/valid-host_identifiers.yml +0 -0
  1640. /data/spec/{support/crud_tests → spec_tests/data/crud}/read/aggregate-collation.yml +0 -0
  1641. /data/spec/{support/crud_tests → spec_tests/data/crud}/read/aggregate.yml +0 -0
  1642. /data/spec/{support/crud_tests → spec_tests/data/crud}/read/distinct-collation.yml +0 -0
  1643. /data/spec/{support/crud_tests → spec_tests/data/crud}/read/distinct.yml +0 -0
  1644. /data/spec/{support/crud_tests → spec_tests/data/crud}/read/find-collation.yml +0 -0
  1645. /data/spec/{support/crud_tests → spec_tests/data/crud}/read/find.yml +0 -0
  1646. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/deleteMany-collation.yml +0 -0
  1647. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/deleteMany.yml +0 -0
  1648. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/deleteOne-collation.yml +0 -0
  1649. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/deleteOne.yml +0 -0
  1650. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/findOneAndDelete-collation.yml +0 -0
  1651. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/findOneAndDelete.yml +0 -0
  1652. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/findOneAndReplace-collation.yml +0 -0
  1653. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/findOneAndUpdate-collation.yml +0 -0
  1654. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/insertOne.yml +0 -0
  1655. /data/spec/{support/crud_tests → spec_tests/data/crud}/write/replaceOne-upsert.yml +0 -0
  1656. /data/spec/{support/gridfs_tests → spec_tests/data/gridfs}/download_by_name.yml +0 -0
  1657. /data/spec/{support/gridfs_tests → spec_tests/data/gridfs}/upload.yml +0 -0
  1658. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/DefaultNoMaxStaleness.yml +0 -0
  1659. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/Incompatible.yml +0 -0
  1660. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/LastUpdateTime.yml +0 -0
  1661. /data/spec/{support/max_staleness/ReplicaSetNoPrimary/NoKnownServers.yml → spec_tests/data/max_staleness/ReplicaSetNoPrimary/MaxStalenessTooSmall.yml} +0 -0
  1662. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/Nearest.yml +0 -0
  1663. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/Nearest2.yml +0 -0
  1664. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/PrimaryPreferred.yml +0 -0
  1665. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/PrimaryPreferred_tags.yml +0 -0
  1666. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/Secondary.yml +0 -0
  1667. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/SecondaryPreferred.yml +0 -0
  1668. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/SecondaryPreferred_tags.yml +0 -0
  1669. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetNoPrimary/ZeroMaxStaleness.yml +0 -0
  1670. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/DefaultNoMaxStaleness.yml +0 -0
  1671. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/Incompatible.yml +0 -0
  1672. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/LastUpdateTime.yml +0 -0
  1673. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/LongHeartbeat.yml +0 -0
  1674. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/LongHeartbeat2.yml +0 -0
  1675. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/MaxStalenessTooSmall.yml +0 -0
  1676. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/MaxStalenessWithModePrimary.yml +0 -0
  1677. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/Nearest.yml +0 -0
  1678. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/Nearest2.yml +0 -0
  1679. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/Nearest_tags.yml +0 -0
  1680. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/PrimaryPreferred.yml +0 -0
  1681. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/PrimaryPreferred_incompatible.yml +0 -0
  1682. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/SecondaryPreferred.yml +0 -0
  1683. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/SecondaryPreferred_tags.yml +0 -0
  1684. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/SecondaryPreferred_tags2.yml +0 -0
  1685. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/Secondary_tags.yml +0 -0
  1686. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/Secondary_tags2.yml +0 -0
  1687. /data/spec/{support → spec_tests/data}/max_staleness/ReplicaSetWithPrimary/ZeroMaxStaleness.yml +0 -0
  1688. /data/spec/{support → spec_tests/data}/max_staleness/Sharded/Incompatible.yml +0 -0
  1689. /data/spec/{support → spec_tests/data}/max_staleness/Sharded/SmallMaxStaleness.yml +0 -0
  1690. /data/spec/{support → spec_tests/data}/max_staleness/Single/Incompatible.yml +0 -0
  1691. /data/spec/{support → spec_tests/data}/max_staleness/Single/SmallMaxStaleness.yml +0 -0
  1692. /data/spec/{support → spec_tests/data}/sdam_monitoring/replica_set_with_no_primary.yml +0 -0
  1693. /data/spec/{support → spec_tests/data}/sdam_monitoring/replica_set_with_primary.yml +0 -0
  1694. /data/spec/{support/server_selection/selection → spec_tests/data/server_selection}/ReplicaSetNoPrimary/read/Secondary_multi_tags.yml +0 -0
  1695. /data/spec/{support/server_selection/selection → spec_tests/data/server_selection}/ReplicaSetNoPrimary/read/Secondary_multi_tags2.yml +0 -0
  1696. /data/spec/{support/server_selection/selection → spec_tests/data/server_selection}/ReplicaSetWithPrimary/read/SecondaryPreferred_tags.yml +0 -0
  1697. /data/spec/{support/server_selection/rtt → spec_tests/data/server_selection_rtt}/first_value.yml +0 -0
  1698. /data/spec/{support/server_selection/rtt → spec_tests/data/server_selection_rtt}/first_value_zero.yml +0 -0
  1699. /data/spec/{support/server_selection/rtt → spec_tests/data/server_selection_rtt}/value_test_1.yml +0 -0
  1700. /data/spec/{support/server_selection/rtt → spec_tests/data/server_selection_rtt}/value_test_2.yml +0 -0
  1701. /data/spec/{support/server_selection/rtt → spec_tests/data/server_selection_rtt}/value_test_3.yml +0 -0
  1702. /data/spec/{support/server_selection/rtt → spec_tests/data/server_selection_rtt}/value_test_4.yml +0 -0
  1703. /data/spec/{support/server_selection/rtt → spec_tests/data/server_selection_rtt}/value_test_5.yml +0 -0
data/lib/mongo/cluster.rb CHANGED
@@ -1,4 +1,4 @@
1
- # Copyright (C) 2014-2016 MongoDB, Inc.
1
+ # Copyright (C) 2014-2020 MongoDB Inc.
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -13,13 +13,14 @@
13
13
  # limitations under the License.
14
14
 
15
15
  require 'mongo/cluster/topology'
16
- require 'mongo/cluster/cursor_reaper'
17
- require 'mongo/cluster/app_metadata'
16
+ require 'mongo/cluster/reapers/socket_reaper'
17
+ require 'mongo/cluster/reapers/cursor_reaper'
18
+ require 'mongo/cluster/periodic_executor'
18
19
 
19
20
  module Mongo
20
21
 
21
- # Represents a group of servers on the server side, either as a single server, a
22
- # replica set, or a single or multiple mongos.
22
+ # Represents a group of servers on the server side, either as a
23
+ # single server, a replica set, or a single or multiple mongos.
23
24
  #
24
25
  # @since 2.0.0
25
26
  class Cluster
@@ -27,13 +28,20 @@ module Mongo
27
28
  include Monitoring::Publishable
28
29
  include Event::Subscriber
29
30
  include Loggable
31
+ include ClusterTime::Consumer
30
32
 
31
- # The default number of mongos read retries.
33
+ # The default number of legacy read retries.
32
34
  #
33
35
  # @since 2.1.1
34
36
  MAX_READ_RETRIES = 1
35
37
 
36
- # The default mongos read retry interval, in seconds.
38
+ # The default number of legacy write retries.
39
+ #
40
+ # @since 2.4.2
41
+ MAX_WRITE_RETRIES = 1
42
+
43
+ # The default read retry interval, in seconds, when using legacy read
44
+ # retries.
37
45
  #
38
46
  # @since 2.1.1
39
47
  READ_RETRY_INTERVAL = 5
@@ -43,6 +51,228 @@ module Mongo
43
51
  # @since 2.4.0
44
52
  IDLE_WRITE_PERIOD_SECONDS = 10
45
53
 
54
+ # The cluster time key in responses from mongos servers.
55
+ #
56
+ # @since 2.5.0
57
+ # @deprecated
58
+ CLUSTER_TIME = 'clusterTime'.freeze
59
+
60
+ # Instantiate the new cluster.
61
+ #
62
+ # @api private
63
+ #
64
+ # @example Instantiate the cluster.
65
+ # Mongo::Cluster.new(["127.0.0.1:27017"], monitoring)
66
+ #
67
+ # @note Cluster should never be directly instantiated outside of a Client.
68
+ #
69
+ # @note When connecting to a mongodb+srv:// URI, the client expands such a
70
+ # URI into a list of servers and passes that list to the Cluster
71
+ # constructor. When connecting to a standalone mongod, the Cluster
72
+ # constructor receives the corresponding address as an array of one string.
73
+ #
74
+ # @param [ Array<String> ] seeds The addresses of the configured servers
75
+ # @param [ Monitoring ] monitoring The monitoring.
76
+ # @param [ Hash ] options Options. Client constructor forwards its
77
+ # options to Cluster constructor, although Cluster recognizes
78
+ # only a subset of the options recognized by Client.
79
+ #
80
+ # @option options [ true | false ] :direct_connection Whether to connect
81
+ # directly to the specified seed, bypassing topology discovery. Exactly
82
+ # one seed must be provided.
83
+ # @option options [ Symbol ] :connect Deprecated - use :direct_connection
84
+ # option instead of this option. The connection method to use. This
85
+ # forces the cluster to behave in the specified way instead of
86
+ # auto-discovering. One of :direct, :replica_set, :sharded
87
+ # @option options [ Symbol ] :replica_set The name of the replica set to
88
+ # connect to. Servers not in this replica set will be ignored.
89
+ # @option options [ true | false ] :scan Whether to scan all seeds
90
+ # in constructor. The default in driver version 2.x is to do so;
91
+ # driver version 3.x will not scan seeds in constructor. Opt in to the
92
+ # new behavior by setting this option to false. *Note:* setting
93
+ # this option to nil enables scanning seeds in constructor in driver
94
+ # version 2.x. Driver version 3.x will recognize this option but
95
+ # will ignore it and will never scan seeds in the constructor.
96
+ # @option options [ true | false ] :monitoring_io For internal driver
97
+ # use only. Set to false to prevent SDAM-related I/O from being
98
+ # done by this cluster or servers under it. Note: setting this option
99
+ # to false will make the cluster non-functional. It is intended for
100
+ # use in tests which manually invoke SDAM state transitions.
101
+ # @option options [ true | false ] :cleanup For internal driver use only.
102
+ # Set to false to prevent endSessions command being sent to the server
103
+ # to clean up server sessions when the cluster is disconnected, and to
104
+ # to not start the periodic executor. If :monitoring_io is false,
105
+ # :cleanup automatically defaults to false as well.
106
+ # @option options [ Float ] :heartbeat_frequency The interval, in seconds,
107
+ # for the server monitor to refresh its description via ismaster.
108
+ # @option options [ Hash ] :resolv_options For internal driver use only.
109
+ # Options to pass through to Resolv::DNS constructor for SRV lookups.
110
+ #
111
+ # @since 2.0.0
112
+ def initialize(seeds, monitoring, options = Options::Redacted.new)
113
+ if seeds.nil?
114
+ raise ArgumentError, 'Seeds cannot be nil'
115
+ end
116
+
117
+ options = options.dup
118
+ if options[:monitoring_io] == false && !options.key?(:cleanup)
119
+ options[:cleanup] = false
120
+ end
121
+ @options = options.freeze
122
+
123
+ # @update_lock covers @servers, @connecting, @connected, @topology and
124
+ # @sessions_supported. Generally instance variables that do not have a
125
+ # designated for them lock should only be modified under the update lock.
126
+ # Note that topology change is locked by @update_lock and not by
127
+ # @sdam_flow_lock.
128
+ @update_lock = Mutex.new
129
+ @servers = []
130
+ @monitoring = monitoring
131
+ @event_listeners = Event::Listeners.new
132
+ @app_metadata = Server::AppMetadata.new(@options)
133
+ @cluster_time_lock = Mutex.new
134
+ @cluster_time = nil
135
+ @srv_monitor_lock = Mutex.new
136
+ @srv_monitor = nil
137
+ @server_selection_semaphore = Semaphore.new
138
+ @topology = Topology.initial(self, monitoring, options)
139
+ # State change lock is similar to the sdam flow lock, but is designed
140
+ # to serialize state changes initated by consumers of Cluster
141
+ # (e.g. application connecting or disconnecting the cluster), so that
142
+ # e.g. an application calling disconnect-connect-disconnect rapidly
143
+ # does not put the cluster into an inconsistent state.
144
+ # Monitoring updates performed internally by the driver do not take
145
+ # the state change lock.
146
+ @state_change_lock = Mutex.new
147
+ # @sdam_flow_lock covers just the sdam flow. Note it does not apply
148
+ # to @topology replacements which are done under @update_lock.
149
+ @sdam_flow_lock = Mutex.new
150
+ Session::SessionPool.create(self)
151
+
152
+ # The opening topology is always unknown with no servers.
153
+ # https://github.com/mongodb/specifications/pull/388
154
+ opening_topology = Topology::Unknown.new(options, monitoring, self)
155
+
156
+ publish_sdam_event(
157
+ Monitoring::TOPOLOGY_OPENING,
158
+ Monitoring::Event::TopologyOpening.new(opening_topology)
159
+ )
160
+
161
+ @seeds = seeds = seeds.uniq
162
+ servers = seeds.map do |seed|
163
+ # Server opening events must be sent after topology change events.
164
+ # Therefore separate server addition, done here before topoolgy change
165
+ # event is published, from starting to monitor the server which is
166
+ # done later.
167
+ add(seed, monitor: false)
168
+ end
169
+
170
+ if seeds.size >= 1
171
+ # Recreate the topology to get the current server list into it
172
+ @topology = topology.class.new(topology.options, topology.monitoring, self)
173
+ publish_sdam_event(
174
+ Monitoring::TOPOLOGY_CHANGED,
175
+ Monitoring::Event::TopologyChanged.new(opening_topology, @topology)
176
+ )
177
+ end
178
+
179
+ if options[:monitoring_io] == false
180
+ # Omit periodic executor construction, because without servers
181
+ # no commands can be sent to the cluster and there shouldn't ever
182
+ # be anything that needs to be cleaned up.
183
+ #
184
+ # Omit monitoring individual servers and the legacy single round of
185
+ # of SDAM on the main thread, as it would race with tests that mock
186
+ # SDAM responses.
187
+ @connecting = @connected = false
188
+ return
189
+ end
190
+
191
+ # Update instance variables prior to starting monitoring threads.
192
+ @connecting = false
193
+ @connected = true
194
+
195
+ if options[:cleanup] != false
196
+ @cursor_reaper = CursorReaper.new
197
+ @socket_reaper = SocketReaper.new(self)
198
+ @periodic_executor = PeriodicExecutor.new([
199
+ @cursor_reaper, @socket_reaper,
200
+ ], options)
201
+
202
+ ObjectSpace.define_finalizer(self, self.class.finalize(
203
+ {}, @periodic_executor, @session_pool))
204
+
205
+ @periodic_executor.run!
206
+ end
207
+
208
+ # Need to record start time prior to starting monitoring
209
+ start_time = Time.now
210
+
211
+ servers.each do |server|
212
+ server.start_monitoring
213
+ end
214
+
215
+ if options[:scan] != false
216
+ server_selection_timeout = options[:server_selection_timeout] || ServerSelector::SERVER_SELECTION_TIMEOUT
217
+ # The server selection timeout can be very short especially in
218
+ # tests, when the client waits for a synchronous scan before
219
+ # starting server selection. Limiting the scan to server selection time
220
+ # then aborts the scan before it can process even local servers.
221
+ # Therefore, allow at least 3 seconds for the scan here.
222
+ if server_selection_timeout < 3
223
+ server_selection_timeout = 3
224
+ end
225
+ deadline = start_time + server_selection_timeout
226
+ # Wait for the first scan of each server to complete, for
227
+ # backwards compatibility.
228
+ # If any servers are discovered during this SDAM round we are going to
229
+ # wait for these servers to also be queried, and so on, up to the
230
+ # server selection timeout or the 3 second minimum.
231
+ loop do
232
+ # Ensure we do not try to read the servers list while SDAM is running
233
+ servers = @sdam_flow_lock.synchronize do
234
+ servers_list.dup
235
+ end
236
+ if servers.all? { |server| server.last_scan && server.last_scan >= start_time }
237
+ break
238
+ end
239
+ if (time_remaining = deadline - Time.now) <= 0
240
+ break
241
+ end
242
+ log_debug("Waiting for up to #{'%.2f' % time_remaining} seconds for servers to be scanned: #{summary}")
243
+ # Since the semaphore may have been signaled between us checking
244
+ # the servers list above and the wait call below, we should not
245
+ # wait for the full remaining time - wait for up to 1 second, then
246
+ # recheck the state.
247
+ server_selection_semaphore.wait([time_remaining, 1].min)
248
+ end
249
+ end
250
+
251
+ start_stop_srv_monitor
252
+ end
253
+
254
+ # Create a cluster for the provided client, for use when we don't want the
255
+ # client's original cluster instance to be the same.
256
+ #
257
+ # @api private
258
+ #
259
+ # @example Create a cluster for the client.
260
+ # Cluster.create(client)
261
+ #
262
+ # @param [ Client ] client The client to create on.
263
+ #
264
+ # @return [ Cluster ] The cluster.
265
+ #
266
+ # @since 2.0.0
267
+ def self.create(client)
268
+ cluster = Cluster.new(
269
+ client.cluster.addresses.map(&:to_s),
270
+ Monitoring.new,
271
+ client.cluster_options,
272
+ )
273
+ client.instance_variable_set(:@cluster, cluster)
274
+ end
275
+
46
276
  # @return [ Hash ] The options hash.
47
277
  attr_reader :options
48
278
 
@@ -52,153 +282,144 @@ module Mongo
52
282
  # @return [ Object ] The cluster topology.
53
283
  attr_reader :topology
54
284
 
55
- # @return [ Mongo::Cluster::AppMetadata ] The application metadata, used for connection
56
- # handshakes.
285
+ # @return [ Mongo::Server::AppMetadata ] The application metadata, used for
286
+ # connection handshakes.
57
287
  #
58
288
  # @since 2.4.0
59
289
  attr_reader :app_metadata
60
290
 
291
+ # @return [ Array<String> ] The addresses of seed servers. Contains
292
+ # addresses that were given to Cluster when it was instantiated, not
293
+ # current addresses that the cluster is using as a result of SDAM.
294
+ #
295
+ # @since 2.7.0
296
+ # @api private
297
+ attr_reader :seeds
298
+
299
+ # @private
300
+ #
301
+ # @since 2.5.1
302
+ attr_reader :session_pool
303
+
61
304
  def_delegators :topology, :replica_set?, :replica_set_name, :sharded?,
62
- :single?, :unknown?, :member_discovered
63
- def_delegators :@cursor_reaper, :register_cursor, :schedule_kill_cursor, :unregister_cursor
305
+ :single?, :unknown?
64
306
 
65
- # Determine if this cluster of servers is equal to another object. Checks the
66
- # servers currently in the cluster, not what was configured.
307
+ [:register_cursor, :schedule_kill_cursor, :unregister_cursor].each do |m|
308
+ define_method(m) do |*args|
309
+ if options[:cleanup] != false
310
+ @cursor_reaper.send(m, *args)
311
+ end
312
+ end
313
+ end
314
+
315
+ # @api private
316
+ attr_reader :srv_monitor
317
+
318
+ # Get the maximum number of times the client can retry a read operation
319
+ # when using legacy read retries.
67
320
  #
68
- # @example Is the cluster equal to the object?
69
- # cluster == other
321
+ # @note max_read_retries should be retrieved from the Client instance,
322
+ # not from a Cluster instance, because clusters may be shared between
323
+ # clients with different values for max read retries.
70
324
  #
71
- # @param [ Object ] other The object to compare to.
325
+ # @example Get the max read retries.
326
+ # cluster.max_read_retries
72
327
  #
73
- # @return [ true, false ] If the objects are equal.
328
+ # @return [ Integer ] The maximum number of retries.
74
329
  #
75
- # @since 2.0.0
76
- def ==(other)
77
- return false unless other.is_a?(Cluster)
78
- addresses == other.addresses && options == other.options
330
+ # @since 2.1.1
331
+ # @deprecated
332
+ def max_read_retries
333
+ options[:max_read_retries] || MAX_READ_RETRIES
79
334
  end
80
335
 
81
- # Add a server to the cluster with the provided address. Useful in
82
- # auto-discovery of new servers when an existing server executes an ismaster
83
- # and potentially non-configured servers were included.
336
+ # Get the interval, in seconds, in which read retries when using legacy
337
+ # read retries.
84
338
  #
85
- # @example Add the server for the address to the cluster.
86
- # cluster.add('127.0.0.1:27018')
339
+ # @note read_retry_interval should be retrieved from the Client instance,
340
+ # not from a Cluster instance, because clusters may be shared between
341
+ # clients with different values for the read retry interval.
87
342
  #
88
- # @param [ String ] host The address of the server to add.
343
+ # @example Get the read retry interval.
344
+ # cluster.read_retry_interval
89
345
  #
90
- # @return [ Server ] The newly added server, if not present already.
346
+ # @return [ Float ] The interval.
91
347
  #
92
- # @since 2.0.0
93
- def add(host)
94
- address = Address.new(host)
95
- if !addresses.include?(address)
96
- if addition_allowed?(address)
97
- @update_lock.synchronize { @addresses.push(address) }
98
- server = Server.new(address, self, @monitoring, event_listeners, options)
99
- @update_lock.synchronize { @servers.push(server) }
100
- server
101
- end
102
- end
348
+ # @since 2.1.1
349
+ # @deprecated
350
+ def read_retry_interval
351
+ options[:read_retry_interval] || READ_RETRY_INTERVAL
103
352
  end
104
353
 
105
- # Determine if the cluster would select a readable server for the
106
- # provided read preference.
354
+ # Get the refresh interval for the server. This will be defined via an
355
+ # option or will default to 10.
107
356
  #
108
- # @example Is a readable server present?
109
- # topology.has_readable_server?(server_selector)
357
+ # @return [ Float ] The heartbeat interval, in seconds.
110
358
  #
111
- # @param [ ServerSelector ] server_selector The server
112
- # selector.
113
- #
114
- # @return [ true, false ] If a readable server is present.
115
- #
116
- # @since 2.4.0
117
- def has_readable_server?(server_selector = nil)
118
- topology.has_readable_server?(self, server_selector)
359
+ # @since 2.10.0
360
+ # @api private
361
+ def heartbeat_interval
362
+ options[:heartbeat_frequency] || Server::Monitor::DEFAULT_HEARTBEAT_INTERVAL
119
363
  end
120
364
 
121
- # Determine if the cluster would select a writable server.
365
+ # Whether the cluster object is in the process of connecting to its cluster.
122
366
  #
123
- # @example Is a writable server present?
124
- # topology.has_writable_server?
367
+ # @return [ true|false ] Whether the cluster is connecting.
125
368
  #
126
- # @return [ true, false ] If a writable server is present.
127
- #
128
- # @since 2.4.0
129
- def has_writable_server?
130
- topology.has_writable_server?(self)
369
+ # @api private
370
+ def connecting?
371
+ @update_lock.synchronize do
372
+ !!@connecting
373
+ end
131
374
  end
132
375
 
133
- # Instantiate the new cluster.
376
+ # Whether the cluster object is connected to its cluster.
134
377
  #
135
- # @api private
378
+ # @return [ true|false ] Whether the cluster is connected.
136
379
  #
137
- # @example Instantiate the cluster.
138
- # Mongo::Cluster.new(["127.0.0.1:27017"], monitoring)
380
+ # @api private
381
+ # @since 2.7.0
382
+ def connected?
383
+ @update_lock.synchronize do
384
+ !!@connected
385
+ end
386
+ end
387
+
388
+ # Get a list of server candidates from the cluster that can have operations
389
+ # executed on them.
139
390
  #
140
- # @note Cluster should never be directly instantiated outside of a Client.
391
+ # @example Get the server candidates for an operation.
392
+ # cluster.servers
141
393
  #
142
- # @param [ Array<String> ] seeds The addresses of the configured servers.
143
- # @param [ Monitoring ] monitoring The monitoring.
144
- # @param [ Hash ] options The options.
394
+ # @return [ Array<Server> ] The candidate servers.
145
395
  #
146
396
  # @since 2.0.0
147
- def initialize(seeds, monitoring, options = Options::Redacted.new)
148
- @addresses = []
149
- @servers = []
150
- @monitoring = monitoring
151
- @event_listeners = Event::Listeners.new
152
- @options = options.freeze
153
- @app_metadata ||= AppMetadata.new(self)
154
- @update_lock = Mutex.new
155
- @pool_lock = Mutex.new
156
- @topology = Topology.initial(seeds, monitoring, options)
157
-
158
- publish_sdam_event(
159
- Monitoring::TOPOLOGY_OPENING,
160
- Monitoring::Event::TopologyOpening.new(@topology)
161
- )
162
-
163
- subscribe_to(Event::STANDALONE_DISCOVERED, Event::StandaloneDiscovered.new(self))
164
- subscribe_to(Event::DESCRIPTION_CHANGED, Event::DescriptionChanged.new(self))
165
- subscribe_to(Event::MEMBER_DISCOVERED, Event::MemberDiscovered.new(self))
166
-
167
- seeds.each{ |seed| add(seed) }
168
-
169
- publish_sdam_event(
170
- Monitoring::TOPOLOGY_CHANGED,
171
- Monitoring::Event::TopologyChanged.new(@topology, @topology)
172
- ) if @servers.size > 1
173
-
174
- @cursor_reaper = CursorReaper.new
175
- @cursor_reaper.run!
176
-
177
- ObjectSpace.define_finalizer(self, self.class.finalize(pools))
397
+ def servers
398
+ topology.servers(servers_list)
178
399
  end
179
400
 
180
- # Finalize the cluster for garbage collection. Disconnects all the scoped
181
- # connection pools.
182
- #
183
- # @example Finalize the cluster.
184
- # Cluster.finalize(pools)
401
+ # The addresses in the cluster.
185
402
  #
186
- # @param [ Hash<Address, Server::ConnectionPool> ] pools The connection
187
- # pools.
403
+ # @example Get the addresses in the cluster.
404
+ # cluster.addresses
188
405
  #
189
- # @return [ Proc ] The Finalizer.
406
+ # @return [ Array<Mongo::Address> ] The addresses.
190
407
  #
191
- # @since 2.2.0
192
- def self.finalize(pools)
193
- proc do
194
- begin; @cursor_reaper.kill_cursors; rescue; end
195
- @cursor_reaper.stop!
196
- pools.values.each do |pool|
197
- pool.disconnect!
198
- end
199
- end
408
+ # @since 2.0.6
409
+ def addresses
410
+ servers_list.map(&:address)
200
411
  end
201
412
 
413
+ # The logical session timeout value in minutes.
414
+ #
415
+ # @example Get the logical session timeout in minutes.
416
+ # cluster.logical_session_timeout
417
+ #
418
+ # @return [ Integer, nil ] The logical session timeout.
419
+ #
420
+ # @since 2.5.0
421
+ def_delegators :topology, :logical_session_timeout
422
+
202
423
  # Get the nicer formatted string for use in inspection.
203
424
  #
204
425
  # @example Inspect the cluster.
@@ -208,263 +429,566 @@ module Mongo
208
429
  #
209
430
  # @since 2.0.0
210
431
  def inspect
211
- "#<Mongo::Cluster:0x#{object_id} servers=#{servers} topology=#{topology.display_name}>"
432
+ "#<Mongo::Cluster:0x#{object_id} servers=#{servers} topology=#{topology.summary}>"
212
433
  end
213
434
 
214
- # Get the next primary server we can send an operation to.
435
+ # @note This method is experimental and subject to change.
215
436
  #
216
- # @example Get the next primary server.
217
- # cluster.next_primary
437
+ # @api experimental
438
+ # @since 2.7.0
439
+ def summary
440
+ "#<Cluster " +
441
+ "topology=#{topology.summary} "+
442
+ "servers=[#{servers_list.map(&:summary).join(',')}]>"
443
+ end
444
+
445
+ # @api private
446
+ attr_reader :server_selection_semaphore
447
+
448
+ # Finalize the cluster for garbage collection.
218
449
  #
219
- # @param [ true, false ] ping Whether to ping the server before selection.
450
+ # @example Finalize the cluster.
451
+ # Cluster.finalize(pools)
220
452
  #
221
- # @return [ Mongo::Server ] A primary server.
453
+ # @param [ Hash<Address, Server::ConnectionPool> ] pools Ignored.
454
+ # @param [ PeriodicExecutor ] periodic_executor The periodic executor.
455
+ # @param [ SessionPool ] session_pool The session pool.
222
456
  #
223
- # @since 2.0.0
224
- def next_primary(ping = true)
225
- @primary_selector ||= ServerSelector.get(ServerSelector::PRIMARY)
226
- @primary_selector.select_server(self, ping)
457
+ # @return [ Proc ] The Finalizer.
458
+ #
459
+ # @since 2.2.0
460
+ def self.finalize(pools, periodic_executor, session_pool)
461
+ proc do
462
+ session_pool.end_sessions
463
+ periodic_executor.stop!
464
+ end
227
465
  end
228
466
 
229
- # Elect a primary server from the description that has just changed to a
230
- # primary.
467
+ # Closes the cluster.
231
468
  #
232
- # @example Elect a primary server.
233
- # cluster.elect_primary!(description)
469
+ # @note Applications should call Client#close to disconnect from
470
+ # the cluster rather than calling this method. This method is for
471
+ # internal driver use only.
234
472
  #
235
- # @param [ Server::Description ] description The newly elected primary.
473
+ # Disconnects all servers in the cluster, publishing appropriate SDAM
474
+ # events in the process. Stops SRV monitoring if it is active.
475
+ # Marks the cluster disconnected.
236
476
  #
237
- # @return [ Topology ] The cluster topology.
477
+ # @return [ true ] Always true.
238
478
  #
239
- # @since 2.0.0
240
- def elect_primary!(description)
241
- @topology = topology.elect_primary(description, servers_list)
479
+ # @since 2.1.0
480
+ def disconnect!
481
+ @state_change_lock.synchronize do
482
+ unless connecting? || connected?
483
+ return true
484
+ end
485
+ if options[:cleanup] != false
486
+ session_pool.end_sessions
487
+ @periodic_executor.stop!
488
+ end
489
+ @srv_monitor_lock.synchronize do
490
+ if @srv_monitor
491
+ @srv_monitor.stop!
492
+ end
493
+ end
494
+ @servers.each do |server|
495
+ if server.connected?
496
+ server.disconnect!
497
+ publish_sdam_event(
498
+ Monitoring::SERVER_CLOSED,
499
+ Monitoring::Event::ServerClosed.new(server.address, topology)
500
+ )
501
+ end
502
+ end
503
+ publish_sdam_event(
504
+ Monitoring::TOPOLOGY_CLOSED,
505
+ Monitoring::Event::TopologyClosed.new(topology)
506
+ )
507
+ @update_lock.synchronize do
508
+ @connecting = @connected = false
509
+ end
510
+ end
511
+ true
242
512
  end
243
513
 
244
- # Get the maximum number of times the cluster can retry a read operation on
245
- # a mongos.
514
+ # Reconnect all servers.
246
515
  #
247
- # @example Get the max read retries.
248
- # cluster.max_read_retries
516
+ # @example Reconnect the cluster's servers.
517
+ # cluster.reconnect!
249
518
  #
250
- # @return [ Integer ] The maximum retries.
519
+ # @return [ true ] Always true.
251
520
  #
252
- # @since 2.1.1
253
- def max_read_retries
254
- options[:max_read_retries] || MAX_READ_RETRIES
521
+ # @since 2.1.0
522
+ # @deprecated Use Client#reconnect to reconnect to the cluster instead of
523
+ # calling this method. This method does not send SDAM events.
524
+ def reconnect!
525
+ @state_change_lock.synchronize do
526
+ @update_lock.synchronize do
527
+ @connecting = true
528
+ end
529
+ scan!
530
+ servers.each do |server|
531
+ server.reconnect!
532
+ end
533
+ @periodic_executor.restart!
534
+ @srv_monitor_lock.synchronize do
535
+ if @srv_monitor
536
+ @srv_monitor.run!
537
+ end
538
+ end
539
+ @update_lock.synchronize do
540
+ @connecting = false
541
+ @connected = true
542
+ end
543
+ end
255
544
  end
256
545
 
257
- # Get the scoped connection pool for the server.
546
+ # Force a scan of all known servers in the cluster.
258
547
  #
259
- # @example Get the connection pool.
260
- # cluster.pool(server)
548
+ # If the sync parameter is true which is the default, the scan is
549
+ # performed synchronously in the thread which called this method.
550
+ # Each server in the cluster is checked sequentially. If there are
551
+ # many servers in the cluster or they are slow to respond, this
552
+ # can be a long running operation.
261
553
  #
262
- # @param [ Server ] server The server.
554
+ # If the sync parameter is false, this method instructs all server
555
+ # monitor threads to perform an immediate scan and returns without
556
+ # waiting for scan results.
263
557
  #
264
- # @return [ Server::ConnectionPool ] The connection pool.
558
+ # @note In both synchronous and asynchronous scans, each monitor
559
+ # thread maintains a minimum interval between scans, meaning
560
+ # calling this method may not initiate a scan on a particular server
561
+ # the very next instant.
265
562
  #
266
- # @since 2.2.0
267
- def pool(server)
268
- @pool_lock.synchronize do
269
- pools[server.address] ||= Server::ConnectionPool.get(server)
563
+ # @example Force a full cluster scan.
564
+ # cluster.scan!
565
+ #
566
+ # @return [ true ] Always true.
567
+ #
568
+ # @since 2.0.0
569
+ def scan!(sync=true)
570
+ if sync
571
+ servers_list.each do |server|
572
+ if server.monitor
573
+ server.monitor.scan!
574
+ else
575
+ log_warn("Synchronous scan requested on cluster #{summary} but server #{server} has no monitor")
576
+ end
577
+ end
578
+ else
579
+ servers_list.each do |server|
580
+ server.scan_semaphore.signal
581
+ end
270
582
  end
583
+ true
271
584
  end
272
585
 
273
- # Get the interval, in seconds, in which a mongos read operation is
274
- # retried.
586
+ # Runs SDAM flow on the cluster.
275
587
  #
276
- # @example Get the read retry interval.
277
- # cluster.read_retry_interval
588
+ # This method can be invoked to process a new server description returned
589
+ # by the server on a monitoring or non-monitoring connection, and also
590
+ # by the driver when it marks a server unknown as a result of a (network)
591
+ # error.
278
592
  #
279
- # @return [ Float ] The interval.
593
+ # @param [ Server::Description ] previous_desc Previous server description.
594
+ # @param [ Server::Description ] updated_desc The changed description.
595
+ # @param [ Hash ] options Options.
280
596
  #
281
- # @since 2.1.1
282
- def read_retry_interval
283
- options[:read_retry_interval] || READ_RETRY_INTERVAL
597
+ # @option options [ true | false ] :keep_connection_pool Usually when the
598
+ # new server description is unknown, the connection pool on the
599
+ # respective server is cleared. Set this option to true to keep the
600
+ # existing connection pool (required when handling not master errors
601
+ # on 4.2+ servers).
602
+ # @option aptions [ true | false ] :awaited Whether the updated description
603
+ # was a result of processing an awaited ismaster.
604
+ #
605
+ # @api private
606
+ def run_sdam_flow(previous_desc, updated_desc, options = {})
607
+ @sdam_flow_lock.synchronize do
608
+ flow = SdamFlow.new(self, previous_desc, updated_desc,
609
+ awaited: options[:awaited])
610
+ flow.server_description_changed
611
+
612
+ # SDAM flow may alter the updated description - grab the final
613
+ # version for the purposes of broadcasting if a server is available
614
+ updated_desc = flow.updated_desc
615
+
616
+ unless options[:keep_connection_pool]
617
+ if flow.became_unknown?
618
+ servers_list.each do |server|
619
+ if server.address == updated_desc.address
620
+ server.clear_connection_pool
621
+ end
622
+ end
623
+ end
624
+ end
625
+
626
+ start_stop_srv_monitor
627
+ end
628
+
629
+ # Some updated descriptions, e.g. a mismatched me one, result in the
630
+ # server whose description we are processing being removed from
631
+ # the topology. When this happens, the server's monitoring thread gets
632
+ # killed. As a result, any code after the flow invocation may not run
633
+ # a particular monitor instance, hence there should generally not be
634
+ # any code in this method past the flow invocation.
635
+ #
636
+ # However, this broadcast call can be here because if the monitoring
637
+ # thread got killed the server should have been closed and no client
638
+ # should be currently waiting for it, thus not signaling the semaphore
639
+ # shouldn't cause any problems.
640
+ unless updated_desc.unknown?
641
+ server_selection_semaphore.broadcast
642
+ end
284
643
  end
285
644
 
286
- # Notify the cluster that a standalone server was discovered so that the
287
- # topology can be updated accordingly.
645
+ # Sets the list of servers to the addresses in the provided list of address
646
+ # strings.
288
647
  #
289
- # @example Notify the cluster that a standalone server was discovered.
290
- # cluster.standalone_discovered
648
+ # This method is called by the SRV monitor after receiving new DNS records
649
+ # for the monitored hostname.
291
650
  #
292
- # @return [ Topology ] The cluster topology.
651
+ # Removes servers in the cluster whose addresses are not in the passed
652
+ # list of server addresses, and adds servers for any addresses in the
653
+ # argument which are not already in the cluster.
293
654
  #
294
- # @since 2.0.6
295
- def standalone_discovered
296
- @topology = topology.standalone_discovered
655
+ # @param [ Array<String> ] server_address_strs List of server addresses
656
+ # to sync the cluster servers to.
657
+ #
658
+ # @api private
659
+ def set_server_list(server_address_strs)
660
+ @sdam_flow_lock.synchronize do
661
+ server_address_strs.each do |address_str|
662
+ unless servers_list.any? { |server| server.address.seed == address_str }
663
+ add(address_str)
664
+ end
665
+ end
666
+
667
+ servers_list.each do |server|
668
+ unless server_address_strs.any? { |address_str| server.address.seed == address_str }
669
+ remove(server.address.seed)
670
+ end
671
+ end
672
+ end
297
673
  end
298
674
 
299
- # Remove the server from the cluster for the provided address, if it
300
- # exists.
675
+ # Determine if this cluster of servers is equal to another object. Checks the
676
+ # servers currently in the cluster, not what was configured.
301
677
  #
302
- # @example Remove the server from the cluster.
303
- # server.remove('127.0.0.1:27017')
678
+ # @example Is the cluster equal to the object?
679
+ # cluster == other
304
680
  #
305
- # @param [ String ] host The host/port or socket address.
681
+ # @param [ Object ] other The object to compare to.
682
+ #
683
+ # @return [ true, false ] If the objects are equal.
306
684
  #
307
685
  # @since 2.0.0
308
- def remove(host)
309
- address = Address.new(host)
310
- removed_servers = @servers.select { |s| s.address == address }
311
- @update_lock.synchronize { @servers = @servers - removed_servers }
312
- removed_servers.each{ |server| server.disconnect! } if removed_servers
313
- publish_sdam_event(
314
- Monitoring::SERVER_CLOSED,
315
- Monitoring::Event::ServerClosed.new(address, topology)
316
- )
317
- @update_lock.synchronize { @addresses.reject! { |addr| addr == address } }
686
+ def ==(other)
687
+ return false unless other.is_a?(Cluster)
688
+ addresses == other.addresses && options == other.options
318
689
  end
319
690
 
320
- # Force a scan of all known servers in the cluster.
691
+ # Determine if the cluster would select a readable server for the
692
+ # provided read preference.
321
693
  #
322
- # @example Force a full cluster scan.
323
- # cluster.scan!
694
+ # @example Is a readable server present?
695
+ # topology.has_readable_server?(server_selector)
324
696
  #
325
- # @note This operation is done synchronously. If servers in the cluster are
326
- # down or slow to respond this can potentially be a slow operation.
697
+ # @param [ ServerSelector ] server_selector The server
698
+ # selector.
327
699
  #
328
- # @return [ true ] Always true.
700
+ # @return [ true, false ] If a readable server is present.
329
701
  #
330
- # @since 2.0.0
331
- def scan!
332
- servers_list.each{ |server| server.scan! } and true
702
+ # @since 2.4.0
703
+ def has_readable_server?(server_selector = nil)
704
+ topology.has_readable_server?(self, server_selector)
333
705
  end
334
706
 
335
- # Get a list of server candidates from the cluster that can have operations
336
- # executed on them.
707
+ # Determine if the cluster would select a writable server.
337
708
  #
338
- # @example Get the server candidates for an operation.
339
- # cluster.servers
709
+ # @example Is a writable server present?
710
+ # topology.has_writable_server?
340
711
  #
341
- # @return [ Array<Server> ] The candidate servers.
712
+ # @return [ true, false ] If a writable server is present.
342
713
  #
343
- # @since 2.0.0
344
- def servers
345
- topology.servers(servers_list.compact).compact
714
+ # @since 2.4.0
715
+ def has_writable_server?
716
+ topology.has_writable_server?(self)
346
717
  end
347
718
 
348
- # Disconnect all servers.
719
+ # Get the next primary server we can send an operation to.
349
720
  #
350
- # @example Disconnect the cluster's servers.
351
- # cluster.disconnect!
721
+ # @example Get the next primary server.
722
+ # cluster.next_primary
352
723
  #
353
- # @return [ true ] Always true.
724
+ # @param [ true, false ] ping Whether to ping the server before selection.
725
+ # Deprecated and ignored.
726
+ # @param [ Session | nil ] session Optional session to take into account
727
+ # for mongos pinning.
354
728
  #
355
- # @since 2.1.0
356
- def disconnect!
357
- begin; @cursor_reaper.kill_cursors; rescue; end
358
- @cursor_reaper.stop!
359
- @servers.each { |server| server.disconnect! } and true
729
+ # @return [ Mongo::Server ] A primary server.
730
+ #
731
+ # @since 2.0.0
732
+ def next_primary(ping = nil, session = nil)
733
+ ServerSelector.primary.select_server(self, nil, session)
360
734
  end
361
735
 
362
- # Reconnect all servers.
736
+ # Get the connection pool for the server.
363
737
  #
364
- # @example Reconnect the cluster's servers.
365
- # cluster.reconnect!
738
+ # @example Get the connection pool.
739
+ # cluster.pool(server)
366
740
  #
367
- # @return [ true ] Always true.
741
+ # @param [ Server ] server The server.
368
742
  #
369
- # @since 2.1.0
370
- def reconnect!
371
- scan!
372
- servers.each { |server| server.reconnect! }
373
- @cursor_reaper.restart! and true
743
+ # @return [ Server::ConnectionPool ] The connection pool.
744
+ #
745
+ # @since 2.2.0
746
+ # @deprecated
747
+ def pool(server)
748
+ server.pool
374
749
  end
375
750
 
376
- # Add hosts in a description to the cluster.
751
+ # Update the max cluster time seen in a response.
377
752
  #
378
- # @example Add hosts in a description to the cluster.
379
- # cluster.add_hosts(description)
753
+ # @example Update the cluster time.
754
+ # cluster.update_cluster_time(result)
380
755
  #
381
- # @param [ Mongo::Server::Description ] description The description.
756
+ # @param [ Operation::Result ] result The operation result containing the cluster time.
382
757
  #
383
- # @since 2.0.6
384
- def add_hosts(description)
385
- if topology.add_hosts?(description, servers_list)
386
- description.servers.each { |s| add(s) }
758
+ # @return [ Object ] The cluster time.
759
+ #
760
+ # @since 2.5.0
761
+ def update_cluster_time(result)
762
+ if cluster_time_doc = result.cluster_time
763
+ @cluster_time_lock.synchronize do
764
+ advance_cluster_time(cluster_time_doc)
765
+ end
387
766
  end
388
767
  end
389
768
 
390
- # Remove hosts in a description from the cluster.
769
+ # Add a server to the cluster with the provided address. Useful in
770
+ # auto-discovery of new servers when an existing server executes an ismaster
771
+ # and potentially non-configured servers were included.
391
772
  #
392
- # @example Remove hosts in a description from the cluster.
393
- # cluster.remove_hosts(description)
773
+ # @example Add the server for the address to the cluster.
774
+ # cluster.add('127.0.0.1:27018')
394
775
  #
395
- # @param [ Mongo::Server::Description ] description The description.
776
+ # @param [ String ] host The address of the server to add.
396
777
  #
397
- # @since 2.0.6
398
- def remove_hosts(description)
399
- if topology.remove_hosts?(description)
400
- servers_list.each do |s|
401
- remove(s.address.to_s) if topology.remove_server?(description, s)
778
+ # @option options [ Boolean ] :monitor For internal driver use only:
779
+ # whether to monitor the newly added server.
780
+ #
781
+ # @return [ Server ] The newly added server, if not present already.
782
+ #
783
+ # @since 2.0.0
784
+ def add(host, add_options=nil)
785
+ address = Address.new(host, options)
786
+ if !addresses.include?(address)
787
+ server = Server.new(address, self, @monitoring, event_listeners, options.merge(
788
+ monitor: false))
789
+ @update_lock.synchronize do
790
+ # Need to recheck whether server is present in @servers, because
791
+ # the previous check was not under a lock.
792
+ # Since we are under the update lock here, we cannot call servers_list.
793
+ return if @servers.map(&:address).include?(address)
794
+
795
+ @servers.push(server)
402
796
  end
797
+ if add_options.nil? || add_options[:monitor] != false
798
+ server.start_monitoring
799
+ end
800
+ server
403
801
  end
404
802
  end
405
803
 
406
- # Create a cluster for the provided client, for use when we don't want the
407
- # client's original cluster instance to be the same.
804
+ # Remove the server from the cluster for the provided address, if it
805
+ # exists.
408
806
  #
409
- # @api private
807
+ # @example Remove the server from the cluster.
808
+ # server.remove('127.0.0.1:27017')
410
809
  #
411
- # @example Create a cluster for the client.
412
- # Cluster.create(client)
810
+ # @param [ String ] host The host/port or socket address.
811
+ # @param [ true | false ] disconnect Whether to disconnect the servers
812
+ # being removed. For internal driver use only.
413
813
  #
414
- # @param [ Client ] client The client to create on.
814
+ # @return [ Array<Server> | true | false ] If disconnect is any value other
815
+ # than false, including nil, returns whether any servers were removed.
816
+ # If disconnect is false, returns an array of servers that were removed
817
+ # (and should be disconnected by the caller).
415
818
  #
416
- # @return [ Cluster ] The cluster.
819
+ # @note The return value of this method is not part of the driver's
820
+ # public API.
417
821
  #
418
822
  # @since 2.0.0
419
- def self.create(client)
420
- cluster = Cluster.new(
421
- client.cluster.addresses.map(&:to_s),
422
- client.instance_variable_get(:@monitoring).dup,
423
- client.options
424
- )
425
- client.instance_variable_set(:@cluster, cluster)
823
+ def remove(host, disconnect: true)
824
+ address = Address.new(host)
825
+ removed_servers = []
826
+ @update_lock.synchronize do
827
+ @servers.delete_if do |server|
828
+ (server.address == address).tap do |delete|
829
+ if delete
830
+ removed_servers << server
831
+ end
832
+ end
833
+ end
834
+ end
835
+ if disconnect != false
836
+ removed_servers.each do |server|
837
+ disconnect_server_if_connected(server)
838
+ end
839
+ end
840
+ if disconnect != false
841
+ removed_servers.any?
842
+ else
843
+ removed_servers
844
+ end
426
845
  end
427
846
 
428
- # The addresses in the cluster.
429
- #
430
- # @example Get the addresses in the cluster.
431
- # cluster.addresses
432
- #
433
- # @return [ Array<Mongo::Address> ] The addresses.
434
- #
435
- # @since 2.0.6
436
- def addresses
437
- addresses_list
438
- end
847
+ # @api private
848
+ def update_topology(new_topology)
849
+ old_topology = nil
850
+ @update_lock.synchronize do
851
+ old_topology = topology
852
+ @topology = new_topology
853
+ end
439
854
 
440
- private
855
+ # If new topology has data bearing servers, we know for sure whether
856
+ # sessions are supported - update our cached value.
857
+ # If new topology has no data bearing servers, leave the old value
858
+ # as it is and sessions_supported? method will perform server selection
859
+ # to try to determine session support accurately, falling back to the
860
+ # last known value.
861
+ if topology.data_bearing_servers?
862
+ sessions_supported = !!topology.logical_session_timeout
863
+ @update_lock.synchronize do
864
+ @sessions_supported = sessions_supported
865
+ end
866
+ end
441
867
 
442
- def direct_connection?(address)
443
- address.seed == @topology.seed
868
+ publish_sdam_event(
869
+ Monitoring::TOPOLOGY_CHANGED,
870
+ Monitoring::Event::TopologyChanged.new(old_topology, topology)
871
+ )
444
872
  end
445
873
 
446
- def addition_allowed?(address)
447
- !@topology.single? || direct_connection?(address)
874
+ # @api private
875
+ def servers_list
876
+ @update_lock.synchronize do
877
+ @servers.dup
878
+ end
448
879
  end
449
880
 
450
- def pools
451
- @pools ||= {}
881
+ # @api private
882
+ def disconnect_server_if_connected(server)
883
+ if server.connected?
884
+ server.disconnect!
885
+ publish_sdam_event(
886
+ Monitoring::SERVER_CLOSED,
887
+ Monitoring::Event::ServerClosed.new(server.address, topology)
888
+ )
889
+ end
452
890
  end
453
891
 
454
- def servers_list
455
- @update_lock.synchronize do
456
- @servers.reduce([]) do |servers, server|
457
- servers << server
892
+ # Raises Error::SessionsNotAvailable if the deployment that the driver
893
+ # is connected to does not support sessions.
894
+ #
895
+ # Session support may change over time, for example due to servers in the
896
+ # deployment being upgraded or downgraded. If the client is currently not
897
+ # connected to any data bearing servers, this method considers the state
898
+ # of session support as of when the client was last connected to at
899
+ # least one server. If the client has never connected to any servers,
900
+ # the deployment is considered to not support sessions.
901
+ #
902
+ # @api private
903
+ def validate_session_support!
904
+ @state_change_lock.synchronize do
905
+ @sdam_flow_lock.synchronize do
906
+ if topology.data_bearing_servers?
907
+ unless topology.logical_session_timeout
908
+ raise_sessions_not_supported
909
+ end
910
+ end
911
+ end
912
+ end
913
+
914
+ # No data bearing servers known - perform server selection to try to
915
+ # get a response from at least one of them, to return an accurate
916
+ # assessment of whether sessions are currently supported.
917
+ begin
918
+ ServerSelector.get(mode: :primary_preferred).select_server(self)
919
+ @state_change_lock.synchronize do
920
+ @sdam_flow_lock.synchronize do
921
+ unless topology.logical_session_timeout
922
+ raise_sessions_not_supported
923
+ end
924
+ end
925
+ end
926
+ rescue Error::NoServerAvailable
927
+ # We haven't been able to contact any servers - use last known
928
+ # value for session support.
929
+ @state_change_lock.synchronize do
930
+ @sdam_flow_lock.synchronize do
931
+ @update_lock.synchronize do
932
+ unless @sessions_supported
933
+ raise_sessions_not_supported
934
+ end
935
+ end
936
+ end
458
937
  end
459
938
  end
460
939
  end
461
940
 
462
- def addresses_list
463
- @update_lock.synchronize do
464
- @addresses.reduce([]) do |addresses, address|
465
- addresses << address
941
+ private
942
+
943
+ # @api private
944
+ def start_stop_srv_monitor
945
+ # SRV URI is either always given or not for a given cluster, if one
946
+ # wasn't given we shouldn't ever have an SRV monitor to manage.
947
+ return unless options[:srv_uri]
948
+
949
+ if topology.is_a?(Topology::Sharded) || topology.is_a?(Topology::Unknown)
950
+ # Start SRV monitor
951
+ @srv_monitor_lock.synchronize do
952
+ unless @srv_monitor
953
+ monitor_options = Utils.shallow_symbolize_keys(options.merge(
954
+ timeout: options[:connect_timeout] || Server::CONNECT_TIMEOUT))
955
+ @srv_monitor = _srv_monitor = Srv::Monitor.new(self, **monitor_options)
956
+ finalizer = lambda do
957
+ _srv_monitor.stop!
958
+ end
959
+ ObjectSpace.define_finalizer(self, finalizer)
960
+ end
961
+ @srv_monitor.run!
466
962
  end
963
+ else
964
+ # Stop SRV monitor if running. This path is taken when the client
965
+ # is given an SRV URI to a standalone/replica set; when the topology
966
+ # is discovered, since it's not a sharded cluster, the SRV monitor
967
+ # needs to be stopped.
968
+ @srv_monitor_lock.synchronize do
969
+ if @srv_monitor
970
+ @srv_monitor.stop!
971
+ end
972
+ end
973
+ end
974
+ end
975
+
976
+ def raise_sessions_not_supported
977
+ # Intentionally using @servers instead of +servers+ here because we
978
+ # are supposed to be already holding the @update_lock and we cannot
979
+ # recursively acquire it again.
980
+ offending_servers = @servers.select do |server|
981
+ server.description.data_bearing? && server.logical_session_timeout.nil?
982
+ end
983
+ reason = if offending_servers.empty?
984
+ "There are no known data bearing servers (current seeds: #{@servers.map(&:address).map(&:seed).join(', ')})"
985
+ else
986
+ "The following servers have null logical session timeout: #{offending_servers.map(&:address).map(&:seed).join(', ')}"
467
987
  end
988
+ msg = "The deployment that the driver is connected to does not support sessions: #{reason}"
989
+ raise Error::SessionsNotSupported, msg
468
990
  end
469
991
  end
470
992
  end
993
+
994
+ require 'mongo/cluster/sdam_flow'