TransferObject¶

class jetstream.helper.TransferObject(api, destinationId, transferId)¶

Parameters:	api – A JetStream API interface, as constructed from `api()`. This must be a connected and authenticated API for the server that is sending the transfer. destinationId – The `DestinationId` (as returned from `createDestination()`) to which the transfer is being sent. transferId – The `TransferId` (as returned from `createTransfer()`) for the transfer.

Method Summary¶

`getProgress`	Returns a percentage (0 - 100) representing the current progress for the transfer.
`getRawStats`	Returns a Transfer Structure containing the full description for the transfer.
`getStatus`	Returns a string describing the current status for the transfer.

Method Documentation¶

TransferObject.getProgress()¶

Returns a percentage (0 - 100) representing the current progress for the transfer.

This value alone does not necessarily reflect whether the transfer has finished, or has failed. Compare getStatus().

Returns:	A percentage (0.0 - 100.0) representing the current progress for the transfer.
Return type:	float

TransferObject.getRawStats()¶

Returns a Transfer Structure containing the full description for the transfer.

Returns:	Transfer Structure containing the full description for the transfer.
Return type:	dict

TransferObject.getStatus()¶

Returns a string describing the current status for the transfer. This string represents the “status”, extracted from the Transfer Structure. Compare getRawStats().

The status “complete” indicates that the transfer has finished successfully.

The status “error” indicates that the transfer has failed. Use getRawStats() to retrieve the full Transfer Structure. Its errorMessage will describe the cause of the error.

Other strings may be used to represent the progression of the transfer.

Returns:	A string describing the current status for the transfer.
Return type:	string