somew1nd
67248c887e
Add execution incidents, action bursts and shared Flash history. Expose verification and Explorer settings with streamed check results. Support graceful cancellation, recording recovery and bundled UI resources. Add CI quality checks and clean up comments and documentation.
140 lines
4.1 KiB
Python
140 lines
4.1 KiB
Python
# Copyright 2026 Google LLC
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
import asyncio
|
|
from collections.abc import Awaitable, Callable
|
|
from functools import wraps
|
|
import inspect
|
|
from typing import Any, TypeVar, cast, overload
|
|
|
|
R = TypeVar("R")
|
|
|
|
|
|
def wrap_with_callbacks_sync(
|
|
fn: Callable[..., R],
|
|
*,
|
|
before: Callable[..., None] | None = None,
|
|
on_success: Callable[[R], None] | None = None,
|
|
on_failure: Callable[[Exception], None] | None = None,
|
|
suppress_exceptions: bool = False,
|
|
) -> Callable[..., R]:
|
|
@wraps(fn)
|
|
def wrapper(*args: Any, **kwargs: Any) -> R:
|
|
if before:
|
|
before()
|
|
try:
|
|
result = fn(*args, **kwargs)
|
|
if on_success:
|
|
on_success(result)
|
|
return result
|
|
except Exception as e:
|
|
if on_failure:
|
|
on_failure(e)
|
|
if suppress_exceptions:
|
|
return None # type: ignore
|
|
raise
|
|
|
|
return wrapper
|
|
|
|
|
|
def wrap_with_callbacks_async(
|
|
fn: Callable[..., Awaitable[R]],
|
|
*,
|
|
before: Callable[..., None] | None = None,
|
|
on_success: Callable[[R], None] | None = None,
|
|
on_failure: Callable[[Exception], None] | None = None,
|
|
suppress_exceptions: bool = False,
|
|
) -> Callable[..., Awaitable[R]]:
|
|
@wraps(fn)
|
|
async def wrapper(*args: Any, **kwargs: Any) -> R:
|
|
if before:
|
|
before()
|
|
try:
|
|
result = await fn(*args, **kwargs)
|
|
if on_success:
|
|
on_success(result)
|
|
return result
|
|
except Exception as e:
|
|
if on_failure:
|
|
on_failure(e)
|
|
if suppress_exceptions:
|
|
return None # type: ignore
|
|
raise
|
|
|
|
return wrapper
|
|
|
|
|
|
@overload
|
|
def wrap_with_callbacks(
|
|
fn: Callable[..., Awaitable[R]],
|
|
*,
|
|
before: Callable[[], None] | None = ...,
|
|
on_success: Callable[[R], None] | None = ...,
|
|
on_failure: Callable[[Exception], None] | None = ...,
|
|
suppress_exceptions: bool = ...,
|
|
) -> Callable[..., Awaitable[R]]: ...
|
|
|
|
|
|
@overload
|
|
def wrap_with_callbacks(
|
|
*,
|
|
before: Callable[..., None] | None = ...,
|
|
on_success: Callable[[Any], None] | None = ...,
|
|
on_failure: Callable[[Exception], None] | None = ...,
|
|
suppress_exceptions: bool = ...,
|
|
) -> Callable[[Callable[..., R]], Callable[..., R]]: ...
|
|
|
|
|
|
@overload
|
|
def wrap_with_callbacks(
|
|
fn: Callable[..., R],
|
|
*,
|
|
before: Callable[[], None] | None = ...,
|
|
on_success: Callable[[R], None] | None = ...,
|
|
on_failure: Callable[[Exception], None] | None = ...,
|
|
suppress_exceptions: bool = ...,
|
|
) -> Callable[..., R]: ...
|
|
|
|
|
|
def wrap_with_callbacks(
|
|
fn: Callable[..., Any] | None = None,
|
|
*,
|
|
before: Callable[[], None] | None = None,
|
|
on_success: Callable[[Any], None] | None = None,
|
|
on_failure: Callable[[Exception], None] | None = None,
|
|
suppress_exceptions: bool = False,
|
|
) -> Any:
|
|
def decorator(func: Callable[..., Any]) -> Any:
|
|
if inspect.iscoroutinefunction(func):
|
|
return wrap_with_callbacks_async(
|
|
cast(Callable[..., Awaitable[Any]], func),
|
|
before=before,
|
|
on_success=on_success,
|
|
on_failure=on_failure,
|
|
suppress_exceptions=suppress_exceptions,
|
|
)
|
|
else:
|
|
return wrap_with_callbacks_sync(
|
|
cast(Callable[..., Any], func),
|
|
before=before,
|
|
on_success=on_success,
|
|
on_failure=on_failure,
|
|
suppress_exceptions=suppress_exceptions,
|
|
)
|
|
|
|
if fn is None:
|
|
return decorator
|
|
else:
|
|
return decorator(fn)
|