12 unstable releases (5 breaking)

0.7.1 Oct 14, 2022
0.7.0-rc.0 Jul 27, 2022
0.6.0 Feb 4, 2022
0.5.0 Dec 15, 2021
0.1.1 Jul 27, 2019

#60 in Debugging

Download history 5897/week @ 2022-10-05 5982/week @ 2022-10-12 6075/week @ 2022-10-19 6210/week @ 2022-10-26 6504/week @ 2022-11-02 6563/week @ 2022-11-09 6611/week @ 2022-11-16 6675/week @ 2022-11-23 7613/week @ 2022-11-30 6588/week @ 2022-12-07 7001/week @ 2022-12-14 6773/week @ 2022-12-21 6398/week @ 2022-12-28 6446/week @ 2023-01-04 6257/week @ 2023-01-11 6468/week @ 2023-01-18

26,828 downloads per month
Used in 4 crates

MIT license

67KB
1.5K SLoC

file-rotate

Rotate files with configurable suffix.

Look to the docs for explanatory examples of all features, like:

  • Using count or timestamp as suffix
  • Age-based deletion of log files
  • Optional compression
  • Getting a list of log files

Limitations / known issues:

  • file-rotate assumes that no other process or user moves files around in the logging directory, but we want to find a way to support this

Following are some supplementary examples to get started.

Basic example

use file_rotate::{FileRotate, ContentLimit, suffix::AppendCount};
use std::{fs, io::Write, path::PathBuf};

fn main() {
    let mut log = FileRotate::new("logs/log", AppendCount::new(2), ContentLimit::Lines(3), None);

    // Write a bunch of lines
    writeln!(log, "Line 1: Hello World!");
    for idx in 2..=10 {
        writeln!(log, "Line {}", idx);
    }
}
$ ls logs
log  log.1  log.2

$ cat log.2 log.1 log
Line 4
Line 5
Line 6
Line 7
Line 8
Line 9
Line 10

Example with timestamp suffixes

let mut log = FileRotate::new(
    "logs/log",
    AppendTimestamp::default(FileLimit::MaxFiles(3)),
    ContentLimit::Lines(3),
    None,
);

// Write a bunch of lines
writeln!(log, "Line 1: Hello World!");
for idx in 2..=10 {
    std::thread::sleep(std::time::Duration::from_millis(200));
    writeln!(log, "Line {}", idx);
}
$ ls logs
log                  log.20210825T151133.1
log.20210825T151133  log.20210825T151134

$ cat logs/*
Line 10
Line 1: Hello World!
Line 2
Line 3
Line 4
Line 5
Line 6
Line 7
Line 8
Line 9

The timestamp format (including the extra trailing .N) works by default so that the lexical ordering of filenames equals the chronological ordering. So it almost works perfectly with cat logs/*, except that log is smaller (lexically "older") than all the rest. This can of course be fixed with a more complex script to assemble the logs.

License

This project is licensed under the MIT license.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in file-rotate by you, shall be licensed as MIT, without any additional terms or conditions.

Dependencies

~245–520KB