Show how to use Client::new_with_client (#119)

* Show how to use Client::new_with_client

* new doc on implementation
This commit is contained in:
Karen Cárcamo 2022-07-13 06:19:25 +12:00 committed by GitHub
parent 75519247fa
commit 3c8c51260d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 32 additions and 1 deletions

2
.gitignore vendored
View File

@ -1 +1 @@
/target target/

View File

@ -0,0 +1,31 @@
# Implementing the client
Once you have generated your client, you'll notice there are two methods to create a new client; `Client::new()` and `Client::new_with_client()`.
The first method will create a basic client without any headers or customisations that aren't already in your OpenAPI specification file:
```rust
let client = Client::new("https://foo/bar");
```
Should you need to set custom headers or other reqwest::ClientBuilder methods, you can use `Client::new_with_client()` as shown below.
```rust
let mut val = reqwest::header::HeaderValue::from_static("super-secret");
val.set_sensitive(true);
let mut headers = reqwest::header::HeaderMap::new();
headers.insert(reqwest::header::AUTHORIZATION, val);
// Insert more headers if necessary
let client_builder = reqwest::ClientBuilder::new()
// Set custom timeout
.connect_timeout(Duration::new(60, 0))
// Set custom headers
.default_headers(headers)
.build()
.unwrap();
let client Client::new_with_client("https://foo/bar", client_builder);
```
For more information on available methods, see the [reqwest](https://docs.rs/reqwest/latest/reqwest/struct.ClientBuilder.html) documentation.