From d5e07862ec8b6368c98f649d6c6091b06cdae468 Mon Sep 17 00:00:00 2001 From: Vinay Sajip Date: Thu, 8 Sep 2022 08:22:33 +0100 Subject: gh-88287: Add BufferingFormatter documentation. (GH-96608) --- Doc/library/logging.rst | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index c3806b6..8793627 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -662,6 +662,35 @@ Formatter Objects :func:`traceback.print_stack`, but with the last newline removed) as a string. This default implementation just returns the input value. +.. class:: BufferingFormatter(linefmt=None) + + A base formatter class suitable for subclassing when you want to format a + number of records. You can pass a :class:`Formatter` instance which you want + to use to format each line (that corresponds to a single record). If not + specified, the default formatter (which just outputs the event message) is + used as the line formatter. + + .. method:: formatHeader(records) + + Return a header for a list of *records*. The base implementation just + returns the empty string. You will need to override this method if you + want specific behaviour, e.g. to show the count of records, a title or a + separator line. + + .. method:: formatFooter(records) + + Return a footer for a list of *records*. The base implementation just + returns the empty string. You will need to override this method if you + want specific behaviour, e.g. to show the count of records or a separator + line. + + .. method:: format(records) + + Return formatted text for a list of *records*. The base implementation + just returns the empty string if there are no records; otherwise, it + returns the concatenation of the header, each record formatted with the + line formatter, and the footer. + .. _filter: Filter Objects -- cgit v0.12