Skip to content

Async + Sync file-following for people who care about file rotations and line numbers.

License

Notifications You must be signed in to change notification settings

lloydmeta/chase-rs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Chase Build Status Crates.io Chase

An implementation of async and sync file-following in Rust for people who care about line numbers.

Goals

  • Provide line numbers with each line yielded
  • Ability to exit the watch loop programmatically
  • Deals with file rotations automatically
  • Cross-platform async
  • Configurable (which line to start on, delays and retries)
  • Easy to use synchronously
  • Easy to use asynchronously

Usage

You can use this tool as a lib and as a binary:

As lib

Some features (e.g. receiving as a Stream, and Serde derive for lib-provided structs) are feature-gated, so keep that in mind when adding as a dependency (refer to Cargo.toml for list of features)

As a binary

cargo install chase --features=binary

Chases a file through thick and thin.

USAGE:
    chase [OPTIONS] <f>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -L, --line <l>    The line you want to start chasing your file from [default: 0]

ARGS:
    <f>    The file you want to chase

Caveats

Windows not yet supported: need to figure out what inodes map to

Credit

Very much inspired by logwatcher

About

Async + Sync file-following for people who care about file rotations and line numbers.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages