warnings.warn(stacklevel=...) set too low

[dangotbanned]

Coming from vega/altair#3561 (comment)

May need to experiment with the correct level, but stacklevel=1 is almost always the wrong choice.
What would be helpful is reporting the code that triggered the warning.

In short, the call to warnings.warn appears here because stacklevel=1:

C:\Users\danie\AppData\Local\hatch\env\virtual\altair\CXM7NV9I\doc\Lib\site-packages\sphinxext_altair\altairplot.py:261: UserWarning: altair-plot: C:\Users\danie\Documents\GitHub\altair\doc\user_guide\interactions\bindings_widgets.rst:45 Code Execution failed:NameError: name 'alt' is not defined
  warnings.warn(message, stacklevel=1)

sphinxext-altair/sphinxext_altair/altairplot.py

Lines 244 to 253 in 7940667

	except Exception as err:
	msg = (
	f"altair-plot: {node['rst_source']}:{node['rst_lineno']} "
	f"Code Execution failed: {type(err).__name__}: {err!s}"
	)
	if node["strict"]:
	raise ValueError(msg) from err
	else:
	warnings.warn(msg, stacklevel=1)
	raise nodes.SkipNode from err

Related

traitlets isn't involved here, but through the issue you can see the process of increasing stacklevel to find the source that raised the warning.

• maint: deprecation warning for traitlets altair#3234