v3.11.0

What’s Changed

• Fix resource leak on cancellation (#2477) @Kamil-Lontkowski

v4.0.0

This is the stable release of sttp-client4, a major release of the Scala HTTP client you always wanted!

Links

• Documentation, examples
• Migrating from v3 to v4
• Community forum - ask migration questions here
• Issues - report bugs, missing examples, 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

• OpenTelemetry metrics+tracing example (#2519) @adamw
• Add mapResponseWithMetadata helper method to requests (#2520) @adamw

Dependency updates

• Update client4:caching-backend, ... to 4.0.0-RC3 (#2511) @softwaremill-ci
• Update opentelemetry-backend to 4.0.0-RC4 (#2521) @softwaremill-ci
• Update client4:caching-backend, ... to 4.0.0-RC4 (#2516) @softwaremill-ci
• Update cats-effect, cats-effect-kernel, ... to 3.6.1 (#2522) @softwaremill-ci
• Update zio, zio-streams to 2.1.17 (#2518) @softwaremill-ci
• Update opentelemetry-api, ... to 1.49.0 (#2517) @softwaremill-ci

v4.0.0-RC4

What’s Changed

• Fix multi-files multipart requests for streaming backends (#2515) @adamw
• github actions refactor (#2458) @Blef666

Dependency updates

• Update opentelemetry-semconv to 1.32.0 (#2514) @softwaremill-ci
• Update opentelemetry-semconv to 1.31.0 (#2513) @softwaremill-ci
• Update zio-opentelemetry to 3.1.3 (#2512) @softwaremill-ci

v4.0.0-RC3

What’s Changed

• When using asFail responses, properly handle redirects (#2510) @adamw
• Add an encodeUriAll option in FollowRedirectsBackend (#2509) @adamw
• Add otel4s OpenTelemetry backend (#2445) @iRevive
• Update client4:caching-backend, ... to 4.0.0-RC2 (#2498) @softwaremill-ci
• Change quickRequest to always read the response body as a string, instead of throwing an exception on http errors (#2507) @adamw
• Hide sensitive information in URL query params (#2500) @aartigao
• Update circe-core, circe-generic, ... to 0.14.12 (#2488) @softwaremill-ci
• Update cats-effect to 3.6.0 (#2504) @iRevive

Dependency updates

• Update model:core to 1.7.13 (#2502) @softwaremill-ci
• Update fs2-core, fs2-io, ... to 3.12.0 (#2501) @softwaremill-ci

v4.0.0-RC2

See the release notes for 4.0.0-RC1 for details on upgrading.

What’s Changed

• Make some internal classes package-private in sttp4 (#2496) @adamw
• Update logback-classic to 1.5.18 (#2492) @softwaremill-ci
• Update to sttp shared 1.5.0 (#2495) @adamw
• Make OpenTelemetryTracingBackend generic - working for any effect (#2494) @adamw
• Update scalafmt-core to 3.9.4 (#2485) @softwaremill-ci
• Support multipart streaming bodies in HttpClient based backends (#2466) @Kamil-Lontkowski
• Update scalafmt-core to 3.9.2 (#2471) @softwaremill-ci
• Update logback-classic to 1.5.17 (#2464) @softwaremill-ci
• #1802: Handle empty GZIP streams gracefully (#2452) @baldram
• Update scalafmt-core to 3.9.1 (#2460) @softwaremill-ci
• Update scalafmt-core to 3.9.0 (#2454) @softwaremill-ci
• Update client4:cats, client4:circe, ... to 4.0.0-RC1 (#2440) @softwaremill-ci

Dependency updates

• Update jsoniter-scala-core, ... to 2.33.3 (#2493) @softwaremill-ci
• Update mdoc, sbt-mdoc to 2.6.5 (#2491) @softwaremill-ci
• Update sbt, scripted-plugin to 1.10.11 (#2490) @softwaremill-ci
• Update armeria to 1.32.3 (#2489) @softwaremill-ci
• Update model:core to 1.7.12 (#2484) @softwaremill-ci
• Update armeria to 1.32.2 (#2487) @softwaremill-ci
• Update armeria to 1.32.1 (#2486) @softwaremill-ci
• Update opentelemetry-api, ... to 1.48.0 (#2483) @softwaremill-ci
• Update zio-opentelemetry to 3.1.2 (#2481) @softwaremill-ci
• Update zio-json to 0.7.39 (#2480) @softwaremill-ci
• Update tethys-core, tethys-derivation, ... to 0.29.4 (#2479) @softwaremill-ci
• Update armeria to 1.32.0 (#2476) @softwaremill-ci
• Update sbt, scripted-plugin to 1.10.10 (#2475) @softwaremill-ci
• Update zio-json to 0.7.38 (#2474) @softwaremill-ci
• Update sbt, scripted-plugin to 1.10.9 (#2472) @softwaremill-ci
• Update zio-json to 0.7.36 (#2470) @softwaremill-ci
• Update sbt-scala-native to 0.5.7 (#2469) @softwaremill-ci
• Update zio-json to 0.7.35 (#2468) @softwaremill-ci
• Update zio, zio-streams to 2.1.16 (#2467) @softwaremill-ci
• Update zio-json to 0.7.33 (#2465) @softwaremill-ci
• Update zio-json to 0.7.31 (#2463) @softwaremill-ci
• Update zio-json to 0.7.30 (#2462) @softwaremill-ci
• Update zio-json to 0.7.28 (#2461) @softwaremill-ci
• Update zio-json to 0.7.26 (#2459) @softwaremill-ci
• Update zio-json to 0.7.25 (#2457) @softwaremill-ci
• Update opentelemetry-semconv to 1.30.0 (#2456) @softwaremill-ci
• Update zio-json to 0.7.23 (#2455) @softwaremill-ci
• Update zipkin-sender-okhttp3 to 3.5.0 (#2453) @softwaremill-ci
• Update os-lib to 0.11.4 (#2451) @softwaremill-ci
• Update zio-json to 0.7.21 (#2449) @softwaremill-ci
• Update prometheus-metrics-core to 1.3.6 (#2450) @softwaremill-ci
• Update mdoc, sbt-mdoc to 2.6.4 (#2448) @softwaremill-ci
• Update zio-json to 0.7.20 (#2447) @softwaremill-ci
• Update zio-json to 0.7.17 (#2444) @softwaremill-ci
• Update zio-json to 0.7.16 (#2443) @softwaremill-ci
• Update jsoniter-scala-core, ... to 2.33.2 (#2442) @softwaremill-ci
• Update opentelemetry-api, ... to 1.47.0 (#2441) @softwaremill-ci

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