Patched 1.5.0

New Features

• Added the paste operation, which can be used to insert data from code-defined 'data sources'. This is sort of like the write-only counterpart to custom tests.

Other Changes

• @Deprecated annotations now have the since field populated.
• Some things that previously lacked javadocs now have them. (With the exception of the patcher stuff — I plan to just get rid of that in 2.0.0, since I don't think it's adding much.)

Patched 1.4.0

New Features

• Added the include operation, which can be used to include the contents of a patch file in another as though they were copied verbatim into it. See the documentation for examples.

Path Changes

• Paths containing segments like "03" are now correctly treated as strings and not numbers.
• Paths containing invalid escape sequences like "~8" are now errors.
• Paths that end with an incomplete escape sequence like "/test/~" are now errors.

Other Changes

• Patches with null paths no longer throw exceptions when serialized.
• Many parts of Patched now have @since tags.

Patched 1.3.0

Changes

• Patches can now change the root element.
• There is now an option to enable "strict" handling of the add operation, wherein adding elements at positive out-of-bounds indices will throw.
• Renamed sbExtensions to testExtensions. Bouncers exist (for now) to keep binary/source compatibility.
• @Nullable annotations have been added where applicable. (I may have missed a few spots though.)

Patched 1.2.1

Changes

• Improved an error message.

Bug Fixes

• Fixed audits not adding comments to added objects and arrays.

Known Issues

• Removed elements in arrays show up as comments at the top of the array, instead of where they were in the array. It's still better than no comment, but it is misleading.

Patched 1.2.0

Additions

• Patch audits: a way to track what changes patches have made to a file. Its main focus is formatting "pretty" json with comments indicating these changes. If you're curious as to what they look like, there are audit files in most of the tests.

Changes

• [Breaking Change] The patch generator has been removed. See the relevant commit for an explanation.
• [Breaking Change] The patch() overload in JsonPatch is now final, to prevent accidentally overriding the wrong one.
• [Breaking Change] Patches and PatchUtil are now final with private constructors.

Bug Fixes

• Fixed NPEs when testing for an element inside an element that doesn't exist, e.g. /foo/bar where foo doesn't exist.
• Fixed an NPE caused by patches that lack an op attribute when a default operation is not specified.

Patched 1.1.1

Hotfix for custom test conditions being ignored if the path attribute is not present.

Patched 1.1.0

A new "custom test condition" feature has been added to the Patched extension.
This feature is described more thoroughly in the README.

Patched 1.0.3

The CLI has been improved significantly: it supports patching single files now, the help text has been expanded to actually be somewhat helpful, and there are now real tests for it so I can be sure it's actually working.

Patched 1.0.2

The initial build of the library.