cJSON/tests/json-patch-tests/README.md

2.3 KiB

JSON Patch Tests

These are test cases for implementations of IETF JSON Patch (RFC6902).

Some implementations can be found at jsonpatch.com.

Test Format

Each test file is a JSON document that contains an array of test records. A test record is an object with the following members:

  • doc: The JSON document to test against
  • patch: The patch(es) to apply
  • expected: The expected resulting document, OR
  • error: A string describing an expected error
  • comment: A string describing the test
  • disabled: True if the test should be skipped

All fields except 'doc' and 'patch' are optional. Test records consisting only of a comment are also OK.

Files

  • tests.json: the main test file
  • spec_tests.json: tests from the RFC6902 spec

Writing Tests

All tests should have a descriptive comment. Tests should be as simple as possible - just what's required to test a specific piece of behavior. If you want to test interacting behaviors, create tests for each behavior as well as the interaction.

If an 'error' member is specified, the error text should describe the error the implementation should raise - not what's being tested. Implementation error strings will vary, but the suggested error should be easily matched to the implementation error string. Try to avoid creating error tests that might pass because an incorrect error was reported.

Please feel free to contribute!

Credits

The seed test set was adapted from Byron Ruth's jsonpatch-js and extended by Mike McCabe.

License

Copyright 2014 The Authors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.