philiprehberger-func-timeout 0.1.2

Add a timeout to any function call — sync or async

philiprehberger-func-timeout

Add a timeout to any function call — sync or async.

Install

pip install philiprehberger-func-timeout

Usage

from philiprehberger_func_timeout import timeout

Sync functions

import time

@timeout(2.0)
def slow_computation() -> str:
    time.sleep(10)
    return "done"

slow_computation()  # raises TimeoutError after 2 seconds

Async functions

@timeout(1.5)
async def fetch_data(url: str) -> str:
    await asyncio.sleep(10)
    return "data"

await fetch_data("https://example.com")  # raises TimeoutError after 1.5s

Fallback value

@timeout(2.0, fallback="default")
def risky_call() -> str:
    time.sleep(10)
    return "result"

risky_call()  # returns "default" instead of raising

Custom exception

class MyError(Exception):
    def __init__(self, seconds: float) -> None:
        super().__init__(f"Took too long: {seconds}s")

@timeout(3.0, exception=MyError)
def slow() -> None:
    time.sleep(10)

API

Function / Class	Description
timeout(seconds, *, fallback, exception)	Decorator that adds a timeout to sync or async functions
TimeoutError	Raised on timeout; has a .seconds attribute

License

MIT