RubyGems - mongo - Versions diffs - 2.5.3 → 2.6.0 - Mend

mongo 2.5.3 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (394) hide show

checksums.yaml +5 -5
checksums.yaml.gz.sig +0 -0
data.tar.gz.sig +0 -0
data/LICENSE +1 -1
data/README.md +3 -2
data/lib/mongo.rb +2 -2
data/lib/mongo/address.rb +10 -2
data/lib/mongo/address/ipv4.rb +1 -1
data/lib/mongo/address/ipv6.rb +26 -5
data/lib/mongo/address/unix.rb +1 -1
data/lib/mongo/auth.rb +10 -3
data/lib/mongo/auth/cr.rb +4 -1
data/lib/mongo/auth/cr/conversation.rb +4 -1
data/lib/mongo/auth/ldap.rb +1 -1
data/lib/mongo/auth/ldap/conversation.rb +1 -1
data/lib/mongo/auth/roles.rb +1 -1
data/lib/mongo/auth/scram.rb +24 -7
data/lib/mongo/auth/scram/conversation.rb +52 -19
data/lib/mongo/auth/stringprep.rb +114 -0
data/lib/mongo/auth/stringprep/profiles/sasl.rb +73 -0
data/lib/mongo/auth/stringprep/tables.rb +3232 -0
data/lib/mongo/auth/stringprep/unicode_normalize/normalize.rb +174 -0
data/lib/mongo/auth/stringprep/unicode_normalize/tables.rb +1170 -0
data/lib/mongo/auth/user.rb +14 -3
data/lib/mongo/auth/user/view.rb +1 -1
data/lib/mongo/auth/x509.rb +1 -1
data/lib/mongo/auth/x509/conversation.rb +1 -1
data/lib/mongo/bson.rb +1 -1
data/lib/mongo/bulk_write.rb +8 -8
data/lib/mongo/bulk_write/combineable.rb +1 -1
data/lib/mongo/bulk_write/ordered_combiner.rb +1 -1
data/lib/mongo/bulk_write/result.rb +1 -1
data/lib/mongo/bulk_write/result_combiner.rb +4 -4
data/lib/mongo/bulk_write/transformable.rb +1 -1
data/lib/mongo/bulk_write/unordered_combiner.rb +1 -1
data/lib/mongo/bulk_write/validatable.rb +1 -1
data/lib/mongo/client.rb +115 -24
data/lib/mongo/cluster.rb +17 -10
data/lib/mongo/cluster/app_metadata.rb +7 -1
data/lib/mongo/cluster/periodic_executor.rb +1 -1
data/lib/mongo/cluster/reapers/socket_reaper.rb +1 -1
data/lib/mongo/cluster/topology.rb +12 -2
data/lib/mongo/cluster/topology/replica_set.rb +9 -1
data/lib/mongo/cluster/topology/sharded.rb +1 -1
data/lib/mongo/cluster/topology/single.rb +1 -1
data/lib/mongo/cluster/topology/unknown.rb +1 -1
data/lib/mongo/collection.rb +75 -19
data/lib/mongo/collection/view.rb +1 -1
data/lib/mongo/collection/view/aggregation.rb +1 -1
data/lib/mongo/collection/view/builder.rb +1 -1
data/lib/mongo/collection/view/builder/aggregation.rb +3 -3
data/lib/mongo/collection/view/builder/find_command.rb +1 -1
data/lib/mongo/collection/view/builder/flags.rb +1 -1
data/lib/mongo/collection/view/builder/map_reduce.rb +1 -1
data/lib/mongo/collection/view/builder/modifiers.rb +1 -1
data/lib/mongo/collection/view/builder/op_query.rb +1 -1
data/lib/mongo/collection/view/change_stream.rb +193 -17
data/lib/mongo/collection/view/change_stream/retryable.rb +3 -20
data/lib/mongo/collection/view/explainable.rb +1 -1
data/lib/mongo/collection/view/immutable.rb +1 -1
data/lib/mongo/collection/view/iterable.rb +2 -2
data/lib/mongo/collection/view/map_reduce.rb +1 -1
data/lib/mongo/collection/view/readable.rb +108 -29
data/lib/mongo/collection/view/writable.rb +3 -3
data/lib/mongo/cursor.rb +44 -4
data/lib/mongo/cursor/builder.rb +1 -1
data/lib/mongo/cursor/builder/get_more_command.rb +1 -1
data/lib/mongo/cursor/builder/kill_cursors_command.rb +1 -1
data/lib/mongo/cursor/builder/op_get_more.rb +1 -1
data/lib/mongo/cursor/builder/op_kill_cursors.rb +1 -1
data/lib/mongo/database.rb +46 -3
data/lib/mongo/database/view.rb +11 -11
data/lib/mongo/dbref.rb +1 -1
data/lib/mongo/error.rb +57 -1
data/lib/mongo/error/bulk_write_error.rb +2 -2
data/lib/mongo/error/change_stream_resumable.rb +37 -0
data/lib/mongo/error/closed_stream.rb +1 -1
data/lib/mongo/error/extra_file_chunk.rb +1 -1
data/lib/mongo/error/failed_stringprep_validation.rb +38 -0
data/lib/mongo/error/file_not_found.rb +1 -1
data/lib/mongo/error/insufficient_iteration_count.rb +38 -0
data/lib/mongo/error/invalid_application_name.rb +1 -1
data/lib/mongo/error/invalid_bulk_operation.rb +1 -1
data/lib/mongo/error/invalid_bulk_operation_type.rb +1 -1
data/lib/mongo/error/invalid_collection_name.rb +1 -1
data/lib/mongo/error/invalid_database_name.rb +1 -1
data/lib/mongo/error/invalid_document.rb +1 -1
data/lib/mongo/error/invalid_file.rb +1 -1
data/lib/mongo/error/invalid_file_revision.rb +1 -1
data/lib/mongo/error/invalid_min_pool_size.rb +1 -1
data/lib/mongo/error/invalid_nonce.rb +1 -1
data/lib/mongo/error/invalid_read_option.rb +35 -0
data/lib/mongo/error/invalid_replacement_document.rb +1 -1
data/lib/mongo/error/invalid_server_preference.rb +1 -1
data/lib/mongo/error/invalid_session.rb +1 -1
data/lib/mongo/error/invalid_signature.rb +1 -1
data/lib/mongo/error/invalid_transaction_operation.rb +82 -0
data/lib/mongo/error/invalid_txt_record.rb +1 -1
data/lib/mongo/error/invalid_update_document.rb +1 -1
data/lib/mongo/error/invalid_uri.rb +1 -1
data/lib/mongo/error/invalid_write_concern.rb +1 -1
data/lib/mongo/error/max_bson_size.rb +1 -1
data/lib/mongo/error/max_message_size.rb +1 -1
data/lib/mongo/error/mismatched_domain.rb +1 -1
data/lib/mongo/error/missing_file_chunk.rb +1 -1
data/lib/mongo/error/missing_resume_token.rb +1 -1
data/lib/mongo/error/multi_index_drop.rb +1 -1
data/lib/mongo/error/need_primary_server.rb +1 -1
data/lib/mongo/error/no_server_available.rb +1 -1
data/lib/mongo/error/no_srv_records.rb +1 -1
data/lib/mongo/error/operation_failure.rb +108 -14
data/lib/mongo/error/parser.rb +50 -1
data/lib/mongo/error/socket_error.rb +5 -2
data/lib/mongo/error/socket_timeout_error.rb +5 -2
data/lib/mongo/error/unchangeable_collection_option.rb +1 -1
data/lib/mongo/error/unexpected_chunk_length.rb +1 -1
data/lib/mongo/error/unexpected_response.rb +1 -1
data/lib/mongo/error/unknown_payload_type.rb +1 -1
data/lib/mongo/error/unsupported_array_filters.rb +1 -1
data/lib/mongo/error/unsupported_collation.rb +1 -1
data/lib/mongo/error/unsupported_features.rb +1 -1
data/lib/mongo/error/unsupported_message_type.rb +1 -1
data/lib/mongo/error/write_retryable.rb +27 -0
data/lib/mongo/event.rb +10 -9
data/lib/mongo/event/base.rb +33 -0
data/lib/mongo/event/description_changed.rb +2 -2
data/lib/mongo/event/listeners.rb +1 -1
data/lib/mongo/event/member_discovered.rb +4 -2
data/lib/mongo/event/primary_elected.rb +2 -2
data/lib/mongo/event/publisher.rb +1 -1
data/lib/mongo/event/standalone_discovered.rb +2 -2
data/lib/mongo/event/subscriber.rb +1 -1
data/lib/mongo/grid.rb +1 -1
data/lib/mongo/grid/file.rb +1 -1
data/lib/mongo/grid/file/chunk.rb +3 -3
data/lib/mongo/grid/file/info.rb +26 -3
data/lib/mongo/grid/fs_bucket.rb +1 -1
data/lib/mongo/grid/stream.rb +1 -1
data/lib/mongo/grid/stream/read.rb +1 -1
data/lib/mongo/grid/stream/write.rb +1 -1
data/lib/mongo/index.rb +1 -1
data/lib/mongo/index/view.rb +1 -1
data/lib/mongo/loggable.rb +1 -1
data/lib/mongo/logger.rb +1 -1
data/lib/mongo/monitoring.rb +99 -62
data/lib/mongo/monitoring/command_log_subscriber.rb +2 -2
data/lib/mongo/monitoring/event.rb +2 -1
data/lib/mongo/monitoring/event/command_failed.rb +19 -6
data/lib/mongo/monitoring/event/command_started.rb +14 -3
data/lib/mongo/monitoring/event/command_succeeded.rb +5 -3
data/lib/mongo/monitoring/event/secure.rb +1 -1
data/lib/mongo/monitoring/event/server_closed.rb +2 -2
data/lib/mongo/monitoring/event/server_description_changed.rb +2 -2
data/lib/mongo/monitoring/event/server_opening.rb +11 -2
data/lib/mongo/monitoring/event/topology_changed.rb +13 -2
data/lib/mongo/monitoring/event/topology_closed.rb +2 -2
data/lib/mongo/monitoring/event/topology_opening.rb +11 -2
data/lib/mongo/monitoring/publishable.rb +10 -6
data/lib/mongo/monitoring/sdam_log_subscriber.rb +1 -1
data/lib/mongo/monitoring/server_closed_log_subscriber.rb +1 -1
data/lib/mongo/monitoring/server_description_changed_log_subscriber.rb +1 -1
data/lib/mongo/monitoring/server_opening_log_subscriber.rb +1 -1
data/lib/mongo/monitoring/topology_changed_log_subscriber.rb +1 -1
data/lib/mongo/monitoring/topology_opening_log_subscriber.rb +1 -1
data/lib/mongo/operation/aggregate/op_msg.rb +3 -0
data/lib/mongo/operation/create/op_msg.rb +9 -0
data/lib/mongo/operation/create_index/op_msg.rb +9 -0
data/lib/mongo/operation/create_user/command.rb +1 -1
data/lib/mongo/operation/create_user/op_msg.rb +10 -1
data/lib/mongo/operation/delete/op_msg.rb +3 -0
data/lib/mongo/operation/distinct/op_msg.rb +9 -0
data/lib/mongo/operation/drop/op_msg.rb +9 -0
data/lib/mongo/operation/drop_database/op_msg.rb +9 -0
data/lib/mongo/operation/drop_index/op_msg.rb +9 -0
data/lib/mongo/operation/explain/op_msg.rb +3 -0
data/lib/mongo/operation/find/op_msg.rb +3 -0
data/lib/mongo/operation/get_more.rb +1 -1
data/lib/mongo/operation/get_more/command.rb +1 -1
data/lib/mongo/operation/get_more/legacy.rb +1 -1
data/lib/mongo/operation/get_more/op_msg.rb +3 -0
data/lib/mongo/operation/indexes/op_msg.rb +3 -0
data/lib/mongo/operation/indexes/result.rb +1 -1
data/lib/mongo/operation/insert/bulk_result.rb +32 -2
data/lib/mongo/operation/insert/op_msg.rb +3 -0
data/lib/mongo/operation/insert/result.rb +1 -1
data/lib/mongo/operation/kill_cursors/op_msg.rb +9 -0
data/lib/mongo/operation/list_collections/op_msg.rb +3 -0
data/lib/mongo/operation/list_collections/result.rb +5 -1
data/lib/mongo/operation/map_reduce/op_msg.rb +3 -0
data/lib/mongo/operation/map_reduce/result.rb +1 -1
data/lib/mongo/operation/parallel_scan/op_msg.rb +3 -0
data/lib/mongo/operation/remove_user/op_msg.rb +9 -0
data/lib/mongo/operation/result.rb +27 -14
data/lib/mongo/operation/shared/executable.rb +1 -0
data/lib/mongo/operation/shared/sessions_supported.rb +78 -7
data/lib/mongo/operation/shared/specifiable.rb +18 -2
data/lib/mongo/operation/shared/write_concern_supported.rb +1 -1
data/lib/mongo/operation/update/op_msg.rb +3 -0
data/lib/mongo/operation/update_user/command.rb +1 -1
data/lib/mongo/operation/update_user/op_msg.rb +10 -1
data/lib/mongo/operation/users_info/op_msg.rb +3 -0
data/lib/mongo/options.rb +1 -1
data/lib/mongo/options/mapper.rb +1 -1
data/lib/mongo/options/redacted.rb +1 -1
data/lib/mongo/protocol/bit_vector.rb +1 -1
data/lib/mongo/protocol/compressed.rb +1 -1
data/lib/mongo/protocol/delete.rb +1 -1
data/lib/mongo/protocol/get_more.rb +7 -7
data/lib/mongo/protocol/insert.rb +1 -1
data/lib/mongo/protocol/kill_cursors.rb +1 -1
data/lib/mongo/protocol/message.rb +5 -5
data/lib/mongo/protocol/msg.rb +9 -7
data/lib/mongo/protocol/query.rb +1 -1
data/lib/mongo/protocol/registry.rb +1 -1
data/lib/mongo/protocol/reply.rb +10 -10
data/lib/mongo/protocol/serializers.rb +1 -1
data/lib/mongo/protocol/update.rb +1 -1
data/lib/mongo/retryable.rb +22 -14
data/lib/mongo/server.rb +1 -1
data/lib/mongo/server/connectable.rb +1 -1
data/lib/mongo/server/connection.rb +16 -4
data/lib/mongo/server/connection_pool.rb +1 -1
data/lib/mongo/server/connection_pool/queue.rb +1 -1
data/lib/mongo/server/context.rb +1 -1
data/lib/mongo/server/description.rb +14 -2
data/lib/mongo/server/description/features.rb +10 -9
data/lib/mongo/server/description/inspector.rb +1 -1
data/lib/mongo/server/description/inspector/description_changed.rb +1 -1
data/lib/mongo/server/description/inspector/member_discovered.rb +1 -1
data/lib/mongo/server/description/inspector/primary_elected.rb +1 -1
data/lib/mongo/server/description/inspector/standalone_discovered.rb +1 -1
data/lib/mongo/server/monitor.rb +15 -3
data/lib/mongo/server/monitor/connection.rb +1 -1
data/lib/mongo/server_selector.rb +1 -1
data/lib/mongo/server_selector/nearest.rb +1 -1
data/lib/mongo/server_selector/primary.rb +1 -1
data/lib/mongo/server_selector/primary_preferred.rb +1 -1
data/lib/mongo/server_selector/secondary.rb +1 -1
data/lib/mongo/server_selector/secondary_preferred.rb +1 -1
data/lib/mongo/server_selector/selectable.rb +7 -2
data/lib/mongo/session.rb +389 -12
data/lib/mongo/session/server_session.rb +7 -2
data/lib/mongo/session/session_pool.rb +1 -1
data/lib/mongo/socket.rb +1 -1
data/lib/mongo/socket/ssl.rb +1 -1
data/lib/mongo/socket/tcp.rb +1 -1
data/lib/mongo/socket/unix.rb +1 -1
data/lib/mongo/uri.rb +6 -4
data/lib/mongo/uri/srv_protocol.rb +1 -1
data/lib/mongo/version.rb +2 -2
data/lib/mongo/write_concern.rb +1 -1
data/lib/mongo/write_concern/acknowledged.rb +1 -1
data/lib/mongo/write_concern/normalizable.rb +1 -1
data/lib/mongo/write_concern/unacknowledged.rb +1 -1
data/mongo.gemspec +4 -1
data/spec/atlas/atlas_connectivity_spec.rb +54 -0
data/spec/integration/bulk_insert_spec.rb +78 -0
data/spec/integration/change_stream_spec.rb +365 -0
data/spec/integration/command_monitoring_spec.rb +92 -0
data/spec/lite_spec_helper.rb +63 -0
data/spec/mongo/address/ipv6_spec.rb +29 -1
data/spec/mongo/address_spec.rb +34 -0
data/spec/mongo/auth/scram/conversation_spec.rb +326 -120
data/spec/mongo/auth/scram/negotiation_spec.rb +574 -0
data/spec/mongo/auth/scram_spec.rb +107 -38
data/spec/mongo/auth/stringprep/profiles/sasl_spec.rb +113 -0
data/spec/mongo/auth/stringprep_spec.rb +188 -0
data/spec/mongo/auth/user/view_spec.rb +5 -2
data/spec/mongo/auth/user_spec.rb +1 -1
data/spec/mongo/bulk_write/result_spec.rb +120 -0
data/spec/mongo/bulk_write_spec.rb +42 -2
data/spec/mongo/client_spec.rb +121 -9
data/spec/mongo/cluster/app_metadata_spec.rb +14 -1
data/spec/mongo/cluster/topology_spec.rb +1 -23
data/spec/mongo/collection/view/change_stream_spec.rb +62 -180
data/spec/mongo/collection_spec.rb +45 -12
data/spec/mongo/cursor/builder/get_more_command_spec.rb +7 -7
data/spec/mongo/cursor_spec.rb +2 -2
data/spec/mongo/database_spec.rb +3 -3
data/spec/mongo/docs_examples_spec.rb +194 -0
data/spec/mongo/error/operation_failure_spec.rb +152 -0
data/spec/mongo/error/parser_spec.rb +127 -0
data/spec/mongo/grid/fs_bucket_spec.rb +32 -0
data/spec/mongo/grid/stream/write_spec.rb +40 -1
data/spec/mongo/monitoring/event/command_failed_spec.rb +30 -0
data/spec/mongo/monitoring/event/command_started_spec.rb +26 -4
data/spec/mongo/monitoring/event/command_succeeded_spec.rb +29 -7
data/spec/mongo/monitoring_spec.rb +28 -3
data/spec/mongo/protocol/get_more_spec.rb +2 -2
data/spec/mongo/retryable_spec.rb +252 -34
data/spec/mongo/retryable_writes_spec.rb +468 -544
data/spec/mongo/server/connection_spec.rb +5 -5
data/spec/mongo/server/description_spec.rb +23 -6
data/spec/mongo/session/server_session_spec.rb +2 -2
data/spec/mongo/session/session_pool_spec.rb +2 -2
data/spec/mongo/transactions_examples_spec.rb +227 -0
data/spec/mongo/transactions_spec.rb +44 -0
data/spec/spec_helper.rb +135 -49
data/spec/spec_tests/change_streams_spec.rb +42 -0
data/spec/{mongo → spec_tests}/command_monitoring_spec.rb +8 -2
data/spec/{mongo → spec_tests}/connection_string_spec.rb +1 -1
data/spec/{mongo → spec_tests}/crud_spec.rb +5 -7
data/spec/{mongo → spec_tests}/dns_seedlist_discovery_spec.rb +1 -1
data/spec/{mongo → spec_tests}/gridfs_spec.rb +0 -0
data/spec/{mongo → spec_tests}/max_staleness_spec.rb +0 -0
data/spec/spec_tests/retryable_writes_spec.rb +78 -0
data/spec/{mongo → spec_tests}/sdam_monitoring_spec.rb +4 -3
data/spec/{mongo → spec_tests}/sdam_spec.rb +7 -7
data/spec/{mongo → spec_tests}/server_selection_rtt_spec.rb +0 -0
data/spec/{mongo → spec_tests}/server_selection_spec.rb +0 -0
data/spec/support/authorization.rb +18 -6
data/spec/support/change_streams.rb +265 -0
data/spec/support/change_streams/operation.rb +62 -0
data/spec/support/change_streams_tests/change-streams-errors.yml +53 -0
data/spec/support/change_streams_tests/change-streams.yml +299 -0
data/spec/support/command_monitoring.rb +1 -1
data/spec/support/command_monitoring/bulkWrite.yml +4 -28
data/spec/support/command_monitoring/command.yml +19 -0
data/spec/support/command_monitoring/find.yml +17 -19
data/spec/support/command_monitoring/insertMany.yml +2 -8
data/spec/support/command_monitoring/unacknowledgedBulkWrite.yml +34 -0
data/spec/support/connection_string.rb +1 -1
data/spec/support/constraints.rb +56 -0
data/spec/support/crud.rb +9 -4
data/spec/support/crud/read.rb +24 -3
data/spec/support/crud/write.rb +7 -2
data/spec/support/crud_tests/read/count-collation.yml +12 -2
data/spec/support/crud_tests/read/count.yml +43 -5
data/spec/support/gridfs.rb +1 -1
data/spec/support/primary_socket.rb +21 -0
data/spec/support/retryable_writes_tests/bulkWrite-serverErrors.yml +90 -0
data/spec/support/retryable_writes_tests/bulkWrite.yml +99 -1
data/spec/support/retryable_writes_tests/deleteOne-serverErrors.yml +50 -0
data/spec/support/retryable_writes_tests/deleteOne.yml +10 -1
data/spec/support/retryable_writes_tests/findOneAndDelete-serverErrors.yml +50 -0
data/spec/support/retryable_writes_tests/findOneAndDelete.yml +39 -30
data/spec/support/retryable_writes_tests/findOneAndReplace-serverErrors.yml +54 -0
data/spec/support/retryable_writes_tests/findOneAndReplace.yml +9 -0
data/spec/support/retryable_writes_tests/findOneAndUpdate-serverErrors.yml +54 -0
data/spec/support/retryable_writes_tests/findOneAndUpdate.yml +9 -0
data/spec/support/retryable_writes_tests/insertMany-serverErrors.yml +59 -0
data/spec/support/retryable_writes_tests/insertMany.yml +11 -6
data/spec/support/retryable_writes_tests/insertOne-serverErrors.yml +471 -0
data/spec/support/retryable_writes_tests/insertOne.yml +9 -0
data/spec/support/retryable_writes_tests/replaceOne-serverErrors.yml +58 -0
data/spec/support/retryable_writes_tests/replaceOne.yml +9 -0
data/spec/support/retryable_writes_tests/updateOne-serverErrors.yml +58 -0
data/spec/support/retryable_writes_tests/updateOne.yml +71 -53
data/spec/support/sdam/rs/normalize_case_me.yml +100 -0
data/spec/support/sdam/sharded/compatible.yml +38 -0
data/spec/support/sdam/sharded/mongos_disconnect.yml +9 -3
data/spec/support/sdam/sharded/multiple_mongoses.yml +6 -2
data/spec/support/sdam/sharded/non_mongos_removed.yml +6 -2
data/spec/support/sdam/sharded/too_new.yml +36 -0
data/spec/support/sdam/sharded/too_old.yml +36 -0
data/spec/support/sdam/single/compatible.yml +26 -0
data/spec/support/sdam/single/direct_connection_external_ip.yml +3 -1
data/spec/support/sdam/single/direct_connection_mongos.yml +3 -1
data/spec/support/sdam/single/direct_connection_rsarbiter.yml +3 -1
data/spec/support/sdam/single/direct_connection_rsprimary.yml +3 -1
data/spec/support/sdam/single/direct_connection_rssecondary.yml +3 -1
data/spec/support/sdam/single/direct_connection_slave.yml +3 -1
data/spec/support/sdam/single/direct_connection_standalone.yml +3 -1
data/spec/support/sdam/single/not_ok_response.yml +6 -2
data/spec/support/sdam/single/standalone_removed.yml +3 -1
data/spec/support/sdam/single/too_new.yml +26 -0
data/spec/support/sdam/single/too_old.yml +24 -0
data/spec/support/shared/session.rb +107 -0
data/spec/support/transactions.rb +391 -0
data/spec/support/transactions/operation.rb +373 -0
data/spec/support/transactions_tests/abort.yml +403 -0
data/spec/support/transactions_tests/bulk.yml +267 -0
data/spec/support/transactions_tests/causal-consistency.yml +173 -0
data/spec/support/transactions_tests/commit.yml +593 -0
data/spec/support/transactions_tests/delete.yml +184 -0
data/spec/support/transactions_tests/error-labels.yml +948 -0
data/spec/support/transactions_tests/errors.yml +125 -0
data/spec/support/transactions_tests/findOneAndDelete.yml +126 -0
data/spec/support/transactions_tests/findOneAndReplace.yml +140 -0
data/spec/support/transactions_tests/findOneAndUpdate.yml +228 -0
data/spec/support/transactions_tests/insert.yml +264 -0
data/spec/support/transactions_tests/isolation.yml +125 -0
data/spec/support/transactions_tests/read-pref.yml +340 -0
data/spec/support/transactions_tests/reads.yml +298 -0
data/spec/support/transactions_tests/retryable-abort.yml +1292 -0
data/spec/support/transactions_tests/retryable-commit.yml +1332 -0
data/spec/support/transactions_tests/retryable-writes.yml +208 -0
data/spec/support/transactions_tests/run-command.yml +189 -0
data/spec/support/transactions_tests/transaction-options.yml +877 -0
data/spec/support/transactions_tests/update.yml +246 -0
data/spec/support/transactions_tests/write-concern.yml +236 -0
metadata +494 -359
metadata.gz.sig +0 -0
data/lib/csasl/csasl.bundle +0 -0

