Struct stac_async::Client

pub struct Client(pub Client);

A thin wrapper around reqwest::Client.

Tuple Fields

0: Client

Implementations

impl Client

pub fn new() -> Client

Creates a new client.

Examples

let client = stac_async::Client::new();

Custom client

You can construct the client directly using a pre-built reqwest::Client, e.g. to do authorization:

use reqwest::header;
let mut headers = header::HeaderMap::new();
let mut auth_value = header::HeaderValue::from_static("secret");
auth_value.set_sensitive(true);
headers.insert(header::AUTHORIZATION, auth_value);
let client = reqwest::Client::builder().default_headers(headers).build().unwrap();
let client = stac_async::Client(client);

pub async fn get<V>(&self, url: impl IntoUrl) -> Result<Option<V>, Error>where V: DeserializeOwned + Href,

Gets a STAC value from a url.

Also sets that Values href. Returns Ok(None) if a 404 is returned from the server.

Examples

let client = stac_async::Client::new();
let href = "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.0.0/examples/simple-item.json";
let item: stac::Item = client.get(href).await.unwrap().unwrap();

pub async fn post<S, R>( &self, url: impl IntoUrl, data: &S ) -> Result<Option<R>, Error>where S: Serialize + 'static, R: DeserializeOwned,

Posts data to a url.

Examples

use stac_api::Search;
let client = stac_async::Client::new();
let href = "https://planetarycomputer.microsoft.com/api/stac/v1/search";
let search = Search { limit: Some(1), ..Default::default() };
let items: stac_api::ItemCollection = client.post(href, &search).await.unwrap().unwrap();

pub async fn request<S, R>( &self, method: Method, url: impl IntoUrl, params: impl Into<Option<&S>>, headers: impl Into<Option<HeaderMap>> ) -> Result<Option<R>, Error>where S: Serialize + 'static, R: DeserializeOwned,

Sends a request to a url.

Examples

use stac::Item;
use reqwest::Method;

let client = stac_async::Client::new();
let href = "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.0.0/examples/simple-item.json";
let item = client.request::<(), Item>(Method::GET, href, None, None).await.unwrap().unwrap();

pub async fn request_from_link<R>(&self, link: Link) -> Result<Option<R>, Error>where R: DeserializeOwned,

Builds and sends a request, as defined in a link.

Used mostly for “next” links in pagination.

Examples

use stac::Link;
let link = Link::new("http://stac-async-rs.test/search?foo=bar", "next");
let client = stac_async::Client::new();
let page: stac_api::ItemCollection = client.request_from_link(link).await.unwrap().unwrap();

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.