on_transfer Event
Fired during file download/upload.
Syntax
class FTPTransferEventParams(object): @property def direction() -> int: ... @property def bytes_transferred() -> int: ... @property def percent_done() -> int: ... @property def text() -> bytes: ... # In class FTP: @property def on_transfer() -> Callable[[FTPTransferEventParams], None]: ... @on_transfer.setter def on_transfer(event_hook: Callable[[FTPTransferEventParams], None]) -> None: ...
Remarks
One or more on_transfer events are fired during file transfer. The BytesTransferred parameter shows the number of bytes transferred since the beginning of the transfer.
Text contains the portion of the file data being delivered.
The Direction parameter shows whether the client (0) or the server (1) is sending the data.
The PercentDone parameter shows the progress of the transfer in the corresponding direction. If PercentDone can not be calculated the value will be -1.
Note that events are not re-entrant. Performing time consuming operations within this event will prevent it from firing again in a timely manner and may impact overall performance.