data/spec/support/transactions_tests/retryable-writes.yml ADDED

@@ -0,0 +1,208 @@
+database_name: &database_name "ruby-driver"
+collection_name: &collection_name "transactions-tests"
+data: []
+tests:
+  - description: increment txnNumber
+    clientOptions:
+      retryWrites: true
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: commitTransaction
+        object: session0
+      # Retryable write should include the next txnNumber
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 2
+        result:
+          insertedId: 2
+      # Next transaction should include the next txnNumber
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 3
+        result:
+          insertedId: 3
+      - name: abortTransaction
+        object: session0
+      # Retryable write should include the next txnNumber
+      - name: insertMany
+        object: collection
+        arguments:
+          documents:
+            - _id: 4
+            - _id: 5
+          session: session0
+        result:
+          insertedIds: {0: 4, 1: 5}
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+            ordered: true
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction:
+            autocommit:
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 3
+            ordered: true
+            readConcern:
+              afterClusterTime: 42
+            lsid: session0
+            txnNumber:
+              $numberLong: "3"
+            startTransaction: true
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            abortTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "3"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: abortTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 4
+              - _id: 5
+            ordered: true
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "4"
+            startTransaction:
+            autocommit:
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+    outcome:
+      collection:
+        data:
+          - _id: 1
+          - _id: 2
+          - _id: 4
+          - _id: 5
+  - description: writes are not retried
+    clientOptions:
+      retryWrites: true
+    failPoint:
+        configureFailPoint: failCommand
+        mode: { times: 1 }
+        data:
+            failCommands: ["insert"]
+            closeConnection: true
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          errorLabelsContain: ["TransientTransactionError"]
+      - name: abortTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            abortTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: abortTransaction
+          database_name: admin
+    outcome:
+      collection:
+        data: []

