mongo 2.14.1 → 2.15.0.alpha

data/spec/spec_tests/data/versioned_api/crud-api-version-1.yml

@@ -0,0 +1,409 @@
+description: "CRUD Api Version 1"
+
+schemaVersion: "1.1"
+
+runOnRequirements:
+  - minServerVersion: "4.9"
+
+createEntities:
+  - client:
+      id: &client client
+      observeEvents:
+        - commandStartedEvent
+      serverApi:
+        version: "1"
+        # Deprecation errors is set to true to ensure that drivers don't use any
+        # deprecated server API in their logic.
+        deprecationErrors: true
+  - database:
+      id: &database database
+      client: *client
+      databaseName: &databaseName versioned-api-tests
+  - database:
+      id: &adminDatabase adminDatabase
+      client: *client
+      databaseName: &adminDatabaseName admin
+  - collection:
+      id: &collection collection
+      database: *database
+      collectionName: &collectionName test
+
+_yamlAnchors:
+  versions:
+    - &expectedApiVersion
+      apiVersion: "1"
+      apiStrict: { $$unsetOrMatches: false }
+      apiDeprecationErrors: true
+
+initialData:
+  - collectionName: *collectionName
+    databaseName: *databaseName
+    documents:
+      - { _id: 1, x: 11 }
+      - { _id: 2, x: 22 }
+      - { _id: 3, x: 33 }
+      - { _id: 4, x: 44 }
+      - { _id: 5, x: 55 }
+
+tests:
+  - description: "aggregate on collection appends declared API version"
+    operations:
+      - name: aggregate
+        object: *collection
+        arguments:
+          pipeline: &pipeline
+            - $sort: { x : 1 }
+            - $match: { _id: { $gt: 1 } }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                aggregate: *collectionName
+                pipeline: *pipeline
+                <<: *expectedApiVersion
+
+  - description: "aggregate on database appends declared API version"
+    operations:
+      - name: aggregate
+        object: *adminDatabase
+        arguments:
+          pipeline: &pipeline
+            - $listLocalSessions: {}
+            - $limit: 1
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                aggregate: 1
+                pipeline: *pipeline
+                <<: *expectedApiVersion
+
+  - description: "bulkWrite appends declared API version"
+    operations:
+      - name: bulkWrite
+        object: *collection
+        arguments:
+          requests:
+            - insertOne:
+                document: { _id: 6, x: 66 }
+            - updateOne:
+                filter: { _id: 2 }
+                update: { $inc: { x: 1 } }
+            - deleteMany:
+                filter: { x: { $nin: [ 24, 34 ] } }
+            - updateMany:
+                filter: { _id: { $gt: 1 } }
+                update: { $inc: { x: 1 } }
+            - deleteOne:
+                filter: { _id: 7 }
+            - replaceOne:
+                filter: { _id: 4 }
+                replacement: { _id: 4, x: 44 }
+                upsert: true
+          ordered: true
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                insert: *collectionName
+                documents:
+                  - { _id: 6, x: 66 }
+                <<: *expectedApiVersion
+          - commandStartedEvent:
+              command:
+                update: *collectionName
+                updates:
+                  - q: { _id: 2 }
+                    u: { $inc: { x: 1 } }
+                    multi: { $$unsetOrMatches: false }
+                    upsert: { $$unsetOrMatches: false }
+                <<: *expectedApiVersion
+          - commandStartedEvent:
+              command:
+                delete: *collectionName
+                deletes:
+                  - { q: { x: { $nin: [ 24, 34 ] } }, limit: 0 }
+                <<: *expectedApiVersion
+          - commandStartedEvent:
+              command:
+                update: *collectionName
+                updates:
+                  - q: { _id: { $gt: 1 } }
+                    u: { $inc: { x: 1 } }
+                    multi: true
+                    upsert: { $$unsetOrMatches: false }
+                <<: *expectedApiVersion
+          - commandStartedEvent:
+              command:
+                delete: *collectionName
+                deletes:
+                  - { q: { _id: 7 }, limit: 1 }
+                <<: *expectedApiVersion
+          - commandStartedEvent:
+              command:
+                update: *collectionName
+                updates:
+                  - q: { _id: 4 }
+                    u: { _id: 4, x: 44 }
+                    multi: { $$unsetOrMatches: false }
+                    upsert: true
+                <<: *expectedApiVersion
+
+  - description: "countDocuments appends declared API version"
+    operations:
+      - name: countDocuments
+        object: *collection
+        arguments:
+          filter: &filter
+            x : { $gt: 11 }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                aggregate: *collectionName
+                pipeline:
+                  - { $match: *filter }
+                  - { $group: { _id: 1, n: { $sum: 1 } } }
+                <<: *expectedApiVersion
+
+  - description: "deleteMany appends declared API version"
+    operations:
+      - name: deleteMany
+        object: *collection
+        arguments:
+          filter: { x: { $nin: [ 24, 34 ] } }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                delete: *collectionName
+                deletes:
+                  - { q: { x: { $nin: [ 24, 34 ] } }, limit: 0 }
+                <<: *expectedApiVersion
+
+  - description: "deleteOne appends declared API version"
+    operations:
+      - name: deleteOne
+        object: *collection
+        arguments:
+          filter: { _id: 7 }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                delete: *collectionName
+                deletes:
+                  - { q: { _id: 7 }, limit: 1 }
+                <<: *expectedApiVersion
+
+  - description: "distinct appends declared API version"
+    operations:
+      - name: distinct
+        object: *collection
+        arguments:
+          fieldName: x
+          filter: {}
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                distinct: *collectionName
+                key: x
+                <<: *expectedApiVersion
+
+  - description: "estimatedDocumentCount appends declared API version on 4.9.0 or greater"
+    operations:
+      - name: estimatedDocumentCount
+        object: *collection
+        arguments: {}
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                aggregate: *collectionName
+                pipeline: &pipeline
+                  - $collStats: { count: {} }
+                  - $group: { _id: 1, n: { $sum: $count }}
+                <<: *expectedApiVersion
+
+  - description: "find command with declared API version appends to the command, but getMore does not"
+    operations:
+      - name: find
+        object: *collection
+        arguments:
+          filter: {}
+          sort: { _id: 1 }
+          batchSize: 3
+        expectResult:
+          - { _id: 1, x: 11 }
+          - { _id: 2, x: 22 }
+          - { _id: 3, x: 33 }
+          - { _id: 4, x: 44 }
+          - { _id: 5, x: 55 }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                find: *collectionName
+                <<: *expectedApiVersion
+          - commandStartedEvent:
+              command:
+                getMore: { $$type: [ int, long ] }
+                apiVersion: { $$exists: false }
+                apiStrict: { $$exists: false }
+                apiDeprecationErrors: { $$exists: false }
+
+  - description: "findOneAndDelete appends declared API version"
+    operations:
+      - name: findOneAndDelete
+        object: *collection
+        arguments:
+          filter: &filter { _id: 1 }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                findAndModify: *collectionName
+                query: *filter
+                remove: true
+                <<: *expectedApiVersion
+
+  - description: "findOneAndReplace appends declared API version"
+    operations:
+      - name: findOneAndReplace
+        object: *collection
+        arguments:
+          filter: &filter { _id: 1 }
+          replacement: &replacement { x: 33 }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                findAndModify: *collectionName
+                query: *filter
+                update: *replacement
+                <<: *expectedApiVersion
+
+  - description: "findOneAndUpdate appends declared API version"
+    operations:
+      - name: findOneAndUpdate
+        object: collection
+        arguments:
+          filter: &filter { _id: 1 }
+          update: &update { $inc: { x: 1 } }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                findAndModify: *collectionName
+                query: *filter
+                update: *update
+                <<: *expectedApiVersion
+
+  - description: "insertMany appends declared API version"
+    operations:
+      - name: insertMany
+        object: *collection
+        arguments:
+          documents:
+            - { _id: 6, x: 66 }
+            - { _id: 7, x: 77 }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                insert: *collectionName
+                documents:
+                  - { _id: 6, x: 66 }
+                  - { _id: 7, x: 77 }
+                <<: *expectedApiVersion
+
+  - description: "insertOne appends declared API version"
+    operations:
+      - name: insertOne
+        object: *collection
+        arguments:
+          document: { _id: 6, x: 66 }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                insert: *collectionName
+                documents:
+                  - { _id: 6, x: 66 }
+                <<: *expectedApiVersion
+
+  - description: "replaceOne appends declared API version"
+    operations:
+      - name: replaceOne
+        object: *collection
+        arguments:
+          filter: { _id: 4 }
+          replacement: { _id: 4, x: 44 }
+          upsert: true
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                update: *collectionName
+                updates:
+                  - q: { _id: 4 }
+                    u: { _id: 4, x: 44 }
+                    multi: { $$unsetOrMatches: false }
+                    upsert: true
+                <<: *expectedApiVersion
+
+  - description: "updateMany appends declared API version"
+    operations:
+      - name: updateMany
+        object: *collection
+        arguments:
+          filter: { _id: { $gt: 1 } }
+          update: { $inc: { x: 1 } }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                update: *collectionName
+                updates:
+                  - q: { _id: { $gt: 1 } }
+                    u: { $inc: { x: 1 } }
+                    multi: true
+                    upsert: { $$unsetOrMatches: false }
+                <<: *expectedApiVersion
+
+  - description: "updateOne appends declared API version"
+    operations:
+      - name: updateOne
+        object: *collection
+        arguments:
+          filter: { _id: 2 }
+          update: { $inc: { x: 1 } }
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                update: *collectionName
+                updates:
+                  - q: { _id: 2 }
+                    u: { $inc: { x: 1 } }
+                    multi: { $$unsetOrMatches: false }
+                    upsert: { $$unsetOrMatches: false }
+                <<: *expectedApiVersion

