#async-io #read-write #io-read #byte #tokio #future #io-write

no-std countio

Byte counting for std::io::{Read, Write, Seek} and its async variants from futures and tokio

6 releases

0.2.19 Sep 3, 2024
0.2.18 Jun 26, 2024
0.2.17 Mar 7, 2024
0.2.15 Jul 31, 2023
0.2.3 Mar 13, 2023

#150 in Asynchronous

Download history 2150/week @ 2024-07-29 1682/week @ 2024-08-05 1795/week @ 2024-08-12 1531/week @ 2024-08-19 1613/week @ 2024-08-26 1995/week @ 2024-09-02 1765/week @ 2024-09-09 1328/week @ 2024-09-16 1661/week @ 2024-09-23 1208/week @ 2024-09-30 1716/week @ 2024-10-07 1906/week @ 2024-10-14 2306/week @ 2024-10-21 1775/week @ 2024-10-28 1803/week @ 2024-11-04 1910/week @ 2024-11-11

7,833 downloads per month
Used in 5 crates (2 directly)

MIT license

19KB
385 lines

countio

Build Status Crate Docs Crate Version Crate Coverage

Check out other spire projects here.

The wrapper struct to enable byte counting for std::io::{Read, Write, Seek} and its asynchronous variants from futures and tokio crates.

Features

  • std to enable std::io::{Read, Write, Seek}. Enabled by default.
  • futures to enable futures_io::{AsyncRead, AsyncWrite, AsyncSeek}.
  • tokio to enable tokio::io::{AsyncRead, AsyncWrite, AsyncSeek}.

Examples

  • std::io::Read:
use std::io::{BufRead, BufReader, Result};
use countio::Counter;

fn main() -> Result<()> {
    let reader = "Hello World!".as_bytes();
    let reader = BufReader::new(reader);
    let mut reader = Counter::new(reader);

    let mut buf = String::new();
    let len = reader.read_line(&mut buf)?;

    assert_eq!(len, reader.reader_bytes());
    Ok(())
}
  • std::io::Write:
use std::io::{BufWriter, Write, Result};
use countio::Counter;

fn main() -> Result<()> {
    let writer = Vec::new();
    let writer = BufWriter::new(writer);
    let mut writer = Counter::new(writer);

    let buf = "Hello World!".as_bytes();
    let len = writer.write(buf)?;
    writer.flush()?;

    assert_eq!(len, writer.writer_bytes());
    Ok(())
}

Other crates

Dependencies

~0–6MB
~19K SLoC