Class Future (2.21.0)

Version 2.21.0

• 2.27.1 (latest)
• 2.27.0
• 2.26.1
• 2.25.2
• 2.23.1
• 2.22.0
• 2.21.5
• 2.20.3
• 2.19.8
• 2.18.4
• 2.17.1
• 2.16.1
• 2.15.2
• 2.14.1
• 2.13.12
• 2.12.1
• 2.11.1
• 2.10.0
• 2.9.0
• 2.8.0
• 2.7.1
• 2.6.1
• 2.5.0
• 2.4.2
• 2.3.0
• 2.2.0
• 2.1.0
• 2.0.0
• 1.7.2
• 1.6.1
• 1.5.0
• 1.4.3
• 1.3.1
• 1.2.0
• 1.1.0
• 1.0.2
• 0.45.0
• 0.44.0
• 0.43.0

Future()

This future object is returned from asychronous Pub/Sub publishing calls.

Calling result will resolve the future by returning the message ID, unless an error occurs.

Methods

Future

Future()

Initializes the future. Should not be called by clients.

add_done_callback

add_done_callback(
    callback: typing.Callable[[pubsub_v1.publisher.futures.Future], typing.Any]
) -> None

Attach a callable that will be called when the future finishes.

Parameter
Name	Description
callback	typing.Callable[[pubsub_v1.publisher.futures.Future], typing.Any] A callable that will be called with this future as its only argument when the future completes or is cancelled. The callable will always be called by a thread in the same process in which it was added. If the future has already completed or been cancelled then the callable will be called immediately. These callables are called in the order that they were added.

cancel

cancel() -> bool

Actions in Pub/Sub generally may not be canceled.

This method always returns False.

cancelled

cancelled() -> bool

Actions in Pub/Sub generally may not be canceled.

This method always returns False.

done

done()

Return True if the future was cancelled or finished executing.

exception

exception(timeout=None)

Return the exception raised by the call that the future represents.

Exceptions
Type	Description
CancelledError	If the future was cancelled.
TimeoutError	If the future didn't finish executing before the given timeout.

result

result(timeout: typing.Optional[typing.Union[int, float]] = None) -> str

Return the message ID or raise an exception.

This blocks until the message has been published successfully and returns the message ID unless an exception is raised.

Parameter
Name	Description
timeout	typing.Union[int, float] The number of seconds before this call times out and raises TimeoutError.

Exceptions
Type	Description
concurrent.futures.TimeoutError	If the request times out.
Exception	For undefined exceptions in the underlying call execution.

running

running() -> bool

Return True if the associated Pub/Sub action has not yet completed.

set_exception

set_exception(exception: typing.Optional[BaseException])

Set the result of the future as being the given exception.

Do not use this method, it should only be used internally by the library and its unit tests.

set_result

set_result(result: typing.Any)

Set the return value of work associated with the future.

Do not use this method, it should only be used internally by the library and its unit tests.

set_running_or_notify_cancel

set_running_or_notify_cancel() -> typing.NoReturn

Mark the future as running or process any cancel notifications.

Should only be used by Executor implementations and unit tests.

If the future has been cancelled (cancel() was called and returned True) then any threads waiting on the future completing (though calls to as_completed() or wait()) are notified and False is returned.

If the future was not cancelled then it is put in the running state (future calls to running() will return True) and True is returned.

This method should be called by Executor implementations before executing the work associated with this future. If this method returns False then the work should not be executed.

Exceptions
Type	Description
RuntimeError	if this method was already called or if set_result() or set_exception() was called.