mongo 2.19.2 → 2.20.0

data/spec/spec_tests/data/connection_string/valid-options.yml

@@ -15,3 +15,16 @@ tests:
             db: "admin"
         options:
             authmechanism: "MONGODB-CR"
+    -
+        description: "Missing delimiting slash between hosts and options"
+        uri: "mongodb://example.com?tls=true"
+        valid: true
+        warning: false
+        hosts:
+            -
+                type: "hostname"
+                host: "example.com"
+                port: ~
+        auth: ~
+        options:
+              tls: true

data/spec/spec_tests/data/crud_unified/find-test-all-options.yml

@@ -0,0 +1,348 @@
+description: "find options"
+
+schemaVersion: "1.0"
+runOnRequirements:
+  - serverless: 'forbid'
+
+
+createEntities:
+  - client:
+      id: &client0 client0
+      observeEvents: [ commandStartedEvent ]
+  - database:
+      id: &database0 database0
+      client: *client0
+      databaseName: &database0Name find-tests
+  - collection:
+      id: &collection0 collection0
+      database: *database0
+      collectionName: &collection0Name coll0
+
+tests:
+  - description: "sort"
+    operations:
+      - name: find
+        arguments:
+          filter: &filter { _name: "John" }
+          sort: &sort { _id: 1 }
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                sort: *sort
+              commandName: find
+
+  - description: "projection"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          projection: &projection { _id: 1 }
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                projection: *projection
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "hint"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          hint: &hint { _id: 1 }
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                hint: *hint
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "skip"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          skip: &skip 10
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                skip: *skip
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "limit"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          limit: &limit 10
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                limit: *limit
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "batchSize"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          batchSize: &batchSize 10
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                batchSize: *batchSize
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "comment"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          comment: &comment 'comment'
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                comment: *comment
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "maxTimeMS"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          maxTimeMS: &maxTimeMS 1000
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                maxTimeMS: *maxTimeMS
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "max"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          max: &max { _id: 10 }
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                max: *max
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "min"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          hint: { name: 1 }
+          min: &min { name: 'John' }
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                min: *min
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "returnKey"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          returnKey: &returnKey false
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                returnKey: *returnKey
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "showRecordId"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          showRecordId: &showRecordId false
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                showRecordId: *showRecordId
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "oplogReplay"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          oplogReplay: &oplogReplay false
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                oplogReplay: *oplogReplay
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "noCursorTimeout"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          noCursorTimeout: &noCursorTimeout false
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                noCursorTimeout: *noCursorTimeout
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "allowPartialResults"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          allowPartialResults: &allowPartialResults false
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                allowPartialResults: *allowPartialResults
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "collation"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          collation: &collation { locale: "en" }
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                collation: *collation
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "allowDiskUse"
+    runOnRequirements:
+      - minServerVersion: 4.4
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          allowDiskUse: &allowDiskUse true
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                allowDiskUse: *allowDiskUse
+              commandName: find
+              databaseName: *database0Name
+
+  - description: "let"
+    runOnRequirements:
+      - minServerVersion: "5.0"
+    operations:
+      - name: find
+        arguments:
+          filter: *filter
+          let: &let { name: "Mary" }
+        object: *collection0
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collection0Name
+                filter: *filter
+                let: *let
+              commandName: find
+              databaseName: *database0Name

data/spec/spec_tests/data/index_management/createSearchIndex.yml

@@ -0,0 +1,64 @@
+description: "createSearchIndex"
+schemaVersion: "1.4"
+createEntities:
+  - client:
+      id: &client0 client0
+      useMultipleMongoses: false
+      observeEvents:
+        - commandStartedEvent
+  - database:
+      id: &database0 database0
+      client: *client0
+      databaseName: *database0
+  - collection:
+      id: &collection0 collection0
+      database: *database0
+      collectionName: *collection0
+
+runOnRequirements:
+  - minServerVersion: "7.0.0"
+    topologies: [ replicaset, load-balanced, sharded ]
+    serverless: forbid
+
+tests:
+  - description: "no name provided for an index definition"
+    operations:
+      - name: createSearchIndex
+        object: *collection0
+        arguments:
+          model: { definition: &definition { mappings: { dynamic: true } } }
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                createSearchIndexes: *collection0
+                indexes: [ { definition: *definition } ]
+                $db: *database0
+
+  - description: "name provided for an index definition"
+    operations:
+      - name: createSearchIndex
+        object: *collection0
+        arguments: 
+          model: { definition: &definition { mappings: { dynamic: true } } , name: 'test index' }
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                createSearchIndexes: *collection0
+                indexes: [ { definition: *definition, name: 'test index' } ]
+                $db: *database0

data/spec/spec_tests/data/index_management/createSearchIndexes.yml