data/spec/support/transactions_tests/run-command.yml ADDED

@@ -0,0 +1,189 @@
+database_name: &database_name "ruby-driver"
+collection_name: &collection_name "transactions-tests"
+data: []
+tests:
+  - description: run command with default read preference
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: runCommand
+        object: database
+        command_name: insert
+        arguments:
+          session: session0
+          command:
+            insert: *collection_name
+            documents:
+              - _id : 1
+        result:
+          n: 1
+      - name: commitTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id : 1
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+  - description: run command with secondary read preference in client option and primary read preference in transaction options
+    clientOptions:
+      readPreference: secondary
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readPreference:
+              mode: Primary
+      - name: runCommand
+        object: database
+        command_name: insert
+        arguments:
+          session: session0
+          command:
+            insert: *collection_name
+            documents:
+              - _id : 1
+        result:
+          n: 1
+      - name: commitTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id : 1
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+  - description: run command with explicit primary read preference
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: runCommand
+        object: database
+        command_name: insert
+        arguments:
+          session: session0
+          command:
+            insert: *collection_name
+            documents:
+              - _id : 1
+          readPreference:
+            mode: Primary
+        result:
+          n: 1
+      - name: commitTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id : 1
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+  - description: run command fails with explicit secondary read preference
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: runCommand
+        object: database
+        command_name: find
+        arguments:
+          session: session0
+          command:
+            find: *collection_name
+          readPreference:
+            mode: Secondary
+        result:
+          errorContains: read preference in a transaction must be primary
+  - description: run command fails with secondary read preference from transaction options
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readPreference:
+              mode: Secondary
+      - name: runCommand
+        object: database
+        command_name: find
+        arguments:
+          session: session0
+          command:
+            find: *collection_name
+        result:
+          errorContains: read preference in a transaction must be primary

