The Return class is used to track the flow of objects from API call to API call. It is used by the Command class to construct return values that can be traced through a call stack.

• The Return() constructor takes two arguments, both of which are mandatory.

  1. api_func - the API function that generated this return value. This should be an instance of the function type.

  2. args - a tuple of the arguments passed to the api_func function.

• Return instances that were created with the same api_func and args parameters will compare (==) as equal.