0
# Timeout Management
1
2
Timeout decorators and utilities for managing operation deadlines with various timeout strategies including constant, exponential, and deadline-based timeouts.
3
4
## Capabilities
5
6
### Timeout Classes
7
8
```python { .api }
9
class TimeToDeadlineTimeout:
10
"""
11
Timeout that calculates remaining time to a fixed deadline.
12
13
Args:
14
deadline (float): Absolute deadline timestamp
15
"""
16
def __init__(self, deadline): ...
17
18
def __call__(self, func): ...
19
20
class ConstantTimeout:
21
"""
22
Deprecated: Constant timeout for each retry attempt.
23
24
Args:
25
timeout (float): Timeout duration in seconds
26
"""
27
def __init__(self, timeout): ...
28
29
class ExponentialTimeout:
30
"""
31
Deprecated: Exponentially increasing timeout.
32
33
Args:
34
initial_timeout (float): Initial timeout
35
max_timeout (float): Maximum timeout
36
multiplier (float): Timeout multiplier
37
"""
38
def __init__(self, initial_timeout, max_timeout, multiplier): ...
39
```
40
41
## Usage Examples
42
43
```python
44
from google.api_core import timeout
45
import time
46
47
# Deadline-based timeout
48
deadline_timeout = timeout.TimeToDeadlineTimeout(deadline=time.time() + 30)
49
50
@deadline_timeout
51
def operation_with_deadline():
52
# Operation must complete within deadline
53
time.sleep(10)
54
return "completed"
55
```