Adding `eventsource_client` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add eventsource-client

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

eventsource-client = "0.16.2"

The eventsource_client library will be automatically available globally. Read the eventsource_client library documentation.

Back to the crate overview.

Readme

eventsource-client

Client for the Server-Sent Events protocol (aka EventSource).

Requirements

Requires tokio.

Usage

Example that just prints the type of each event received:

use eventsource_client as es;

let mut client = es::ClientBuilder::for_url("https://example.com/stream")?
    .header("Authorization", "Basic username:password")?
    .build();

client
    .stream()
    .map_ok(|event| println!("got event: {:?}", event))
    .map_err(|err| eprintln!("error streaming events: {:?}", err));

(Some boilerplate omitted for clarity; see examples directory for complete, working code.)

Features

tokio-based streaming client.
Supports setting custom headers on the HTTP request (e.g. for endpoints requiring authorization).
Retry for failed connections.
Reconnection if connection is interrupted, with exponential backoff.

Stability

Early stage release for feedback purposes. May contain bugs or performance issues. API subject to change.

Adding eventsource_client library as a dependency

Adding `eventsource_client` library as a dependency