Public Member Functions | Private Attributes | List of all members
grpc_testing._time._Future Class Reference
Inheritance diagram for grpc_testing._time._Future:
Inheritance graph
[legend]

Public Member Functions

def __init__ (self, state, behavior, time)
 
def add_done_callback (self, fn)
 
def cancel (self)
 
def cancelled (self)
 
def done (self)
 
def exception (self, timeout=None)
 
def result (self, timeout=None)
 
def running (self)
 
def traceback (self, timeout=None)
 

Private Attributes

 _behavior
 
 _cancelled
 
 _state
 
 _time
 

Detailed Description

Definition at line 80 of file _time.py.

Constructor & Destructor Documentation

◆ __init__()

def grpc_testing._time._Future.__init__ (   self,
  state,
  behavior,
  time 
)

Definition at line 82 of file _time.py.

Member Function Documentation

◆ add_done_callback()

def grpc_testing._time._Future.add_done_callback (   self,
  fn 
)
Adds a function to be called at completion of the computation.

The callback will be passed this Future object describing the outcome
of the computation.  Callbacks will be invoked after the future is
terminated, whether successfully or not.

If the computation has already completed, the callback will be called
immediately.

Exceptions raised in the callback will be logged at ERROR level, but
will not terminate any threads of execution.

Args:
  fn: A callable taking this Future object as its single parameter.

Reimplemented from grpc.Future.

Definition at line 124 of file _time.py.

◆ cancel()

def grpc_testing._time._Future.cancel (   self)
Attempts to cancel the computation.

This method does not block.

Returns:
    bool:
    Returns True if the computation was canceled.

    Returns False under all other circumstances, for example:

    1. computation has begun and could not be canceled.
    2. computation has finished
    3. computation is scheduled for execution and it is impossible
to determine its state without blocking.

Reimplemented from grpc.Future.

Definition at line 88 of file _time.py.

◆ cancelled()

def grpc_testing._time._Future.cancelled (   self)
Describes whether the computation was cancelled.

This method does not block.

Returns:
    bool:
    Returns True if the computation was cancelled before its result became
    available.

    Returns False under all other circumstances, for example:

    1. computation was not cancelled.
    2. computation's result is available.

Reimplemented from grpc.Future.

Definition at line 105 of file _time.py.

◆ done()

def grpc_testing._time._Future.done (   self)
Describes whether the computation has taken place.

This method does not block.

Returns:
    bool:
    Returns True if the computation already executed or was cancelled.
    Returns False if the computation is scheduled for execution or
    currently executing.
    This is exactly opposite of the running() method's result.

Reimplemented from grpc.Future.

Definition at line 112 of file _time.py.

◆ exception()

def grpc_testing._time._Future.exception (   self,
  timeout = None 
)
Return the exception raised by the computation.

This method may return immediately or may block.

Args:
  timeout: The length of time in seconds to wait for the computation to
    terminate or be cancelled. If None, the call will block until the
    computations's termination.

Returns:
    The exception raised by the computation, or None if the computation
    did not raise an exception.

Raises:
  FutureTimeoutError: If a timeout value is passed and the computation
    does not terminate within the allotted time.
  FutureCancelledError: If the computation was cancelled.

Reimplemented from grpc.Future.

Definition at line 118 of file _time.py.

◆ result()

def grpc_testing._time._Future.result (   self,
  timeout = None 
)
Returns the result of the computation or raises its exception.

This method may return immediately or may block.

Args:
  timeout: The length of time in seconds to wait for the computation to
    finish or be cancelled. If None, the call will block until the
    computations's termination.

Returns:
  The return value of the computation.

Raises:
  FutureTimeoutError: If a timeout value is passed and the computation
    does not terminate within the allotted time.
  FutureCancelledError: If the computation was cancelled.
  Exception: If the computation raised an exception, this call will
    raise the same exception.

Reimplemented from grpc.Future.

Definition at line 115 of file _time.py.

◆ running()

def grpc_testing._time._Future.running (   self)
Describes whether the computation is taking place.

This method does not block.

Returns:
    Returns True if the computation is scheduled for execution or
    currently executing.

    Returns False if the computation already executed or was cancelled.

Reimplemented from grpc.Future.

Definition at line 109 of file _time.py.

◆ traceback()

def grpc_testing._time._Future.traceback (   self,
  timeout = None 
)
Access the traceback of the exception raised by the computation.

This method may return immediately or may block.

Args:
  timeout: The length of time in seconds to wait for the computation
    to terminate or be cancelled. If None, the call will block until
    the computation's termination.

Returns:
    The traceback of the exception raised by the computation, or None
    if the computation did not raise an exception.

Raises:
  FutureTimeoutError: If a timeout value is passed and the computation
    does not terminate within the allotted time.
  FutureCancelledError: If the computation was cancelled.

Reimplemented from grpc.Future.

Definition at line 121 of file _time.py.

Member Data Documentation

◆ _behavior

grpc_testing._time._Future._behavior
private

Definition at line 84 of file _time.py.

◆ _cancelled

grpc_testing._time._Future._cancelled
private

Definition at line 86 of file _time.py.

◆ _state

grpc_testing._time._Future._state
private

Definition at line 83 of file _time.py.

◆ _time

grpc_testing._time._Future._time
private

Definition at line 85 of file _time.py.


The documentation for this class was generated from the following file:


grpc
Author(s):
autogenerated on Fri May 16 2025 03:03:40