Play Json tools

1. play-json-tools — Set of implicit Play-JSON Format helper classes. Example in FlatFormatSpec
2. play-json-generic — provides Format derivation for enum like adt's (sealed trait/case objects'). Examples in EnumerationDerivalSpec
3. play-json-jsoniter — provides the fastest way to convert an instance of play.api.libs.json.JsValue to byte array and read it back. Numbers are written exactly as play-json's JVM serializer writes them, which means a BigDecimal keeps its value but not necessarily its scale: 100.00 is written as 100. A number that could not be read back under the configured parse limits is rejected with a JsonWriterException instead of being written.
4. play-json-circe — provides conversions to/from circe codecs to ease transitions from one library to another. Examples in CirceToPlayConversionsSpec and PlayToCirceConversionsSpec.

All modules are available for 2.13 and 3.

Setup

Replace <version> with the latest release, which the version badge above links to.

addSbtPlugin("com.evolution" % "sbt-artifactory-plugin" % "0.0.2")

libraryDependencies += "com.evolution" %% "play-json-tools"    % "<version>"
libraryDependencies += "com.evolution" %% "play-json-generic"  % "<version>"
libraryDependencies += "com.evolution" %% "play-json-jsoniter" % "<version>"
libraryDependencies += "com.evolution" %% "play-json-circe"    % "<version>"

Release process

The release process is based on Git tags and makes use of evolution-gaming/scala-github-actions which uses sbt-dynver to automatically obtain the version from the latest Git tag. The flow is defined in .github/workflows/release.yml.
A typical release process is as follows:

1. Create and push a new Git tag. The version should be in the format vX.Y.Z (example: v4.1.0). Example: git tag v4.1.0 && git push origin v4.1.0
2. On success, a new GitHub release is automatically created with a calculated diff and auto-generated release notes. You can see it on Releases page, change the description if needed
3. On failure, the tag is deleted from the remote repository. Please note that your local tag isn't deleted, so if the failure is recoverable then you can delete the local tag and try again (an example of unrecoverable failure is successfully publishing only a few of the artifacts to Artifactory which means a new attempt would fail since Artifactory doesn't allow overwriting its contents)