class documentation

File-like object that turns write() calls into logging events.

Note that because event formats are str, bytes received via write() are converted to str, which is the opposite of what file does.

Method __init__ No summary
Method close Close this file so it can no longer be written to.
Method fileno Returns an invalid file descriptor, since this is not backed by an FD.
Method flush No-op; this file does not buffer.
Method isatty A LoggingFile is not a TTY.
Method softspace.setter Undocumented
Method write Log the given message.
Method writelines Log each of the given lines as a separate message.
Instance Variable level Undocumented
Instance Variable log Undocumented
Property closed Read-only property. Is the file closed?
Property encoding Read-only property. File encoding.
Property mode Read-only property. File mode.
Property name The name of this file; a repr-style string giving information about its namespace.
Property newlines Read-only property. Types of newlines encountered.
Property softspace Undocumented
Method _unsupported Template for unsupported operations.
Instance Variable _buffer Undocumented
Instance Variable _closed Undocumented
Instance Variable _encoding Undocumented
Instance Variable _softspace Undocumented
def __init__(self, logger: Logger, level: NamedConstant = LogLevel.info, encoding: str | None = None): (source)
Parameters
logger:Loggerthe logger to log through.
level:NamedConstantthe log level to emit events with.
encoding:str | NoneThe encoding to expect when receiving bytes via write(). If None, use sys.getdefaultencoding().
def close(self): (source)

Close this file so it can no longer be written to.

def fileno(self) -> int: (source)

Returns an invalid file descriptor, since this is not backed by an FD.

Returns
int-1
def flush(self): (source)

No-op; this file does not buffer.

def isatty(self) -> bool: (source)

A LoggingFile is not a TTY.

Returns
boolFalse
@softspace.setter
def softspace(self, value): (source)

Undocumented

def write(self, message: AnyStr): (source)

Log the given message.

Parameters
message:AnyStrThe message to write.
def writelines(self, lines: Iterable[AnyStr]): (source)

Log each of the given lines as a separate message.

Parameters
lines:Iterable[AnyStr]Data to write.

Undocumented

Undocumented

Read-only property. Is the file closed?

Read-only property. File encoding.

Read-only property. File mode.

The name of this file; a repr-style string giving information about its namespace.

Read-only property. Types of newlines encountered.

@deprecatedProperty(Version('Twisted', 21, 2, 0))
softspace = (source)

Deprecated since version 21.2.0: softspace was deprecated in Twisted 21.2.0.

Undocumented

def _unsupported(self, *args: object): (source)

Template for unsupported operations.

Parameters
*args:objectArguments.

Undocumented

Undocumented

_encoding = (source)

Undocumented

_softspace = (source)

Undocumented