Module zng::task::http

HTTP client.

This module is a thin wrapper around the isahc crate that just limits the API surface to only async methods without the async suffix. You can convert from/into that isahc types and this one.

Examples

Get some text:

let text = task::http::get_txt("https://httpbin.org/base64/SGVsbG8gV29ybGQ=").await?;
println!("{text}!");

Modules

• header
  HTTP header types
• uri
  URI component of request and response lines

Structs

• Body
  HTTP request body.
• CacheKey
  Represents a SHA-512/256 hash computed from a normalized request.
• CachePolicy
  Represents a serializable configuration for a cache entry in a CacheDb.
• Client
  HTTP client.
• ClientBuilder
  Builder that can be used to create a Client.
• Cookie
  Information stored about an HTTP cookie.
• CookieJar
  Provides automatic cookie session management using an in-memory cookie store.
• DefaultAlreadyInitedError
  Error returned by set_default_client_init if the default was already initialized.
• FileSystemCache
  A simple CacheDb implementation that uses a local directory.
• Method
  The Request Method (VERB)
• Metrics
  Information about the state of an HTTP request.
• Request
  HTTP request.
• RequestBuilder
  A Request builder.
• Response
  HTTP response.
• StatusCode
  An HTTP status code (status-code in RFC 7230 et al.).
• Uri
  The URI component of a request.

Enums

• CacheMode
  Cache mode selected for a Uri.
• Error
  An error encountered while sending an HTTP request or receiving an HTTP response using a Client.
• RedirectPolicy
  Describes a policy for handling server redirects.

Statics

• METRICS_ID
  Metrics in a Progress::with_meta metadata.

Traits

• CacheDb
  Represents a download cache in a Client.
• TryBody
  Marker trait for types that try-to-convert to Body.
• TryHeaderName
  Marker trait for types that try-to-convert to header::HeaderName.
• TryHeaderValue
  Marker trait for types that try-to-convert to header::HeaderValue.
• TryMethod
  Marker trait for types that try-to-convert to Method.
• TryUri
  Marker trait for types that try-to-convert to Uri.

Functions

• default_client
  The Client used by the functions in this module.
• delete
  Send a DELETE request to the uri.
• get
  Send a GET request to the uri.
• get_bytes
  Send a GET request to the uri and read the response as raw bytes.
• get_json
  Send a GET request to the uri and de-serializes the response.
• get_txt
  Send a GET request to the uri and read the response as a string.
• head
  Send a HEAD request to the uri.
• post
  Send a POST request to the uri with a given request body.
• put
  Send a PUT request to the uri with a given request body.
• send
  Send a custom Request.
• set_default_client_init
  Set a custom initialization function for the default_client.

Type Aliases

• ResponseParts
  Head parts from a split Response.