data/spec/support/transactions_tests/transaction-options.yml ADDED

@@ -0,0 +1,877 @@
+database_name: &database_name "ruby-driver"
+collection_name: &collection_name "transactions-tests"
+data: []
+tests:
+  - description: no transaction options set
+    operations: &commitAbortOperations
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: commitTransaction
+        object: session0
+      # Now test abort.
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 2
+        result:
+          insertedId: 2
+      - name: abortTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              afterClusterTime: 42
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            abortTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: abortTransaction
+          database_name: admin
+    outcome: &outcome
+      collection:
+        data:
+          - _id: 1
+  - description: transaction options inherited from client
+    clientOptions:
+      w: 1
+      readConcernLevel: local
+    operations: *commitAbortOperations
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: local
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: 1
+          command_name: commitTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: local
+              afterClusterTime: 42
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            abortTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: 1
+          command_name: abortTransaction
+          database_name: admin
+    outcome: *outcome
+  - description: transaction options inherited from defaultTransactionOptions
+    sessionOptions:
+      session0:
+        defaultTransactionOptions:
+          readConcern:
+            level: snapshot
+          writeConcern:
+            w: 1
+    operations: *commitAbortOperations
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: snapshot
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: 1
+          command_name: commitTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: snapshot
+              afterClusterTime: 42
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            abortTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: 1
+          command_name: abortTransaction
+          database_name: admin
+    outcome: *outcome
+  - description: startTransaction options override defaults
+    clientOptions:
+      readConcernLevel: local
+      w: 1
+    sessionOptions:
+      session0:
+        defaultTransactionOptions:
+          readConcern:
+            level: majority
+          writeConcern:
+            w: 1
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readConcern:
+              level: snapshot
+            writeConcern:
+              w: majority
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: commitTransaction
+        object: session0
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readConcern:
+              level: snapshot
+            writeConcern:
+              w: majority
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 2
+        result:
+          insertedId: 2
+      - name: abortTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: snapshot
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: majority
+          command_name: commitTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: snapshot
+              afterClusterTime: 42
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            abortTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: majority
+          command_name: abortTransaction
+          database_name: admin
+    outcome: *outcome
+  - description: defaultTransactionOptions override client options
+    clientOptions:
+      readConcernLevel: local
+      w: 1
+    sessionOptions:
+      session0:
+        defaultTransactionOptions:
+          readConcern:
+            level: snapshot
+          writeConcern:
+            w: majority
+    operations: *commitAbortOperations
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: snapshot
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: majority
+          command_name: commitTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: snapshot
+              afterClusterTime: 42
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            abortTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: majority
+          command_name: abortTransaction
+          database_name: admin
+    outcome: *outcome
+  - description: readConcern local in defaultTransactionOptions
+    clientOptions:
+      w: 1
+    sessionOptions:
+      session0:
+        defaultTransactionOptions:
+          readConcern:
+            level: local
+    operations: *commitAbortOperations
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: local
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: 1
+          command_name: commitTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: local
+              afterClusterTime: 42
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            abortTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+              w: 1
+          command_name: abortTransaction
+          database_name: admin
+    outcome: *outcome
+  - description: readConcern local in startTransaction options
+    sessionOptions:
+      session0:
+        defaultTransactionOptions:
+          readConcern:
+            level: majority # Overridden.
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readConcern:
+              level: snapshot
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: commitTransaction
+        object: session0
+      # Now test abort.
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readConcern:
+              level: snapshot
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 2
+        result:
+          insertedId: 2
+      - name: abortTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: snapshot
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 2
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+              level: snapshot
+              afterClusterTime: 42
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            abortTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "2"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: abortTransaction
+          database_name: admin
+    outcome: *outcome
+  - description: client writeConcern ignored for bulk
+    clientOptions:
+      w: majority
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            writeConcern:
+              w: 1
+      - name: bulkWrite
+        object: collection
+        arguments:
+          requests:
+            - name: insertOne
+              arguments:
+                document: {_id: 1}
+          session: session0
+        result:
+          deletedCount: 0
+          insertedIds: {0: 1}
+          matchedCount: 0
+          modifiedCount: 0
+          upsertedCount: 0
+          upsertedIds: {}
+      - name: commitTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            readConcern:
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            # No writeConcern.
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            writeConcern:
+              w: 1
+          command_name: commitTransaction
+          database_name: admin
+    outcome: *outcome
+  - description: readPreference inherited from client
+    clientOptions:
+      readPreference: secondary
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: find
+        object: collection
+        arguments:
+          session: session0
+          filter:
+            _id: 1
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: commitTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+    outcome:
+      collection:
+        data:
+          - _id: 1
+  - description: readPreference inherited from defaultTransactionOptions
+    clientOptions:
+      readPreference: primary
+    sessionOptions:
+      session0:
+        defaultTransactionOptions:
+          readPreference:
+            mode: Secondary
+    operations:
+      - name: startTransaction
+        object: session0
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: find
+        object: collection
+        arguments:
+          session: session0
+          filter:
+            _id: 1
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: commitTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+    outcome:
+      collection:
+        data:
+          - _id: 1
+  - description: startTransaction overrides readPreference
+    clientOptions:
+      readPreference: primary
+    sessionOptions:
+      session0:
+        defaultTransactionOptions:
+          readPreference:
+            mode: Primary
+    operations:
+      - name: startTransaction
+        object: session0
+        arguments:
+          options:
+            readPreference:
+              mode: Secondary
+      - name: insertOne
+        object: collection
+        arguments:
+          session: session0
+          document:
+            _id: 1
+        result:
+          insertedId: 1
+      - name: find
+        object: collection
+        arguments:
+          session: session0
+          filter:
+            _id: 1
+        result:
+          errorContains: read preference in a transaction must be primary
+      - name: commitTransaction
+        object: session0
+    expectations:
+      - command_started_event:
+          command:
+            insert: *collection_name
+            documents:
+              - _id: 1
+            ordered: true
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction: true
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: insert
+          database_name: *database_name
+      - command_started_event:
+          command:
+            commitTransaction: 1
+            lsid: session0
+            txnNumber:
+              $numberLong: "1"
+            startTransaction:
+            autocommit: false
+            readConcern:
+            writeConcern:
+          command_name: commitTransaction
+          database_name: admin
+    outcome:
+      collection:
+        data:
+          - _id: 1