@@ -0,0 +1,86 @@
+description: "createSearchIndexes"
+schemaVersion: "1.4"
+createEntities:
+  - client:
+      id: &client0 client0
+      useMultipleMongoses: false
+      observeEvents:
+        - commandStartedEvent
+  - database:
+      id: &database0 database0
+      client: *client0
+      databaseName: *database0
+  - collection:
+      id: &collection0 collection0
+      database: *database0
+      collectionName: *collection0
+
+runOnRequirements:
+  - minServerVersion: "7.0.0"
+    topologies: [ replicaset, load-balanced, sharded ]
+    serverless: forbid
+
+tests:
+  - description: "empty index definition array"
+    operations:
+      - name: createSearchIndexes
+        object: *collection0
+        arguments: 
+          models: []
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                createSearchIndexes: *collection0
+                indexes: []
+                $db: *database0
+
+
+  - description: "no name provided for an index definition"
+    operations:
+      - name: createSearchIndexes
+        object: *collection0
+        arguments:
+          models: [ { definition: &definition { mappings: { dynamic: true } } } ]
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                createSearchIndexes: *collection0
+                indexes: [ { definition: *definition } ]
+                $db: *database0
+
+  - description: "name provided for an index definition"
+    operations:
+      - name: createSearchIndexes
+        object: *collection0
+        arguments: 
+          models: [ { definition: &definition { mappings: { dynamic: true } } , name: 'test index' } ]
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                createSearchIndexes: *collection0
+                indexes: [ { definition: *definition, name: 'test index' } ]
+                $db: *database0

data/spec/spec_tests/data/index_management/dropSearchIndex.yml

@@ -0,0 +1,43 @@
+description: "dropSearchIndex"
+schemaVersion: "1.4"
+createEntities:
+  - client:
+      id: &client0 client0
+      useMultipleMongoses: false
+      observeEvents:
+        - commandStartedEvent
+  - database:
+      id: &database0 database0
+      client: *client0
+      databaseName: *database0
+  - collection:
+      id: &collection0 collection0
+      database: *database0
+      collectionName: *collection0
+
+runOnRequirements:
+  - minServerVersion: "7.0.0"
+    topologies: [ replicaset, load-balanced, sharded ]
+    serverless: forbid
+
+tests:
+  - description: "sends the correct command"
+    operations:
+      - name: dropSearchIndex
+        object: *collection0
+        arguments:
+          name: &indexName 'test index'
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                dropSearchIndex: *collection0
+                name: *indexName
+                $db: *database0

data/spec/spec_tests/data/index_management/listSearchIndexes.yml

@@ -0,0 +1,91 @@
+description: "listSearchIndexes"
+schemaVersion: "1.4"
+createEntities:
+  - client:
+      id: &client0 client0
+      useMultipleMongoses: false
+      observeEvents:
+        - commandStartedEvent
+  - database:
+      id: &database0 database0
+      client: *client0
+      databaseName: *database0
+  - collection:
+      id: &collection0 collection0
+      database: *database0
+      collectionName: *collection0
+
+runOnRequirements:
+  - minServerVersion: "7.0.0"
+    topologies: [ replicaset, load-balanced, sharded ]
+    serverless: forbid
+
+tests:
+  - description: "when no name is provided, it does not populate the filter"
+    skipReason: https://jira.mongodb.org/browse/DRIVERS-2794
+    operations:
+      - name: listSearchIndexes
+        object: *collection0
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                aggregate: *collection0
+                pipeline:
+                  - $listSearchIndexes: {}
+
+  - description: "when a name is provided, it is present in the filter"
+    skipReason: https://jira.mongodb.org/browse/DRIVERS-2794
+    operations:
+      - name: listSearchIndexes
+        object: *collection0
+        arguments:
+          name: &indexName "test index"
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                aggregate: *collection0
+                pipeline:
+                  - $listSearchIndexes: { name: *indexName }
+                $db: *database0
+
+  - description: aggregation cursor options are supported
+    skipReason: https://jira.mongodb.org/browse/DRIVERS-2794
+    operations:
+      - name: listSearchIndexes
+        object: *collection0
+        arguments:
+          name: &indexName "test index"
+          aggregationOptions:
+            batchSize: 10
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                aggregate: *collection0
+                cursor: { batchSize: 10 }
+                pipeline:
+                  - $listSearchIndexes: { name: *indexName }
+                $db: *database0

data/spec/spec_tests/data/index_management/updateSearchIndex.yml

@@ -0,0 +1,46 @@
+description: "updateSearchIndex"
+schemaVersion: "1.4"
+createEntities:
+  - client:
+      id: &client0 client0
+      useMultipleMongoses: false
+      observeEvents:
+        - commandStartedEvent
+  - database:
+      id: &database0 database0
+      client: *client0
+      databaseName: *database0
+  - collection:
+      id: &collection0 collection0
+      database: *database0
+      collectionName: *collection0
+
+runOnRequirements:
+  - minServerVersion: "7.0.0"
+    topologies: [ replicaset, load-balanced, sharded ]
+    serverless: forbid
+
+tests:
+  - description: "sends the correct command"
+    operations:
+      - name: updateSearchIndex
+        object: *collection0
+        arguments:
+          name: &indexName 'test index'
+          definition: &definition {}
+        expectError:
+          # This test always errors in a non-Atlas environment.  The test functions as a unit test  by asserting
+          # that the driver constructs and sends the correct command.
+          # The expected error message was changed in SERVER-83003. Check for the substring "Atlas" shared by both error messages.
+          isError: true
+          errorContains: Atlas
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                updateSearchIndex: *collection0
+                name: *indexName
+                definition: *definition
+                $db: *database0
+