tailf

Crates.iotailf
lib.rstailf
version0.1.2
sourcesrc
created_at2024-11-15 11:38:11.804358
updated_at2024-11-18 02:38:04.192104
descriptionA async `tail -f` for files
homepage
repositoryhttps://github.com/kvinwang/tailf
max_upload_size
id1449027
size15,456
Kevin Wang (kvinwang)

documentation

README

tailf

A Rust library that provides an async file tailing functionality using the system's tail command, powered by tokio::process::Command.

Installation

Add this to your Cargo.toml:

[dependencies]
tailf = "0.1.0"

Usage

use tailf::tailf;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Read last 10 lines and follow new updates
    let num_lines = 10;
    let mut tailer = tailf("/var/log/syslog", Some(num_lines));

    while let Some(line) = tailer.next().await? {
        let line_str = String::from_utf8_lossy(&line);
        print!("{}", line_str);
        std::io::stdout().flush()?;
    }

    Ok(())
}

Cleanup

The underlying tail process is automatically terminated when the tailer instance is dropped.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Commit count: 6

cargo fmt