v4.0.0-RC1

This is the release candidate for sttp-client4, a major release of the Scala HTTP client you always wanted!
If no major issues are found, which would impact the public API, a final release of sttp-client 4.0.0 will follow in about a month.

Links

• Documentation, examples
• Migrating from v3 to v4
• Community forum - ask migration questions here
• Issues - report bugs, migration problems here

New features

• simple use-cases, simple types: most of the time you'll work with Request[T], SyncBackend or Backend[F], reducing the number of type parameters involved
• much better error reporting, due to the above simplifications
• better integration with IDE's auto-complete
• clearer types for streaming & WebSocket requests
• ...OrFailed response descriptions
• client-side, configurable compression support
• deeper metrics & logging integration
• improved OpenTelemetry, Prometheus, Logging backends
• reworked documentation with a library of examples
• request body progress callbacks for HttpClient-based backends
• onBodyReceived callback support
• more predictable BackendStub behavior
• a number of quality-of-life improvements, extending scaladocs and making the API more consistent

What’s Changed

• Update client4:caching-backend, ... to 4.0.0-M26 (#2437) @softwaremill-ci

Dependency updates

• Update zio-json to 0.7.15 (#2439) @softwaremill-ci
• Update zio, zio-streams to 2.1.15 (#2438) @softwaremill-ci

v4.0.0-M26

What’s Changed

• Allow more precise definition of response body handling in stubs (#2436) @adamw
• Add onBodyReceived callback, use in logs & metrics (#2427) @adamw
• Update client4:cats, client4:circe, ... to 4.0.0-M25 (#2419) @softwaremill-ci

Dependency updates

• Update zio-json to 0.7.14 (#2433) @softwaremill-ci
• Update mdoc, sbt-mdoc to 2.6.3 (#2431) @softwaremill-ci
• Update zio-json to 0.7.13 (#2430) @softwaremill-ci
• Update zio-json to 0.7.12 (#2429) @softwaremill-ci
• Update zio-json to 0.7.11 (#2428) @softwaremill-ci
• Update zio-json to 0.7.10 (#2426) @softwaremill-ci
• Update scala3-compiler, scala3-library, ... to 3.3.5 (#2425) @softwaremill-ci
• Update jsoniter-scala-core, ... to 2.33.1 (#2423) @softwaremill-ci
• Update zio-json to 0.7.9 (#2424) @softwaremill-ci
• Update zio-json to 0.7.8 (#2422) @softwaremill-ci
• Update zio-json to 0.7.7 (#2421) @softwaremill-ci
• Update zio-json to 0.7.6 (#2420) @softwaremill-ci

v3.10.3

What’s Changed

• Update zio & zio-json (#2435) @mijicd

v4.0.0-M25

What’s Changed

• Update scalafmt-core to 3.8.6 (#2418) @softwaremill-ci
• Fix resource leak for HttpClient-based backends on cancellation (#2413) @adamw
• [minor] Fixed class name in documentation (#2415) @amorfis
• Omit the charset parameter when using the application/json content type (#2412) @adamw
• Make body setting more consistent, always compute the type/length headers if missing (#2411) @adamw
• Add an option to limit the response length for JVM backends (#2410) @adamw
• Request body progress callbacks in HttpClient-based backends (#2408) @adamw
• Update scalafmt-core to 3.8.5 (#2404) @softwaremill-ci
• Add open-telemetry sync tracing backend wrapper; rename otel artifact (#2405) @adamw
• fix warning in build.sbt (#2406) @xuwei-k
• Added a probably missing -ce2 in fs2.md (#2402) @matsluni
• Add request to the functions which calculate OTEL metrics (#2401) @adamw
• Update client4:cats, client4:circe, ... to 4.0.0-M24 (#2400) @softwaremill-ci

Dependency updates

• Update sbt-scalajs, scalajs-compiler, ... to 1.18.2 (#2417) @softwaremill-ci
• Update zio-json to 0.7.5 (#2416) @softwaremill-ci
• Update scala-library to 2.13.16 (#2403) @softwaremill-ci

v4.0.0-M24

What’s Changed

• Examples of uploading and downloading files with os-lib support. (#2399) @adamwkaczmarek
• Simplify ResponseException (#2397) @adamw
• Make TooManyRedirectsException part of the read exception hierarchy (#2396) @adamw
• Caching backend + example (#2390) @adamw
• Improve documentation (#2385) @adamw
• Update logback-classic to 1.5.16 (#2388) @softwaremill-ci
• Update client4:circe, client4:core, ... to 4.0.0-M22 (#2384) @softwaremill-ci

Dependency updates

• Update opentelemetry-api, ... to 1.46.0 (#2395) @softwaremill-ci
• Update sbt-scalajs, scalajs-compiler, ... to 1.18.1 (#2394) @softwaremill-ci
• Update upickle to 4.1.0 (#2393) @softwaremill-ci
• Update pekko-stream to 1.1.3 (#2392) @softwaremill-ci
• Update zio-opentelemetry to 3.1.1 (#2389) @softwaremill-ci
• Update zio-json to 0.7.4 (#2391) @softwaremill-ci
• Update resilience4j-circuitbreaker, ... to 2.3.0 (#2387) @softwaremill-ci
• Update jsoniter-scala-core, ... to 2.33.0 (#2386) @softwaremill-ci

v4.0.0-M22

What’s Changed

• Add request body compression support (#2381) @adamw
• Update logback-classic to 1.5.15 (#2379) @softwaremill-ci
• Make all examples runnable using scala-cli (#2376) @adamw
• Migrate examples & docs to Scala 3 (#2375) @adamw
• Remove async-http-client backends (#2373) @adamw

Dependency updates

• Update sbt, scripted-plugin to 1.10.7 (#2380) @softwaremill-ci
• Update zio, zio-streams to 2.1.14 (#2378) @softwaremill-ci
• Update logback-classic to 1.5.14 (#2377) @softwaremill-ci
• Update logback-classic to 1.5.13 (#2374) @softwaremill-ci
• Update upickle to 4.0.2 (#2299) @softwaremill-ci
• Update async-http-client to 2.12.4 (#2371) @softwaremill-ci
• Update prometheus-metrics-core to 1.3.5 (#2370) @softwaremill-ci

v3.10.2

What’s Changed

• Update async-http-client to 2.12.4 (#2383) @adamw

v4.0.0-M20

What’s Changed

• Improve usability of response specifications (#2365) @adamw
• Move options that used tags to RequestOptions, replace tags with attributes (#2364) @adamw
• Remove BodySerializer (#2362) @adamw
• make HttpError and DeserializationException covariant to follow variance of ResponseException (#2357) @NPCRUS
• Add OpenTelemetry attributes to the metrics backend (#2327) @varshith257
• Fix comma/typo (#2325) @magdzikk

Dependency updates

• Update jsoniter-scala-core, ... to 2.32.0 (#2369) @softwaremill-ci
• Update fs2-io, fs2-reactive-streams to 3.11.0 (#2264) @softwaremill-ci
• Update mdoc, sbt-mdoc to 2.6.2 (#2367) @softwaremill-ci
• Update armeria to 1.31.3 (#2366) @softwaremill-ci
• Update zipkin-sender-okhttp3 to 3.4.3 (#2363) @softwaremill-ci
• Update opentelemetry-api, ... to 1.45.0 (#2361) @softwaremill-ci
• Update http4s-client, http4s-ember-client to 0.23.30 (#2360) @softwaremill-ci
• Update armeria to 1.31.2 (#2359) @softwaremill-ci
• Update sbt, scripted-plugin to 1.10.6 (#2356) @softwaremill-ci
• Update zio-opentelemetry to 3.1.0 (#2354) @softwaremill-ci
• Update cats-effect, cats-effect-kernel, ... to 3.5.7 (#2355) @softwaremill-ci
• Update prometheus-metrics-core to 1.3.4 (#2353) @softwaremill-ci
• Update zio-opentelemetry to 3.0.2 (#2352) @softwaremill-ci
• Update sbt-projectmatrix to 0.10.1 (#2351) @softwaremill-ci
• Update armeria to 1.31.1 (#2350) @softwaremill-ci
• Update zio, zio-streams to 2.1.13 (#2349) @softwaremill-ci
• Update commons-io to 2.18.0 (#2347) @softwaremill-ci
• Update cats-effect-kernel, ... to 3.5.6 (#2348) @softwaremill-ci
• Update sbt-scala-native to 0.5.6 (#2346) @softwaremill-ci
• Update armeria to 1.31.0 (#2345) @softwaremill-ci
• Update shared:akka, shared:core, shared:fs2, ... to 1.4.0 (#2344) @softwaremill-ci
• Update tethys-core, tethys-derivation, ... to 0.29.3 (#2343) @softwaremill-ci
• Update opentelemetry-api, ... to 1.44.1 (#2342) @softwaremill-ci
• Update jsoniter-scala-core, ... to 2.31.3 (#2341) @softwaremill-ci
• Update opentelemetry-api, ... to 1.44.0 (#2340) @softwaremill-ci
• Update zio, zio-streams to 2.1.12 (#2339) @softwaremill-ci
• Update prometheus-metrics-core to 1.3.3 (#2336) @softwaremill-ci
• Update zio-opentelemetry to 3.0.1 (#2335) @softwaremill-ci
• Update http4s-blaze-client to 0.23.17 (#2334) @softwaremill-ci
• Update sbt to 1.10.5 (#2333) @softwaremill-ci
• Update sbt to 1.10.4 (#2332) @softwaremill-ci
• Update cats-effect-kernel, ... to 3.5.5 (#2330) @softwaremill-ci
• Update logback-classic to 1.5.12 (#2328) @softwaremill-ci
• Update scribe to 3.15.2 (#2329) @softwaremill-ci
• Update http4s-client to 0.23.29 (#2326) @softwaremill-ci
• Update tethys-core, tethys-derivation, ... to 0.29.2 (#2323) @softwaremill-ci
• Update http4s-ember-client to 0.23.29 (#2324) @softwaremill-ci
• Update jsoniter-scala-core, ... to 2.31.1 (#2322) @softwaremill-ci
• Update sbt to 1.10.3 (#2321) @softwaremill-ci
• Update prometheus-metrics-core to 1.3.2 (#2320) @softwaremill-ci
• Update scribe to 3.15.1 (#2319) @softwaremill-ci
• Update sbt-softwaremill-browser-test-js, ... to 2.0.21 (#2318) @softwaremill-ci
• Update zio-opentelemetry to 3.0.0 (#2316) @softwaremill-ci
• Update jsoniter-scala-core, ... to 2.31.0 (#2315) @softwaremill-ci
• Update logback-classic to 1.5.11 (#2313) @softwaremill-ci

v4.0.0-M19

What’s Changed

• Update ox to 0.5.1 (#2310) @adamw

Dependency updates

• Update logback-classic to 1.5.10 (#2309) @softwaremill-ci
• Update opentelemetry-api, ... to 1.43.0 (#2308) @softwaremill-ci
• Update zio, zio-streams to 2.1.11 (#2307) @softwaremill-ci
• Update pekko-stream to 1.1.2 (#2306) @softwaremill-ci
• Update logback-classic to 1.5.9 (#2305) @softwaremill-ci
• Update jsoniter-scala-core, ... to 2.30.15 (#2304) @softwaremill-ci
• Update pekko-http to 1.1.0 (#2303) @softwaremill-ci
• Update jsoniter-scala-core, ... to 2.30.14 (#2302) @softwaremill-ci
• Update sbt-scalajs, scalajs-compiler, ... to 1.17.0 (#2300) @softwaremill-ci
• Update scala3-library, ... to 3.3.4 (#2297) @softwaremill-ci
• Update scala-library to 2.13.15 (#2296) @softwaremill-ci
• Update tethys-core, tethys-derivation, ... to 0.29.1 (#2293) @softwaremill-ci

v3.10.1

What’s Changed

• Remove sttpClientTag (#2312) @wi101