blob: d5e514f18bed6b62f80592ee351c9db211e9966e (
plain) (
blame)
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
|
# -*- test-case-name: twisted.logger.test.test_buffer -*-
# Copyright (c) Twisted Matrix Laboratories.
# See LICENSE for details.
"""
Log observer that maintains a buffer.
"""
from collections import deque
from typing import Deque, Optional
from zope.interface import implementer
from ._interfaces import ILogObserver, LogEvent
_DEFAULT_BUFFER_MAXIMUM = 64 * 1024
@implementer(ILogObserver)
class LimitedHistoryLogObserver:
"""
L{ILogObserver} that stores events in a buffer of a fixed size::
>>> from twisted.logger import LimitedHistoryLogObserver
>>> history = LimitedHistoryLogObserver(5)
>>> for n in range(10): history({'n': n})
...
>>> repeats = []
>>> history.replayTo(repeats.append)
>>> len(repeats)
5
>>> repeats
[{'n': 5}, {'n': 6}, {'n': 7}, {'n': 8}, {'n': 9}]
>>>
"""
def __init__(self, size: Optional[int] = _DEFAULT_BUFFER_MAXIMUM) -> None:
"""
@param size: The maximum number of events to buffer. If L{None}, the
buffer is unbounded.
"""
self._buffer: Deque[LogEvent] = deque(maxlen=size)
def __call__(self, event: LogEvent) -> None:
self._buffer.append(event)
def replayTo(self, otherObserver: ILogObserver) -> None:
"""
Re-play the buffered events to another log observer.
@param otherObserver: An observer to replay events to.
"""
for event in self._buffer:
otherObserver(event)
|
