Traces the commands sent to the mail server, and the respective replies.
class PIMAPPITrailEventParams(object): @property def direction() -> int: ... @property def message() -> str: ... # In class PIMAP: @property def on_pi_trail() -> Callable[[PIMAPPITrailEventParams], None]: ... @on_pi_trail.setter def on_pi_trail(event_hook: Callable[[PIMAPPITrailEventParams], None]) -> None: ...
The on_pi_trail event is useful for debugging as well as learning purposes. It shows all the interaction between the client and the server, line by line, except for message header and body transfers.
The Message parameter contains the full text of the message. The Direction parameter shows the originator of the message:
|0 (Client)||The Message originates from the client.|
|1 (Server)||The Message originates from the server.|
|2 (Information)||The Message is an informative message originating from the client software (the class code).|