Global scope setters

sentry_sdk/api.py

@@ -8,6 +8,7 @@
 
 if MYPY:
     from typing import Any
+    from typing import Dict
     from typing import Optional
     from typing import overload
     from typing import Callable
@@ -36,6 +37,11 @@ def overload(x):
     "flush",
     "last_event_id",
     "start_span",
+    "set_tag",
+    "set_context",
+    "set_extra",
+    "set_user",
+    "set_level",
 ]
 
 
@@ -48,6 +54,15 @@ def hubmethod(f):
     return f
 
 
+def scopemethod(f):
+    # type: (F) -> F
+    f.__doc__ = "%s\n\n%s" % (
+        "Alias for :py:meth:`sentry_sdk.Scope.%s`" % f.__name__,
+        inspect.getdoc(getattr(Scope, f.__name__)),
+    )
+    return f
+
+
 @hubmethod
 def capture_event(
     event,  # type: Event
@@ -163,6 +178,46 @@ def inner():
         return None
 
 
+@scopemethod  # noqa
+def set_tag(key, value):
+    # type: (str, Any) -> None
+    hub = Hub.current
+    if hub is not None:
+        hub.scope.set_tag(key, value)
+
+
+@scopemethod  # noqa
+def set_context(key, value):
+    # type: (str, Any) -> None
+    hub = Hub.current
+    if hub is not None:
+        hub.scope.set_context(key, value)
+
+
+@scopemethod  # noqa
+def set_extra(key, value):
+    # type: (str, Any) -> None
+    hub = Hub.current
+    if hub is not None:
+        hub.scope.set_extra(key, value)
+
+
+@scopemethod  # noqa
+def set_user(value):
+    # type: (Dict[str, Any]) -> None
+    hub = Hub.current
+    if hub is not None:
+        hub.scope.set_user(value)
+
+
+@scopemethod  # noqa
+def set_level(value):
+    # type: (str) -> None
+    hub = Hub.current
+    if hub is not None:
+        hub.scope.set_level(value)
+
+
 @hubmethod
 def flush(
     timeout=None,  # type: Optional[float]

sentry_sdk/hub.py

@@ -263,6 +263,12 @@ def client(self):
         """Returns the current client on the hub."""
         return self._stack[-1][0]
 
+    @property
+    def scope(self):
+        # type: () -> Scope
+        """Returns the current scope on the hub."""
+        return self._stack[-1][1]
+
     def last_event_id(self):
         # type: () -> Optional[str]
         """Returns the last event ID."""
@@ -483,8 +489,6 @@ def push_scope(  # noqa
 
         return _ScopeManager(self)
 
-    scope = push_scope
-
     def pop_scope_unsafe(self):
         # type: () -> Tuple[Optional[Client], Scope]
         """

sentry_sdk/scope.py

@@ -120,7 +120,12 @@ def clear(self):
     @_attr_setter
     def level(self, value):
         # type: (Optional[str]) -> None
-        """When set this overrides the level."""
+        """When set this overrides the level. Deprecated in favor of set_level."""
+        self._level = value
+
+    def set_level(self, value):
+        # type: (Optional[str]) -> None
+        """Sets the level for the scope."""
         self._level = value
 
     @_attr_setter
@@ -141,7 +146,12 @@ def transaction(self, value):
     @_attr_setter
     def user(self, value):
         # type: (Dict[str, Any]) -> None
-        """When set a specific user is bound to the scope."""
+        """When set a specific user is bound to the scope. Deprecated in favor of set_user."""
+        self._user = value
+
+    def set_user(self, value):
+        # type: (Dict[str, Any]) -> None
+        """Sets a user for the scope."""
         self._user = value
 
     @property