Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dispatch/reboot
Scala wrapper for the Java AsyncHttpClient.
https://github.com/dispatch/reboot
ahc async dispatch http-client http-library scala scala-library
Last synced: 11 days ago
JSON representation
Scala wrapper for the Java AsyncHttpClient.
- Host: GitHub
- URL: https://github.com/dispatch/reboot
- Owner: dispatch
- License: lgpl-3.0
- Created: 2011-12-11T22:33:52.000Z (almost 13 years ago)
- Default Branch: main
- Last Pushed: 2024-08-25T03:41:28.000Z (3 months ago)
- Last Synced: 2024-08-26T02:47:29.434Z (3 months ago)
- Topics: ahc, async, dispatch, http-client, http-library, scala, scala-library
- Language: Scala
- Homepage: https://dispatchhttp.org
- Size: 1.81 MB
- Stars: 424
- Watchers: 34
- Forks: 105
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Dispatch Reboot
---------------
[](https://travis-ci.org/dispatch/reboot)
Dispatch reboot is a rewrite of the Dispatch library for HTTP interaction in Scala, using
[async-http-client][async], commonly called AHC, as its underlying transport. For more info, see the
[Dispatch documentation site][docs].
Minimum requirements:
* Java >= 11 (tested against 11, 17, and 21)
* Scala 2.13 or >= 3.3.3
[docs]: https://dispatch.github.io/reboot/Dispatch.html
[async]: https://github.com/AsyncHttpClient/async-http-client
## 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`:
```scala
libraryDependencies += "org.dispatchhttp" %% "dispatch-core" % "2.0.0"
```
If Gradle is more your style, you could also use this style:
```scala
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:
```scala
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][contributing] for information on how to contribute and get help
with Dispatch.
[contributing]: https://github.com/dispatch/reboot/blob/master/CONTRIBUTING.md