nyquest-preset

Nyquest preset configuration with up-to-date rich-featured backends.

nyquest-preset is the official, default backend provider of nyquest that integrates nyquest-backend-winrt, nyquest-backend-nsurlsession and nyquest-backend-curl into a uniform interface. The only exposed APIs are the register function and the Backend type of the underlying backend.

This crate is intended to be consumed by end application users. Since there can be only one backend registered as the global default, library authors in general are not recommended to declare this crate as a dependency. Libraries should use nyquest instead.

Quick Start

Add the following at your program startup:

nyquest_backend::register();

Based on the target platform, a nyquest backend will be registered as the default. Refer to the documentation of nyquest for usages.

Platform Support

nyquest-preset uses cfg to select the appropriate backend for the target platform.

• windows: nyquest-backend-winrt
• target_vendor = "apple": nyquest-backend-nsurlsession
• others: nyquest-backend-curl

Features

• async: Enable async support for backends and nyquest.
• async-stream: Enable async support and streaming upload/download for backends and nyquest.
• blocking: Enable blocking support for backends and nyquest.
• blocking-stream: Enable blocking support and streaming upload/download for backends and nyquest.
• multipart: Enable multipart form support for backends and nyquest.
• auto-register: Automatically register the backend before program startup using ctor. Recommended to be used in tests and examples.

Refer to the backends' documentation for more optional features. For example, enable charset-defaults for nyquest-backend-curl to perform encoding conversion automatically when the response has an encoding other than UTF-8.

License

See nyquest#License.