data/spec/spec_tests/data/versioned_api/runcommand-helper-no-api-version-declared.yml

@@ -0,0 +1,67 @@
+description: "RunCommand helper: No API version declared"
+
+schemaVersion: "1.1"
+
+runOnRequirements:
+  - minServerVersion: "4.9"
+    serverParameters:
+      requireApiVersion: false
+
+createEntities:
+  - client:
+      id: &client client
+      observeEvents:
+        - commandStartedEvent
+  - database:
+      id: &database database
+      client: *client
+      databaseName: &databaseName versioned-api-tests
+
+tests:
+  - description: "runCommand does not inspect or change the command document"
+    operations:
+      - name: runCommand
+        object: *database
+        arguments:
+          commandName: ping
+          command:
+            ping: 1
+            apiVersion: "server_will_never_support_this_api_version"
+        expectError:
+          isError: true
+          isClientError: false
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                ping: 1
+                apiVersion: "server_will_never_support_this_api_version"
+                apiStrict: { $$exists: false }
+                apiDeprecationErrors: { $$exists: false }
+              commandName: ping
+              databaseName: *databaseName
+
+  - description: "runCommand does not prevent sending invalid API version declarations"
+    operations:
+      - name: runCommand
+        object: *database
+        arguments:
+          commandName: ping
+          command:
+            ping: 1
+            apiStrict: true
+        expectError:
+          isError: true
+          isClientError: false
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                ping: 1
+                apiVersion: { $$exists: false }
+                apiStrict: true
+                apiDeprecationErrors: { $$exists: false }
+              commandName: ping
+              databaseName: *databaseName

