-
Notifications
You must be signed in to change notification settings - Fork 1.8k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore: sync read-write-concern spec tests
- Loading branch information
Showing
17 changed files
with
2,106 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,80 @@ | ||
| ======================= | ||
| Connection String Tests | ||
| ======================= | ||
|
|
||
| The YAML and JSON files in this directory tree are platform-independent tests | ||
| that drivers can use to prove their conformance to the Read and Write Concern | ||
| specification. | ||
|
|
||
| Version | ||
| ------- | ||
|
|
||
| Files in the "specifications" repository have no version scheme. They are not | ||
| tied to a MongoDB server version. | ||
|
|
||
| Format | ||
| ------ | ||
|
|
||
| Connection String | ||
| ~~~~~~~~~~~~~~~~~ | ||
|
|
||
| These tests are designed to exercise the connection string parsing related | ||
| to read concern and write concern. | ||
|
|
||
| Each YAML file contains an object with a single ``tests`` key. This key is an | ||
| array of test case objects, each of which have the following keys: | ||
|
|
||
| - ``description``: A string describing the test. | ||
| - ``uri``: A string containing the URI to be parsed. | ||
| - ``valid:``: a boolean indicating if parsing the uri should result in an error. | ||
| - ``writeConcern:`` A document indicating the expected write concern. | ||
| - ``readConcern:`` A document indicating the expected read concern. | ||
|
|
||
| If a test case includes a null value for one of these keys, or if the key is missing, | ||
| no assertion is necessary. This both simplifies parsing of the test files and allows flexibility | ||
| for drivers that might substitute default values *during* parsing. | ||
|
|
||
| Document | ||
| ~~~~~~~~ | ||
|
|
||
| These tests are designed to ensure compliance with the spec in relation to what should be | ||
| sent to the server. | ||
|
|
||
| Each YAML file contains an object with a single ``tests`` key. This key is an | ||
| array of test case objects, each of which have the following keys: | ||
|
|
||
| - ``description``: A string describing the test. | ||
| - ``valid:``: a boolean indicating if the write concern created from the document is valid. | ||
| - ``writeConcern:`` A document indicating the write concern to use. | ||
| - ``writeConcernDocument:`` A document indicating the write concern to be sent to the server. | ||
| - ``readConcern:`` A document indicating the read concern to use. | ||
| - ``readConcernDocument:`` A document indicating the read concern to be sent to the server. | ||
| - ``isServerDefault:`` Indicates whether the read or write concern is considered the server's default. | ||
| - ``isAcknowledged:`` Indicates if the write concern should be considered acknowledged. | ||
|
|
||
| Operation | ||
| ~~~~~~~~~ | ||
|
|
||
| These tests check that the default write concern is omitted in operations. | ||
|
|
||
| The spec test format is an extension of `transactions spec tests <https://github.com/mongodb/specifications/blob/master/source/transactions/tests/README.rst>`_ with the following additions: | ||
|
|
||
| - ``writeConcern`` in the ``databaseOptions`` or ``collectionOptions`` may be an empty document to indicate a `server default write concern <https://github.com/mongodb/specifications/blob/master/source/read-write-concern/read-write-concern.rst#servers-default-writeconcern>`_. For example, in libmongoc: | ||
|
|
||
| .. code:: c | ||
| /* Create a default write concern, and set on a collection object. */ | ||
| mongoc_write_concern_t *wc = mongoc_write_concern_new (); | ||
| mongoc_collection_set_write_concern (collection, wc); | ||
| If the driver has no way to explicitly set a default write concern on a database or collection, ignore the empty ``writeConcern`` document and continue with the test. | ||
| - The operations ``createIndex``, ``dropIndex`` are introduced. | ||
|
|
||
|
|
||
| Use as unit tests | ||
| ================= | ||
|
|
||
| Testing whether a URI is valid or not should simply be a matter of checking | ||
| whether URI parsing raises an error or exception. | ||
| Testing for emitted warnings may require more legwork (e.g. configuring a log | ||
| handler and watching for output). |
47 changes: 47 additions & 0 deletions
47
test/spec/read-write-concern/connection-string/read-concern.json
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,47 @@ | ||
| { | ||
| "tests": [ | ||
| { | ||
| "description": "Default", | ||
| "uri": "mongodb://localhost/", | ||
| "valid": true, | ||
| "warning": false, | ||
| "readConcern": {} | ||
| }, | ||
| { | ||
| "description": "local specified", | ||
| "uri": "mongodb://localhost/?readConcernLevel=local", | ||
| "valid": true, | ||
| "warning": false, | ||
| "readConcern": { | ||
| "level": "local" | ||
| } | ||
| }, | ||
| { | ||
| "description": "majority specified", | ||
| "uri": "mongodb://localhost/?readConcernLevel=majority", | ||
| "valid": true, | ||
| "warning": false, | ||
| "readConcern": { | ||
| "level": "majority" | ||
| } | ||
| }, | ||
| { | ||
| "description": "linearizable specified", | ||
| "uri": "mongodb://localhost/?readConcernLevel=linearizable", | ||
| "valid": true, | ||
| "warning": false, | ||
| "readConcern": { | ||
| "level": "linearizable" | ||
| } | ||
| }, | ||
| { | ||
| "description": "available specified", | ||
| "uri": "mongodb://localhost/?readConcernLevel=available", | ||
| "valid": true, | ||
| "warning": false, | ||
| "readConcern": { | ||
| "level": "available" | ||
| } | ||
| } | ||
| ] | ||
| } |
32 changes: 32 additions & 0 deletions
32
test/spec/read-write-concern/connection-string/read-concern.yml
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| tests: | ||
| - | ||
| description: "Default" | ||
| uri: "mongodb://localhost/" | ||
| valid: true | ||
| warning: false | ||
| readConcern: { } | ||
| - | ||
| description: "local specified" | ||
| uri: "mongodb://localhost/?readConcernLevel=local" | ||
| valid: true | ||
| warning: false | ||
| readConcern: { level: "local" } | ||
| - | ||
| description: "majority specified" | ||
| uri: "mongodb://localhost/?readConcernLevel=majority" | ||
| valid: true | ||
| warning: false | ||
| readConcern: { level: "majority" } | ||
| - | ||
| description: "linearizable specified" | ||
| uri: "mongodb://localhost/?readConcernLevel=linearizable" | ||
| valid: true | ||
| warning: false | ||
| readConcern: { level: "linearizable" } | ||
| - | ||
| description: "available specified" | ||
| uri: "mongodb://localhost/?readConcernLevel=available" | ||
| valid: true | ||
| warning: false | ||
| readConcern: { level: "available" } | ||
|
|
118 changes: 118 additions & 0 deletions
118
test/spec/read-write-concern/connection-string/write-concern.json
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,118 @@ | ||
| { | ||
| "tests": [ | ||
| { | ||
| "description": "Default", | ||
| "uri": "mongodb://localhost/", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": {} | ||
| }, | ||
| { | ||
| "description": "w as a valid number", | ||
| "uri": "mongodb://localhost/?w=1", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "w": 1 | ||
| } | ||
| }, | ||
| { | ||
| "description": "w as an invalid number", | ||
| "uri": "mongodb://localhost/?w=-2", | ||
| "valid": false, | ||
| "warning": null | ||
| }, | ||
| { | ||
| "description": "w as a string", | ||
| "uri": "mongodb://localhost/?w=majority", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "w": "majority" | ||
| } | ||
| }, | ||
| { | ||
| "description": "wtimeoutMS as a valid number", | ||
| "uri": "mongodb://localhost/?wtimeoutMS=500", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "wtimeoutMS": 500 | ||
| } | ||
| }, | ||
| { | ||
| "description": "wtimeoutMS as an invalid number", | ||
| "uri": "mongodb://localhost/?wtimeoutMS=-500", | ||
| "valid": false, | ||
| "warning": null | ||
| }, | ||
| { | ||
| "description": "journal as false", | ||
| "uri": "mongodb://localhost/?journal=false", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "journal": false | ||
| } | ||
| }, | ||
| { | ||
| "description": "journal as true", | ||
| "uri": "mongodb://localhost/?journal=true", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "journal": true | ||
| } | ||
| }, | ||
| { | ||
| "description": "All options combined", | ||
| "uri": "mongodb://localhost/?w=3&wtimeoutMS=500&journal=true", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "w": 3, | ||
| "wtimeoutMS": 500, | ||
| "journal": true | ||
| } | ||
| }, | ||
| { | ||
| "description": "Unacknowledged with w", | ||
| "uri": "mongodb://localhost/?w=0", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "w": 0 | ||
| } | ||
| }, | ||
| { | ||
| "description": "Unacknowledged with w and journal", | ||
| "uri": "mongodb://localhost/?w=0&journal=false", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "w": 0, | ||
| "journal": false | ||
| } | ||
| }, | ||
| { | ||
| "description": "Unacknowledged with w and wtimeoutMS", | ||
| "uri": "mongodb://localhost/?w=0&wtimeoutMS=500", | ||
| "valid": true, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "w": 0, | ||
| "wtimeoutMS": 500 | ||
| } | ||
| }, | ||
| { | ||
| "description": "Acknowledged with w as 0 and journal true", | ||
| "uri": "mongodb://localhost/?w=0&journal=true", | ||
| "valid": false, | ||
| "warning": false, | ||
| "writeConcern": { | ||
| "w": 0, | ||
| "journal": true | ||
| } | ||
| } | ||
| ] | ||
| } |
77 changes: 77 additions & 0 deletions
77
test/spec/read-write-concern/connection-string/write-concern.yml
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,77 @@ | ||
| tests: | ||
| - | ||
| description: "Default" | ||
| uri: "mongodb://localhost/" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { } | ||
| - | ||
| description: "w as a valid number" | ||
| uri: "mongodb://localhost/?w=1" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { w: 1 } | ||
| - | ||
| description: "w as an invalid number" | ||
| uri: "mongodb://localhost/?w=-2" | ||
| valid: false | ||
| warning: ~ | ||
| - | ||
| description: "w as a string" | ||
| uri: "mongodb://localhost/?w=majority" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { w: "majority" } | ||
| - | ||
| description: "wtimeoutMS as a valid number" | ||
| uri: "mongodb://localhost/?wtimeoutMS=500" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { wtimeoutMS: 500 } | ||
| - | ||
| description: "wtimeoutMS as an invalid number" | ||
| uri: "mongodb://localhost/?wtimeoutMS=-500" | ||
| valid: false | ||
| warning: ~ | ||
| - | ||
| description: "journal as false" | ||
| uri: "mongodb://localhost/?journal=false" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { journal: false } | ||
| - | ||
| description: "journal as true" | ||
| uri: "mongodb://localhost/?journal=true" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { journal: true } | ||
| - | ||
| description: "All options combined" | ||
| uri: "mongodb://localhost/?w=3&wtimeoutMS=500&journal=true" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { w: 3, wtimeoutMS: 500, journal: true } | ||
| - | ||
| description: "Unacknowledged with w" | ||
| uri: "mongodb://localhost/?w=0" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { w: 0 } | ||
| - | ||
| description: "Unacknowledged with w and journal" | ||
| uri: "mongodb://localhost/?w=0&journal=false" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { w: 0, journal: false } | ||
| - | ||
| description: "Unacknowledged with w and wtimeoutMS" | ||
| uri: "mongodb://localhost/?w=0&wtimeoutMS=500" | ||
| valid: true | ||
| warning: false | ||
| writeConcern: { w: 0, wtimeoutMS: 500 } | ||
| - | ||
| description: "Acknowledged with w as 0 and journal true" | ||
| uri: "mongodb://localhost/?w=0&journal=true" | ||
| valid: false | ||
| warning: false | ||
| writeConcern: { w: 0, journal: true } |
Oops, something went wrong.