import inspect
from contextlib import contextmanager
from sentry_sdk.hub import Hub
from sentry_sdk.scope import Scope
if False:
from typing import Any
from typing import Optional
from typing import overload
from typing import Callable
from typing import Dict
from contextlib import ContextManager
else:
def overload(x):
return x
__all__ = []
def public(f):
__all__.append(f.__name__)
return f
def hubmethod(f):
f.__doc__ = "%s\n\n%s" % (
"Alias for `Hub.%s`" % f.__name__,
inspect.getdoc(getattr(Hub, f.__name__)),
)
return public(f)
@hubmethod
def capture_event(event, hint=None):
# type: (Dict[str, Any], Dict[str, Any]) -> Optional[str]
hub = Hub.current
if hub is not None:
return hub.capture_event(event, hint)
return None
@hubmethod
def capture_message(message, level=None):
# type: (str, Optional[Any]) -> Optional[str]
hub = Hub.current
if hub is not None:
return hub.capture_message(message, level)
return None
@hubmethod
def capture_exception(error=None):
# type: (Optional[BaseException]) -> Optional[str]
hub = Hub.current
if hub is not None:
return hub.capture_exception(error)
return None
@hubmethod
def add_breadcrumb(crumb=None, hint=None, **kwargs):
# type: (Dict[str, Any], Dict[str, Any], **Any) -> None
hub = Hub.current
if hub is not None:
return hub.add_breadcrumb(crumb, hint, **kwargs)
@overload # noqa
def configure_scope():
# type: () -> ContextManager[Scope]
pass
@overload # noqa
def configure_scope(callback):
# type: (Callable[[Scope], None]) -> None
pass
@hubmethod # noqa
def configure_scope(callback=None):
hub = Hub.current
if hub is not None:
return hub.configure_scope(callback)
elif callback is None:
@contextmanager
def inner():
yield Scope()
return inner()
else:
# returned if user provided callback
return None
@overload # noqa
def push_scope():
# type: () -> ContextManager[Scope]
pass
@overload # noqa
def push_scope(callback):
# type: (Callable[[Scope], None]) -> None
pass
@hubmethod # noqa
def push_scope(callback=None):
hub = Hub.current
if hub is not None:
return hub.push_scope(callback)
elif callback is None:
@contextmanager
def inner():
yield Scope()
return inner()
else:
# returned if user provided callback
return None
@hubmethod
def flush(timeout=None, callback=None):
hub = Hub.current
if hub is not None:
return hub.flush(timeout=timeout, callback=callback)
@hubmethod
def last_event_id():
# type: () -> Optional[str]
hub = Hub.current
if hub is not None:
return hub.last_event_id()
return None
