Back to directory
dispatch avatar

reboot

Scala wrapper for the Java AsyncHttpClient.. Read more below about its uses, features, and usage.

Clone repository

git clone https://github.com/dispatch/reboot.git

427

Stars

103

Forks

32

Watchers

LGPL-3.0

License

Dispatch Reboot

Build Status

Dispatch reboot is a rewrite of the Dispatch library for HTTP interaction in Scala, using async-http-client, commonly called AHC, as its underlying transport. For more info, see the Dispatch documentation site.

Minimum requirements:

  • Java >= 11 (tested against 11, 17, and 21)
  • Scala 2.13 or >= 3.3.3

Getting Dispatch

Stable releases of Dispatch are published to Maven Central. As such, you can pull in the current stable release by simply adding a library dependency to your project for the correct version.

To get the latest stable release, 2.0.0, simply add the following to your build.sbt:

libraryDependencies += "org.dispatchhttp" %% "dispatch-core" % "2.0.0"

If Gradle is more your style, you could also use this style:

implementation "org.dispatchhttp:dispatch-core_2.13:2.0.0"

Snapshot releases

We irregularly release snapshots to Sonatype snapshots. To use it you'll need to add the snapshots repository to your project and pull the relevant snapshot:

resolvers +=
  "Sonatype OSS Snapshots" at "https://oss.sonatype.org/content/repositories/snapshots"

libraryDependencies += "org.dispatchhttp" %% "dispatch-core" % "2.1.0-SNAPSHOT"

Versioning and Support

Dispatch version numbers loosely follow SemVer. The version number format is:

[major].[minor].[patch]

A distinct (major, minor) combination is called a "release series" or "series" for our purposes.

The next feature release development happens on master.

The following chart outlines what versions of Dispatch support what versions of AHC and Scala and their current support status:

Version AHC Version Scala Versions Support Branch
0.10.0 1.7.11 2.9.3,2.10 None
0.11.2 1.8.10 2.9.3,2.10,2.11 None
0.11.4 1.9.40 2.10,2.11 None
0.12.3 1.9.40 2.11,2.12 None
0.13.3 2.0.38 2.11,2.12 None
0.14.1 2.1.2 2.11,2.12 None
1.0.3 2.5.4 2.11,2.12 None 1.0.x
1.1.3 2.10.4 2.12,2.13 None 1.1.x
1.2.0 2.10.4 2.12,2.13 Critical 1.2.x
2.0.0-SNAPSHOT 3.0.0 2.13,3.3.3 Full 2.0.x
2.1.0-SNAPSHOT 3.0.0 2.13,3.3.3 Development main

Because the AsyncHttpClient does not adhere to semantic versioning, and its versions can increment quite quickly at times, beginning with 0.14 Dispatch will only use the latest (major, minor) AHC version that's available at the time its being developed. You may not be able to find a Dispatch version for every version of AHC if AHC went through a quick release clip.

Upon request, we may release a patch version of Dispatch with a newer version of AHC if the new version is binary compatible with the version that series was originally released with.

Getting Help and Contributing

Please see our Contributing Guide for information on how to contribute and get help with Dispatch.

Releases

Aug 25, 2024

Dispatch v2.0.0

Download .zip

Breaking Changes

Scala 2.11 and 2.12 support is dropped. We now build for Scala 2.13 and Scala 3.3.3! Support for Java version less than 11 is dropped. Major Async HTTP Client Version Bump to 3.0

Pu...

Jan 11, 2020

Dispatch v1.2.0

Download .zip

The maintainers of and contributors to Dispatch are pleased to announce the release of Dispatch v1.2.0. This is a feature release. Changes

It is now possible to add query parameters to URLs without v...

Dec 27, 2019

Dispatch 1.1.3

Download .zip

The maintainers of and contributors to Dispatch are pleased to announce the release of Dispatch v1.1.3. This is a small bugfix release. Changes

Fixes issues encoding UTF-16 characters (e.g. emoji) in...

Dec 27, 2019

Dispatch 1.0.3

Download .zip

The maintainers of and contributors to Dispatch are pleased to announce the release of Dispatch v1.0.3. This is a small bugfix release. Changes

Fixes issues encoding UTF-16 characters (e.g. emoji) in...

Oct 23, 2019

Dispatch v1.1.2

Download .zip

The maintainers of and contributors to Dispatch are pleased to announce the release of Dispatch v1.1.2. This is a small bugfix release. Changes

Updates lift-json to 3.4.0 and enables the liftjson mod...