diff --git a/Makefile b/Makefile index 32cdbb1fff..ac0ef51f5f 100644 --- a/Makefile +++ b/Makefile @@ -51,6 +51,7 @@ lint: .venv apidocs: .venv @$(VENV_PATH)/bin/pip install --editable . @$(VENV_PATH)/bin/pip install -U -r ./docs-requirements.txt + rm -rf docs/_build @$(VENV_PATH)/bin/sphinx-build -vv -W -b html docs/ docs/_build .PHONY: apidocs diff --git a/sentry_sdk/scope.py b/sentry_sdk/scope.py index 80537cd8bf..cd974e4a52 100644 --- a/sentry_sdk/scope.py +++ b/sentry_sdk/scope.py @@ -441,13 +441,28 @@ def clear(self): @_attr_setter def level(self, value): - # type: (Optional[LogLevelStr]) -> None - """When set this overrides the level. Deprecated in favor of set_level.""" + # type: (LogLevelStr) -> None + """ + When set this overrides the level. + + .. deprecated:: 1.0.0 + Use :func:`set_level` instead. + + :param value: The level to set. + """ + logger.warning( + "Deprecated: use .set_level() instead. This will be removed in the future." + ) + self._level = value def set_level(self, value): - # type: (Optional[LogLevelStr]) -> None - """Sets the level for the scope.""" + # type: (LogLevelStr) -> None + """ + Sets the level for the scope. + + :param value: The level to set. + """ self._level = value @_attr_setter @@ -555,20 +570,24 @@ def profile(self, profile): self._profile = profile - def set_tag( - self, - key, # type: str - value, # type: Any - ): - # type: (...) -> None - """Sets a tag for a key to a specific value.""" + def set_tag(self, key, value): + # type: (str, Any) -> None + """ + Sets a tag for a key to a specific value. + + :param key: Key of the tag to set. + + :param value: Value of the tag to set. + """ self._tags[key] = value - def remove_tag( - self, key # type: str - ): - # type: (...) -> None - """Removes a specific tag.""" + def remove_tag(self, key): + # type: (str) -> None + """ + Removes a specific tag. + + :param key: Key of the tag to remove. + """ self._tags.pop(key, None) def set_context( @@ -577,7 +596,9 @@ def set_context( value, # type: Dict[str, Any] ): # type: (...) -> None - """Binds a context at a certain key to a specific value.""" + """ + Binds a context at a certain key to a specific value. + """ self._contexts[key] = value def remove_context(