1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258
use std::rc::Rc;
use std::cell::RefCell;
use std::any::Any;
use std::collections::HashMap;
use std::time::{Instant, Duration};
use std::fmt::{self, Debug};
pub struct Registry {
/// A map from names to typed loggers.
map: HashMap<String, (Box<dyn Any>, Box<dyn Flush>)>,
/// An instant common to all logging statements.
time: Instant,
}
impl Registry {
/// Binds a log name to an action on log event batches.
///
/// This method also returns any pre-installed action, rather than overwriting it
/// and pivoting the logging destination mid-stream. New loggers with this name will
/// use the new destination, and existing loggers will use the old destination.
///
/// The action should respond to a sequence of events with non-decreasing timestamps
/// (Durations) and well as a timestamp that lower bounds the next event that could be
/// seen (likely greater or equal to the timestamp of the last event). The end of a
/// logging stream is indicated only by dropping the associated action, which can be
/// accomplished with `remove` (or a call to insert, though this is not recommended).
pub fn insert<T: 'static, F: FnMut(&Duration, &mut Vec<(Duration, T)>)+'static>(
&mut self,
name: &str,
action: F) -> Option<Box<dyn Any>>
{
let logger = Logger::<T>::new(self.time, Duration::default(), action);
self.insert_logger(name, logger)
}
/// Binds a log name to a logger.
pub fn insert_logger<T: 'static>(
&mut self,
name: &str,
logger: Logger<T>) -> Option<Box<dyn Any>>
{
self.map.insert(name.to_owned(), (Box::new(logger.clone()), Box::new(logger))).map(|x| x.0)
}
/// Removes a bound logger.
///
/// This is intended primarily to close a logging stream and let the associated writer
/// communicate that the stream is closed to any consumers. If a binding is not removed,
/// then the stream cannot be complete as in principle anyone could acquire a handle to
/// the logger and start further logging.
pub fn remove(&mut self, name: &str) -> Option<Box<dyn Any>> {
self.map.remove(name).map(|x| x.0)
}
/// Retrieves a shared logger, if one has been inserted.
pub fn get<T: 'static>(&self, name: &str) -> Option<Logger<T>> {
self.map
.get(name)
.and_then(|entry| entry.0.downcast_ref::<Logger<T>>())
.map(|x| (*x).clone())
}
/// Creates a new logger registry.
pub fn new(time: Instant) -> Self {
Registry {
time,
map: HashMap::new(),
}
}
/// Flushes all registered logs.
pub fn flush(&mut self) {
<Self as Flush>::flush(self);
}
}
impl Flush for Registry {
fn flush(&mut self) {
for value in self.map.values_mut() {
value.1.flush();
}
}
}
/// A buffering logger.
#[derive(Debug)]
pub struct Logger<T> {
inner: Rc<RefCell<LoggerInner<T, dyn FnMut(&Duration, &mut Vec<(Duration, T)>)>>>,
}
impl<T> Clone for Logger<T> {
fn clone(&self) -> Self {
Self {
inner: self.inner.clone()
}
}
}
struct LoggerInner<T, A: ?Sized + FnMut(&Duration, &mut Vec<(Duration, T)>)> {
/// common instant used for all loggers.
time: Instant,
/// offset to allow re-calibration.
offset: Duration,
/// shared buffer of accumulated log events
buffer: Vec<(Duration, T)>,
/// action to take on full log buffers.
action: A,
}
impl<T> Logger<T> {
/// Allocates a new shareable logger bound to a write destination.
pub fn new<F>(time: Instant, offset: Duration, action: F) -> Self
where
F: FnMut(&Duration, &mut Vec<(Duration, T)>)+'static
{
let inner = LoggerInner {
time,
offset,
action,
buffer: Vec::with_capacity(LoggerInner::<T, F>::buffer_capacity()),
};
let inner = Rc::new(RefCell::new(inner));
Logger { inner }
}
/// Logs an event.
///
/// The event has its timestamp recorded at the moment of logging, but it may be delayed
/// due to buffering. It will be written when the logger is next flushed, either due to
/// the buffer reaching capacity or a direct call to flush.
///
/// This implementation borrows a shared (but thread-local) buffer of log events, to ensure
/// that the `action` only sees one stream of events with increasing timestamps. This may
/// have a cost that we don't entirely understand.
pub fn log<S: Into<T>>(&self, event: S) {
self.log_many(Some(event));
}
/// Logs multiple events.
///
/// The event has its timestamp recorded at the moment of logging, but it may be delayed
/// due to buffering. It will be written when the logger is next flushed, either due to
/// the buffer reaching capacity or a direct call to flush.
///
/// All events in this call will have the same timestamp. This can be more performant due
/// to fewer `time.elapsed()` calls, but it also allows some logged events to appear to be
/// "transactional", occurring at the same moment.
///
/// This implementation borrows a shared (but thread-local) buffer of log events, to ensure
/// that the `action` only sees one stream of events with increasing timestamps. This may
/// have a cost that we don't entirely understand.
pub fn log_many<I>(&self, events: I)
where I: IntoIterator, I::Item: Into<T>
{
self.inner.borrow_mut().log_many(events)
}
/// Flushes logged messages and communicates the new minimal timestamp.
pub fn flush(&mut self) {
<Self as Flush>::flush(self);
}
}
impl<T, A: ?Sized + FnMut(&Duration, &mut Vec<(Duration, T)>)> LoggerInner<T, A> {
/// The upper limit for buffers to allocate, size in bytes. [Self::buffer_capacity] converts
/// this to size in elements.
const BUFFER_SIZE_BYTES: usize = 1 << 13;
/// The maximum buffer capacity in elements. Returns a number between [Self::BUFFER_SIZE_BYTES]
/// and 1, inclusively.
// TODO: This fn is not const because it cannot depend on non-Sized generic parameters
fn buffer_capacity() -> usize {
let size = ::std::mem::size_of::<(Duration, T)>();
if size == 0 {
Self::BUFFER_SIZE_BYTES
} else if size <= Self::BUFFER_SIZE_BYTES {
Self::BUFFER_SIZE_BYTES / size
} else {
1
}
}
pub fn log_many<I>(&mut self, events: I)
where I: IntoIterator, I::Item: Into<T>
{
let elapsed = self.time.elapsed() + self.offset;
for event in events {
self.buffer.push((elapsed, event.into()));
if self.buffer.len() == self.buffer.capacity() {
// Would call `self.flush()`, but for `RefCell` panic.
(self.action)(&elapsed, &mut self.buffer);
// The buffer clear could plausibly be removed, changing the semantics but allowing users
// to do in-place updates without forcing them to take ownership.
self.buffer.clear();
let buffer_capacity = self.buffer.capacity();
if buffer_capacity < Self::buffer_capacity() {
self.buffer.reserve((buffer_capacity+1).next_power_of_two());
}
}
}
}
}
/// Flush on the *last* drop of a logger.
impl<T, A: ?Sized + FnMut(&Duration, &mut Vec<(Duration, T)>)> Drop for LoggerInner<T, A> {
fn drop(&mut self) {
// Avoid sending out empty buffers just because of drops.
if !self.buffer.is_empty() {
self.flush();
}
}
}
impl<T, A: ?Sized + FnMut(&Duration, &mut Vec<(Duration, T)>)> Debug for LoggerInner<T, A>
where
T: Debug,
{
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.debug_struct("LoggerInner")
.field("time", &self.time)
.field("offset", &self.offset)
.field("action", &"FnMut")
.field("buffer", &self.buffer)
.finish()
}
}
/// Types that can be flushed.
trait Flush {
/// Flushes buffered data.
fn flush(&mut self);
}
impl<T> Flush for Logger<T> {
fn flush(&mut self) {
self.inner.borrow_mut().flush()
}
}
impl<T, A: ?Sized + FnMut(&Duration, &mut Vec<(Duration, T)>)> Flush for LoggerInner<T, A> {
fn flush(&mut self) {
let elapsed = self.time.elapsed() + self.offset;
if !self.buffer.is_empty() {
(self.action)(&elapsed, &mut self.buffer);
self.buffer.clear();
// NB: This does not re-allocate any specific size if the buffer has been
// taken. The intent is that the geometric growth in `log_many` should be
// enough to ensure that we do not send too many small buffers, nor do we
// allocate too large buffers when they are not needed.
}
else {
// Avoid swapping resources for empty buffers.
(self.action)(&elapsed, &mut Vec::new());
}
}
}