18 releases

0.2.18 Jul 8, 2024
0.2.17 Jul 8, 2024
0.2.16 Jun 7, 2024
0.2.13 May 21, 2024
0.2.1 Mar 15, 2021

#639 in Web programming

Download history 109/week @ 2024-07-01 231/week @ 2024-07-08 14/week @ 2024-07-29 18/week @ 2024-08-12 23/week @ 2024-08-19 27/week @ 2024-08-26 2/week @ 2024-09-16 36/week @ 2024-09-23 34/week @ 2024-09-30 13/week @ 2024-10-07

85 downloads per month

MIT license

16KB
175 lines

changes_stream2

License Cargo Documentation

Fork of https://github.com/ashleygwilliams/changes-stream-rust / https://crates.io/crates/changes-stream.

An implementation of changes-stream in Rust.

This code reads in a readable stream from an endpoint, parses each line and returns CouchDB changes events as defined in src/event.rs.

usage

in your Cargo.toml:

[dependencies]
changes-stream2 = "0.2"

from examples/follower.rs:

use changes_stream2::{ChangesStream, Event};
use futures_util::stream::StreamExt;

#[tokio::main]
async fn main() {
    let url = "https://replicate.npmjs.com/_changes".to_string();
    let mut changes = ChangesStream::new(url).await.unwrap();
    while let Some(event) = changes.next().await {
        match event {
            Ok(Event::Change(change)) => println!("Change ({}): {}", change.seq, change.id),
            Ok(Event::Finished(finished)) => println!("Finished: {}", finished.last_seq),
            Err(err) => println!("Error: {:?}", err),
        }
    }
}

features

metrics

Enables metrics collection of the changes stream as counter values. The name is generated from the host and path of the url(database name). The metrics are:

  • couchdb_changes_{name}_bytes: Total bytes read from the changes stream
  • couchdb_changes_{name}_entries: Total parsed change entries

raw_value_doc

Changes the type of ChangeEvent::Doc from serde_json::Map<String, serde_json::Value> to serde_json::value::RawValue.

native-tls

Use the native-tls crate for TLS connections. This is the default.

rustls-tls

Use the rustls crate for TLS connections.

Dependencies

~6–17MB
~239K SLoC