sttp alternatives and similar packages
Based on the "HTTP" category.
Alternatively, view sttp alternatives based on common mentions on social networks and blogs.
-
Spray
A suite of scala libraries for building and consuming RESTful web services on top of Akka: lightweight, asynchronous, non-blocking, actor-based, testable -
-
-
-
-
requests-scala
A Scala port of the popular Python Requests HTTP client: flexible, intuitive, and straightforward to use. -
-
Newman
DISCONTINUED. A REST DSL that tries to take the best from Dispatch, Finagle and Apache HttpClient. See here for rationale. -
-
-
Tubesocks
A comfortable and fashionable way to have bi-directional conversations with modern web servers. -
jefe
Manages installation, updating, downloading, launching, error reporting, and more for your application. -
WorkOS - The modern identity platform for B2B SaaS
Do you think we are missing an alternative of sttp or a related project?
README
The Scala HTTP client that you always wanted!
Welcome!
sttp client is an open-source library which provides a clean, programmer-friendly API to describe HTTP requests and how to handle responses. Requests are sent using one of the backends, which wrap other Scala or Java HTTP client implementations. The backends can integrate with a variety of Scala stacks, providing both synchronous and asynchronous, procedural and functional interfaces.
Backend implementations include ones based on akka-http, http4s, OkHttp, and HTTP clients which ship with Java. They integrate with Akka, Monix, fs2, cats-effect, scalaz and ZIO. Supported Scala versions include 2.11, 2.12, 2.13 and 3, Scala.JS and Scala Native.
Here's a quick example of sttp client in action:
import sttp.client3._
val sort: Option[String] = None
val query = "http language:scala"
// the `query` parameter is automatically url-encoded
// `sort` is removed, as the value is not defined
val request = basicRequest.get(uri"https://api.github.com/search/repositories?q=$query&sort=$sort")
val backend = HttpClientSyncBackend()
val response = request.send(backend)
// response.header(...): Option[String]
println(response.header("Content-Length"))
// response.body: by default read into an Either[String, String] to indicate failure or success
println(response.body)
Documentation
sttp (v3) documentation is available at sttp.softwaremill.com.
sttp (v2) documentation is available at sttp.softwaremill.com/en/v2.
sttp (v1) documentation is available at sttp.softwaremill.com/en/v1.
scaladoc is available at https://www.javadoc.io
Quickstart with Ammonite
If you are an Ammonite user, you can quickly start experimenting with sttp by copy-pasting the following:
import $ivy.`com.softwaremill.sttp.client3::core:3.8.5`
import sttp.client3.quick._
quickRequest.get(uri"http://httpbin.org/ip").send(backend)
This brings in the sttp API and a synchronous backend instance.
Quickstart with sbt
Add the following dependency:
"com.softwaremill.sttp.client3" %% "core" % "3.8.5"
Then, import:
import sttp.client3._
Type basicRequest. and see where your IDE’s auto-complete gets you!
Other sttp projects
sttp is a family of Scala HTTP-related projects, and currently includes:
- sttp client: this project
- sttp tapir: Typed API descRiptions
- sttp model: simple HTTP model classes (used by client & tapir)
- sttp shared: shared web socket, FP abstractions, capabilities and streaming code.
- sttp apispec: OpenAPI, AsyncAPI and JSON Schema models.
Contributing
If you have a question, or hit a problem, feel free to ask on our gitter channel!
Or, if you encounter a bug, something is unclear in the code or documentation, don’t hesitate and open an issue on GitHub.
We are also always looking for contributions and new ideas, so if you’d like to get into the project, check out the open issues, or post your own suggestions!
Note that running the default test task will run the tests using both the JVM and JS backends, and is likely to run out of memory.
If you'd like to run the tests using only the JVM backend, execute: sbt rootJVM/test.
Modifying documentation
The documentation is typechecked using mdoc. The sources for the documentation exist in docs. Don't modify the generated documentation in generated-docs, as these files will get overwritten!
When generating documentation, it's best to set the version to the current one, so that the generated doc files don't include modifications with the current snapshot version.
That is, in sbt run: set version := "3.8.5", before running mdoc in docs.
Testing the Scala.JS backend
In order to run tests against JS backend you will need to install Google Chrome.
Building & testing the scala-native backend
By default, sttp-native will not be included in the aggregate build of the root project. To include it, define the STTP_NATIVE environmental variable before running sbt, e.g.:
STTP_NATIVE=1 sbt
You might need to install some additional libraries, see the scala native documentation site. On macos, you might additionally need:
ln -s /usr/local/opt/openssl/lib/libcrypto.dylib /usr/local/lib/
ln -s /usr/local/opt/openssl/lib/libssl.dylib /usr/local/lib/
Commercial Support
We offer commercial support for sttp and related technologies, as well as development services. Contact us to learn more about our offer!
Copyright
Copyright (C) 2017-2022 SoftwareMill https://softwaremill.com.