#!/usr/bin/env python3
+# © Copyright 2021-2022, Scott Gasch
+
+"""This is a helper class that tries to define every __dunder__ method
+so as to defer that evaluation of an object as long as possible. It
+is used by smart_future.py as a base class.
+
+"""
+
from abc import ABC, abstractmethod
from typing import Any, Generic, TypeVar
class DeferredOperand(ABC, Generic[T]):
"""A wrapper around an operand whose value is deferred until it is
- needed. See subclass SmartFuture for an example usage.
+ needed (i.e. accessed). See the subclass :class:`SmartFuture` for
+ an example usage and/or a more useful patten.
"""
@abstractmethod
- def _resolve(self) -> T:
+ def _resolve(self, timeout=None) -> T:
pass
@staticmethod
return DeferredOperand.resolve(self) is DeferredOperand.resolve(other)
def is_not(self, other):
- return DeferredOperand.resolve(self) is not DeferredOperand.resolve(
- other
- )
+ return DeferredOperand.resolve(self) is not DeferredOperand.resolve(other)
def __abs__(self):
return abs(DeferredOperand.resolve(self))
def __getattr__(self, method_name):
def method(*args, **kwargs):
- return getattr(DeferredOperand.resolve(self), method_name)(
- *args, **kwargs
- )
+ return getattr(DeferredOperand.resolve(self), method_name)(*args, **kwargs)
return method