Skip to content

Commit

Permalink
Release 3.4.1
Browse files Browse the repository at this point in the history
  • Loading branch information
adamw committed Jan 24, 2022
1 parent 70fc32d commit b369775
Show file tree
Hide file tree
Showing 24 changed files with 125 additions and 85 deletions.
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,14 +45,14 @@ sttp (v2) documentation is available at [sttp.softwaremill.com/en/v2](http://stt

sttp (v1) documentation is available at [sttp.softwaremill.com/en/v1](https://sttp.softwaremill.com/en/v1).

scaladoc is available at [https://www.javadoc.io](https://www.javadoc.io/doc/com.softwaremill.sttp.client3/core_2.12/3.4.0)
scaladoc is available at [https://www.javadoc.io](https://www.javadoc.io/doc/com.softwaremill.sttp.client3/core_2.12/3.4.1)

## Quickstart with Ammonite

If you are an [Ammonite](http://ammonite.io) user, you can quickly start experimenting with sttp by copy-pasting the following:

```scala
import $ivy.`com.softwaremill.sttp.client3::core:3.4.0`
import $ivy.`com.softwaremill.sttp.client3::core:3.4.1`
import sttp.client3.quick._
quickRequest.get(uri"http://httpbin.org/ip").send(backend)
```
Expand All @@ -64,7 +64,7 @@ This brings in the sttp API and a synchronous backend instance.
Add the following dependency:

```scala
"com.softwaremill.sttp.client3" %% "core" % "3.4.0"
"com.softwaremill.sttp.client3" %% "core" % "3.4.1"
```

Then, import:
Expand Down Expand Up @@ -98,7 +98,7 @@ The documentation is typechecked using [mdoc](https://scalameta.org/mdoc/). The

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.4.0"`, before running `mdoc` in `docs`.
That is, in sbt run: `set version := "3.4.1"`, before running `mdoc` in `docs`.

### Testing the Scala.JS backend

Expand Down
2 changes: 1 addition & 1 deletion generated-docs/out/backends/akka.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
This backend is based on [akka-http](http://doc.akka.io/docs/akka-http/current/scala/http/). To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "akka-http-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "akka-http-backend" % "3.4.1"
```

A fully **asynchronous** backend. Uses the `Future` effect to return responses. There are also [other `Future`-based backends](future.md), which don't depend on Akka.
Expand Down
8 changes: 4 additions & 4 deletions generated-docs/out/backends/catseffect.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@ Note that all [fs2](fs2.md) backends also support any cats-effect effect, additi
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "async-http-client-backend-cats" % "3.4.0" // for cats-effect 3.x
"com.softwaremill.sttp.client3" %% "async-http-client-backend-cats" % "3.4.1" // for cats-effect 3.x
// or
"com.softwaremill.sttp.client3" %% "async-http-client-backend-cats-ce2" % "3.4.0" // for cats-effect 2.x
"com.softwaremill.sttp.client3" %% "async-http-client-backend-cats-ce2" % "3.4.1" // for cats-effect 2.x
```
This backend depends on [async-http-client](https://github.com/AsyncHttpClient/async-http-client), uses [Netty](http://netty.io) behind the scenes.
Expand Down Expand Up @@ -83,9 +83,9 @@ val backend = AsyncHttpClientCatsBackend.usingClient[IO](asyncHttpClient)
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "armeria-backend-cats" % "3.4.0" // for cats-effect 3.x
"com.softwaremill.sttp.client3" %% "armeria-backend-cats" % "3.4.1" // for cats-effect 3.x
// or
"com.softwaremill.sttp.client3" %% "armeria-backend-cats-ce2" % "3.4.0" // for cats-effect 2.x
"com.softwaremill.sttp.client3" %% "armeria-backend-cats-ce2" % "3.4.1" // for cats-effect 2.x
```

create client:
Expand Down
2 changes: 1 addition & 1 deletion generated-docs/out/backends/finagle.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "finagle-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "finagle-backend" % "3.4.1"
```

Next you'll need to add an implicit value:
Expand Down
12 changes: 6 additions & 6 deletions generated-docs/out/backends/fs2.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ The [fs2](https://github.com/functional-streams-for-scala/fs2) backend is **asyn
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "async-http-client-backend-fs2" % "3.4.0" // for cats-effect 3.x & fs2 3.x
"com.softwaremill.sttp.client3" %% "async-http-client-backend-fs2" % "3.4.1" // for cats-effect 3.x & fs2 3.x
// or
"com.softwaremill.sttp.client3" %% "async-http-client-backend-fs2-ce2" % "3.4.0" // for cats-effect 2.x & fs2 2.x
"com.softwaremill.sttp.client3" %% "async-http-client-backend-fs2-ce2" % "3.4.1" // for cats-effect 2.x & fs2 2.x
```

This backend depends on [async-http-client](https://github.com/AsyncHttpClient/async-http-client) and uses [Netty](http://netty.io) behind the scenes.
Expand Down Expand Up @@ -88,9 +88,9 @@ val backend = AsyncHttpClientFs2Backend.usingClient[IO](asyncHttpClient, dispatc
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "httpclient-backend-fs2" % "3.4.0" // for cats-effect 3.x & fs2 3.x
"com.softwaremill.sttp.client3" %% "httpclient-backend-fs2" % "3.4.1" // for cats-effect 3.x & fs2 3.x
// or
"com.softwaremill.sttp.client3" %% "httpclient-backend-fs2-ce2" % "3.4.0" // for cats-effect 2.x & fs2 2.x
"com.softwaremill.sttp.client3" %% "httpclient-backend-fs2-ce2" % "3.4.1" // for cats-effect 2.x & fs2 2.x
```

Create the backend using a cats-effect `Resource`:
Expand Down Expand Up @@ -140,9 +140,9 @@ jdk.httpclient.allowRestrictedHeaders=host
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "armeria-backend-fs2" % "3.4.0" // for cats-effect 3.x & fs2 3.x
"com.softwaremill.sttp.client3" %% "armeria-backend-fs2" % "3.4.1" // for cats-effect 3.x & fs2 3.x
// or
"com.softwaremill.sttp.client3" %% "armeria-backend-fs2" % "3.4.0" // for cats-effect 2.x & fs2 2.x
"com.softwaremill.sttp.client3" %% "armeria-backend-fs2" % "3.4.1" // for cats-effect 2.x & fs2 2.x
```

create client:
Expand Down
8 changes: 4 additions & 4 deletions generated-docs/out/backends/future.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Class Supported stream type
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "async-http-client-backend-future" % "3.4.0"
"com.softwaremill.sttp.client3" %% "async-http-client-backend-future" % "3.4.1"
```

And some imports:
Expand Down Expand Up @@ -72,7 +72,7 @@ val backend = AsyncHttpClientFutureBackend.usingClient(asyncHttpClient)
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "okhttp-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "okhttp-backend" % "3.4.1"
```

and some imports:
Expand Down Expand Up @@ -104,7 +104,7 @@ This backend depends on [OkHttp](http://square.github.io/okhttp/) and fully supp
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "httpclient-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "httpclient-backend" % "3.4.1"
```

and some imports:
Expand Down Expand Up @@ -141,7 +141,7 @@ jdk.httpclient.allowRestrictedHeaders=host
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "armeria-backend-future" % "3.4.0"
"com.softwaremill.sttp.client3" %% "armeria-backend-future" % "3.4.1"
```

add imports:
Expand Down
4 changes: 2 additions & 2 deletions generated-docs/out/backends/http4s.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@
This backend is based on [http4s](https://http4s.org) (client) and is **asynchronous**. To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "http4s-backend" % "3.4.0" // for cats-effect 3.x & http4s 1.0.0-Mx
"com.softwaremill.sttp.client3" %% "http4s-backend" % "3.4.1" // for cats-effect 3.x & http4s 1.0.0-Mx
// or
"com.softwaremill.sttp.client3" %% "http4s-ce2-backend" % "3.4.0" // for cats-effect 2.x & http4s 0.21.x
"com.softwaremill.sttp.client3" %% "http4s-ce2-backend" % "3.4.1" // for cats-effect 2.x & http4s 0.21.x
```

The backend can be created in a couple of ways, e.g.:
Expand Down
8 changes: 4 additions & 4 deletions generated-docs/out/backends/javascript/fetch.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ A JavaScript backend with web socket support. Implemented using the [Fetch API](
This is the default backend, available in the main jar for JS. To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %%% "core" % "3.4.0"
"com.softwaremill.sttp.client3" %%% "core" % "3.4.1"
```

And create the backend instance:
Expand All @@ -26,7 +26,7 @@ Note that `Fetch` does not pass cookies by default. If your request needs cookie
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %%% "monix" % "3.4.0"
"com.softwaremill.sttp.client3" %%% "monix" % "3.4.1"
```

And create the backend instance:
Expand All @@ -41,7 +41,7 @@ Any effect implementing the cats-effect `Concurrent` typeclass can be used. To u
your project:

```
"com.softwaremill.sttp.client3" %%% "cats" % "3.4.0"
"com.softwaremill.sttp.client3" %%% "cats" % "3.4.1"
```

And create the backend instance:
Expand Down Expand Up @@ -80,7 +80,7 @@ Streaming support is provided via `FetchMonixBackend`. Note that streaming suppo
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %%% "monix" % "3.4.0"
"com.softwaremill.sttp.client3" %%% "monix" % "3.4.1"
```

An example of streaming a response:
Expand Down
8 changes: 4 additions & 4 deletions generated-docs/out/backends/monix.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ There are several backend implementations which are `monix.eval.Task`-based. The
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "async-http-client-backend-monix" % "3.4.0"
"com.softwaremill.sttp.client3" %% "async-http-client-backend-monix" % "3.4.1"
```
This backend depends on [async-http-client](https://github.com/AsyncHttpClient/async-http-client), uses [Netty](http://netty.io) behind the scenes.
Expand Down Expand Up @@ -50,7 +50,7 @@ val backend = AsyncHttpClientMonixBackend.usingClient(asyncHttpClient)
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "okhttp-backend-monix" % "3.4.0"
"com.softwaremill.sttp.client3" %% "okhttp-backend-monix" % "3.4.1"
```

Create the backend using:
Expand All @@ -76,7 +76,7 @@ This backend depends on [OkHttp](http://square.github.io/okhttp/) and fully supp
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "httpclient-backend-monix" % "3.4.0"
"com.softwaremill.sttp.client3" %% "httpclient-backend-monix" % "3.4.1"
```

Create the backend using:
Expand Down Expand Up @@ -107,7 +107,7 @@ jdk.httpclient.allowRestrictedHeaders=host
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "armeria-backend-monix" % "3.4.0"
"com.softwaremill.sttp.client3" %% "armeria-backend-monix" % "3.4.1"
```

add imports:
Expand Down
2 changes: 1 addition & 1 deletion generated-docs/out/backends/native/curl.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ A Scala Native backend implemented using [Curl](https://github.com/curl/curl/blo
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %%% "core" % "3.4.0"
"com.softwaremill.sttp.client3" %%% "core" % "3.4.1"
```

and initialize one of the backends:
Expand Down
4 changes: 2 additions & 2 deletions generated-docs/out/backends/scalaz.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ The [Scalaz](https://github.com/scalaz/scalaz) backend is **asynchronous**. Send
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "async-http-client-backend-scalaz" % "3.4.0"
"com.softwaremill.sttp.client3" %% "async-http-client-backend-scalaz" % "3.4.1"
```
This backend depends on [async-http-client](https://github.com/AsyncHttpClient/async-http-client) and uses [Netty](http://netty.io) behind the scenes.
Expand Down Expand Up @@ -45,7 +45,7 @@ val backend = AsyncHttpClientScalazBackend.usingClient(asyncHttpClient)
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "armeria-backend-scalaz" % "3.4.0"
"com.softwaremill.sttp.client3" %% "armeria-backend-scalaz" % "3.4.1"
```

add imports:
Expand Down
4 changes: 2 additions & 2 deletions generated-docs/out/backends/synchronous.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ sun.net.http.allowRestrictedHeaders=true
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "okhttp-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "okhttp-backend" % "3.4.1"
```

Create the backend using:
Expand Down Expand Up @@ -53,7 +53,7 @@ This backend depends on [OkHttp](http://square.github.io/okhttp/) and fully supp
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "httpclient-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "httpclient-backend" % "3.4.1"
```

Create the backend using:
Expand Down
2 changes: 1 addition & 1 deletion generated-docs/out/backends/wrappers/custom.md
Original file line number Diff line number Diff line change
Expand Up @@ -238,7 +238,7 @@ object RateLimitingSttpBackend {
Implementing a new backend is made easy as the tests are published in the `core` jar file under the `tests` classifier. Simply add the follow dependencies to your `build.sbt`:

```
"com.softwaremill.sttp.client3" %% "core" % "3.4.0" % Test classifier "tests"
"com.softwaremill.sttp.client3" %% "core" % "3.4.1" % Test classifier "tests"
```

Implement your backend and extend the `HttpTest` class:
Expand Down
4 changes: 2 additions & 2 deletions generated-docs/out/backends/wrappers/logging.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Log levels can be configured when creating the `LoggingBackend`, or specified in
To use the [slf4j](http://www.slf4j.org) logging backend wrapper, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "slf4j-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "slf4j-backend" % "3.4.1"
```

There are three backend wrappers available, which log request & response information using a slf4j `Logger`. To see the logs, you'll need to use an slf4j-compatible logger implementation, e.g. [logback](http://logback.qos.ch), or use a binding, e.g. [log4j-slf4j](https://logging.apache.org/log4j/2.0/log4j-slf4j-impl/index.html).
Expand All @@ -50,5 +50,5 @@ To create a customised logging backend, see the section on [custom backends](cus
To use the [scribe](https://github.com/outr/scribe) logging backend wrapper, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "scribe-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "scribe-backend" % "3.4.1"
```
2 changes: 1 addition & 1 deletion generated-docs/out/backends/wrappers/opentracing.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "opentracing-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "opentracing-backend" % "3.4.1"
```

This backend depends on [opentracing](https://github.com/opentracing/opentracing-java), a standardized set of api for distributed tracing.
Expand Down
2 changes: 1 addition & 1 deletion generated-docs/out/backends/wrappers/prometheus.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "prometheus-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "prometheus-backend" % "3.4.1"
```

and some imports:
Expand Down
2 changes: 1 addition & 1 deletion generated-docs/out/backends/wrappers/zio-opentelemetry.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "zio-telemetry-opentelemetry-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "zio-telemetry-opentelemetry-backend" % "3.4.1"
```

This backend depends on [zio-opentelemetry](https://github.com/zio/zio-telemetry).
Expand Down
2 changes: 1 addition & 1 deletion generated-docs/out/backends/wrappers/zio-opentracing.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "zio-telemetry-opentracing-backend" % "3.4.0"
"com.softwaremill.sttp.client3" %% "zio-telemetry-opentracing-backend" % "3.4.1"
```

This backend depends on [zio-opentracing](https://github.com/zio/zio-telemetry).
Expand Down
12 changes: 6 additions & 6 deletions generated-docs/out/backends/zio.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ The `*-zio` modules depend on ZIO 2.x. For ZIO 1.x support, use modules with the
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "httpclient-backend-zio" % "3.4.0" // for ZIO 2.x
"com.softwaremill.sttp.client3" %% "httpclient-backend-zio1" % "3.4.0" // for ZIO 1.x
"com.softwaremill.sttp.client3" %% "httpclient-backend-zio" % "3.4.1" // for ZIO 2.x
"com.softwaremill.sttp.client3" %% "httpclient-backend-zio1" % "3.4.1" // for ZIO 1.x
```

Create the backend using:
Expand Down Expand Up @@ -41,8 +41,8 @@ jdk.httpclient.allowRestrictedHeaders=host
To use, add the following dependency to your project:

```scala
"com.softwaremill.sttp.client3" %% "async-http-client-backend-zio" % "3.4.0" // for ZIO 2.x
"com.softwaremill.sttp.client3" %% "async-http-client-backend-zio1" % "3.4.0" // for ZIO 1.x
"com.softwaremill.sttp.client3" %% "async-http-client-backend-zio" % "3.4.1" // for ZIO 2.x
"com.softwaremill.sttp.client3" %% "async-http-client-backend-zio1" % "3.4.1" // for ZIO 1.x
```
This backend depends on [async-http-client](https://github.com/AsyncHttpClient/async-http-client), uses [Netty](http://netty.io) behind the scenes. This backend works with all Scala versions. A Scala 3 build is available as well.
Expand Down Expand Up @@ -88,8 +88,8 @@ val backend = AsyncHttpClientZioBackend.usingClient(runtime, asyncHttpClient)
To use, add the following dependency to your project:

```
"com.softwaremill.sttp.client3" %% "armeria-backend-zio" % "3.4.0" // for ZIO 2.x
"com.softwaremill.sttp.client3" %% "armeria-backend-zio1" % "3.4.0" // for ZIO 1.x
"com.softwaremill.sttp.client3" %% "armeria-backend-zio" % "3.4.1" // for ZIO 2.x
"com.softwaremill.sttp.client3" %% "armeria-backend-zio1" % "3.4.1" // for ZIO 1.x
```

add imports:
Expand Down
6 changes: 3 additions & 3 deletions generated-docs/out/conf/ssl.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,10 +28,10 @@ val TrustAllCerts: X509TrustManager = new X509TrustManager() {
}

val ks: KeyStore = KeyStore.getInstance(KeyStore.getDefaultType)
ks.load(new FileInputStream("/path/to/your_cert.p12"), "pass".toCharArray)
ks.load(new FileInputStream("/path/to/your_cert.p12"), "password".toCharArray)

val kmf: KeyManagerFactory = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm)
kmf.init(ks, "pass".toCharArray)
kmf.init(ks, "password".toCharArray)

val ssl: SSLContext = SSLContext.getInstance("TLS")
ssl.init(kmf.getKeyManagers, Array(TrustAllCerts), new SecureRandom)
Expand All @@ -48,7 +48,7 @@ Next, based on [one way SSL example](#one-way-ssl), add `TrustManagerFactory` to


```scala
ks.load(new FileInputStream("/path/to/server_trust"), "pass".toCharArray)
ks.load(new FileInputStream("/path/to/server_trust"), "password".toCharArray)

val tmf: TrustManagerFactory = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm)
tmf.init(ks)
Expand Down
Loading

0 comments on commit b369775

Please sign in to comment.