data/spec/spec_tests/data/versioned_api/test-commands-deprecation-errors.yml

@@ -0,0 +1,47 @@
+description: "Test commands: deprecation errors"
+
+schemaVersion: "1.1"
+
+runOnRequirements:
+  - minServerVersion: "4.9"
+    serverParameters:
+      enableTestCommands: true
+      acceptAPIVersion2: true
+      requireApiVersion: false
+
+createEntities:
+  - client:
+      id: &client client
+      observeEvents:
+        - commandStartedEvent
+      # This client is configured without a declared API version, as we cannot
+      # declare an unknown API version.
+  - database:
+      id: &database database
+      client: *client
+      databaseName: &databaseName versioned-api-tests
+
+tests:
+  - description: "Running a command that is deprecated raises a deprecation error"
+    operations:
+      - name: runCommand
+        object: *database
+        arguments:
+          commandName: testDeprecationInVersion2
+          command:
+            testDeprecationInVersion2: 1
+            apiVersion: "2"
+            apiDeprecationErrors: true
+        expectError:
+          isError: true
+          errorContains: "command testDeprecationInVersion2 is deprecated in API Version 2"
+          errorCodeName: "APIDeprecationError"
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                testDeprecationInVersion2: 1
+                apiVersion: "2"
+                apiStrict: { $$exists: false }
+                apiDeprecationErrors: true

data/spec/spec_tests/data/versioned_api/test-commands-strict-mode.yml

@@ -0,0 +1,44 @@
+description: "Test commands: strict mode"
+
+schemaVersion: "1.1"
+
+runOnRequirements:
+  - minServerVersion: "4.9"
+    serverParameters:
+      enableTestCommands: true
+
+createEntities:
+  - client:
+      id: &client client
+      observeEvents:
+        - commandStartedEvent
+      serverApi:
+        version: "1"
+        strict: true
+  - database:
+      id: &database database
+      client: *client
+      databaseName: &databaseName versioned-api-tests
+
+tests:
+  - description: "Running a command that is not part of the versioned API results in an error"
+    operations:
+      - name: runCommand
+        object: *database
+        arguments:
+          commandName: testVersion2
+          command:
+            testVersion2: 1
+        expectError:
+          isError: true
+          errorContains: "command testVersion2 is not in API Version 1"
+          errorCodeName: "APIStrictError"
+    expectEvents:
+      - client: *client
+        events:
+          - commandStartedEvent:
+              command:
+                testVersion2: 1
+                apiVersion: "1"
+                apiStrict: true
+                apiDeprecationErrors: { $$unsetOrMatches: false }