Crates.io | file-rotate |
lib.rs | file-rotate |
version | 0.7.6 |
source | src |
created_at | 2019-07-23 08:29:38.554587 |
updated_at | 2024-05-16 19:01:59.217101 |
description | Log rotation for files |
homepage | https://github.com/kstrafe/file-rotate |
repository | https://github.com/kstrafe/file-rotate |
max_upload_size | |
id | 150969 |
size | 88,291 |
Rotate files with configurable suffix.
Look to the docs for explanatory examples of all features, like:
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 thisFollowing are some supplementary examples to get started.
use file_rotate::{FileRotate, ContentLimit, compression::Compression, suffix::AppendCount};
use std::{fs, io::Write, path::PathBuf};
fn main() {
let mut log = FileRotate::new("logs/log", AppendCount::new(2), ContentLimit::Lines(3), Compression::None, 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
let mut log = FileRotate::new(
"logs/log",
AppendTimestamp::default(FileLimit::MaxFiles(3)),
ContentLimit::Lines(3),
Compression::None,
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.
This project is licensed under the MIT license.
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.