pekko-http-json

Releases are pushed to Maven Central. Snapshots are pushed to Sonatype. See below.

This is a fork of akka-http-json. Thanks to Heiko Seeberger and all those who contributed to akka-http-json.

pekko-http-json provides JSON (un)marshalling support for Apache Pekko HTTP via the following JSON libraries:

• Argonaut
• avro4s
• circe
• Fory JSON via fory-json-scala
• Jackson via Scala Module by default
  • pekko-http-jackson v2.0.x supports Jackson 2.14
  • pekko-http-jackson v2.1.x supports Jackson 2.15
    • Jackson 2.15 users should read about StreamReadConstraints
    • pekko-http-jackson uses the default constraints but you can override them by overriding the configs in reference.conf
    • you can override the configs by adding an application.conf file to your project (Lightbend Config docs)
  • pekko-http-jackson v2.3.x supports Jackson 2.16
    • pekko-http-jackson uses the default Jackson constraints (including some new to Jackson 2.16) but you can override them by overriding the configs in reference.conf
  • pekko-http-jackson v2.5.x supports Jackson 2.17
• Json4s
• jsoniter-scala
• ninny
• Play JSON
• uPickle
• zio-json

Installation

The artifacts are published to Maven Central.

libraryDependencies ++= Seq(
  "com.github.pjfanning" %% "pekko-http-circe" % PekkoHttpJsonVersion,
  ...
)

Snapshots

Check https://central.sonatype.com/service/rest/repository/browse/maven-snapshots/com/github/pjfanning/ to find the version numbers for the latest pekko-http-json snapshots.

resolvers += "Sonatype Central Snapshots" at "https://central.sonatype.com/repository/maven-snapshots/"
// older snapshots on OSSRH
//resolvers ++= Resolver.sonatypeOssRepos("snapshots")

Usage

Use respective support trait or object, e.g. ArgonautSupport, FailFastCirceSupport, etc. into your Pekko HTTP code which is supposed to (un)marshal from/to JSON. Don't forget to provide the type class instances for the respective JSON libraries, if needed.

Contribution policy

Contributions via GitHub pull requests are gladly accepted from their original author. Along with any pull requests, please state that the contribution is your original work and that you license the work to the project under the project's open source license. Whether or not you state this explicitly, by submitting any copyrighted material via pull request, email, or other means you agree to license the material under the project's open source license and warrant that you have the legal authority to do so.

License

This code is open source software licensed under the Apache 2.0 License.