Oct 12, 2023
diff --git a/lib/matplotlib/sphinxext/plot_directive.py b/lib/matplotlib/sphinxext/plot_directive.py
    figure. This overwrites the caption given in the content, when the plot
    is generated from a file.

 ``:filter-warning:`` : str
    When specified, will ignore warnings that match the input string, which is
    a warnings filter `message regex <msg>`_ string.

 .. _msg: https://docs.python.org/3/library/warnings.html#the-warnings-filter

 Additionally, this directive supports all the options of the `image directive
 <https://docutils.sourceforge.io/docs/ref/rst/directives.html#image>`_,
 except for ``:target:`` (since plot will add its own target).  These include
 import sys
 import textwrap
 import traceback
 import warnings

 from docutils.parsers.rst import directives, Directive
 from docutils.parsers.rst.directives.images import Image
    return directives.choice(arg, ('python', 'doctest'))


 def _option_string(arg):
    return arg if arg.strip() else False


 def mark_plot_labels(app, document):
    """
    To make plots referenceable, we need to move the reference from the
        'context': _option_context,
        'nofigs': directives.flag,
        'caption': directives.unchanged,
        }
        'filter-warning': _option_string,
    }

    def run(self):
        """Run the plot directive."""

    # make figures
    try:
        results = render_figures(code=code,
                                 code_path=source_file_name,
                                 output_dir=build_dir,
                                 output_base=output_base,
                                 context=keep_context,
                                 function_name=function_name,
                                 config=config,
                                 context_reset=context_opt == 'reset',
                                 close_figs=context_opt == 'close-figs',
                                 code_includes=source_file_includes)
        with warnings.catch_warnings(record=True) as w:
            if msg := options.get('filter-warning', False):
                warnings.filterwarnings('ignore', message=msg)

            results = render_figures(code=code,
                                     code_path=source_file_name,
                                     output_dir=build_dir,
                                     output_base=output_base,
                                     context=keep_context,
                                     function_name=function_name,
                                     config=config,
                                     context_reset=context_opt == 'reset',
                                     close_figs=context_opt == 'close-figs',
                                     code_includes=source_file_includes)
        errors = []
    except PlotError as err:
        reporter = state.memo.reporter
diff --git a/lib/matplotlib/tests/tinypages/some_plots.rst b/lib/matplotlib/tests/tinypages/some_plots.rst
 Plot 22 uses a different specific function in a file with plot commands:

 .. plot:: range6.py range10

 Plot 23 filters a missing glyph warning

 .. plot::
    :filter-warning: Glyph

    plt.text(.5, .5, "Hello 🙃 World!")
Original file line number	Diff line number	Diff line change
Expand Up		@@ -78,6 +78,12 @@
		figure. This overwrites the caption given in the content, when the plot
		is generated from a file.

		``:filter-warning:`` : str
		When specified, will ignore warnings that match the input string, which is
		a warnings filter `message regex <msg>`_ string.

		.. _msg: https://docs.python.org/3/library/warnings.html#the-warnings-filter

		Additionally, this directive supports all the options of the `image directive
		<https://docutils.sourceforge.io/docs/ref/rst/directives.html#image>`_,
		except for ``:target:`` (since plot will add its own target). These include
Expand DownExpand Up		@@ -177,6 +183,7 @@
		import sys
		import textwrap
		import traceback
		import warnings

		from docutils.parsers.rst import directives, Directive
		from docutils.parsers.rst.directives.images import Image
Expand DownExpand Up		@@ -221,6 +228,10 @@ def _option_format(arg):
		return directives.choice(arg, ('python', 'doctest'))


		def _option_string(arg):
		return arg if arg.strip() else False


		def mark_plot_labels(app, document):
		"""
		To make plots referenceable, we need to move the reference from the
Expand DownExpand Up		@@ -271,7 +282,8 @@ class PlotDirective(Directive):
		'context': _option_context,
		'nofigs': directives.flag,
		'caption': directives.unchanged,
		}
		'filter-warning': _option_string,
		}

		def run(self):
		"""Run the plot directive."""
Expand DownExpand Up		@@ -854,16 +866,20 @@ def run(arguments, content, options, state_machine, state, lineno):

		# make figures
		try:
		results = render_figures(code=code,
		code_path=source_file_name,
		output_dir=build_dir,
		output_base=output_base,
		context=keep_context,
		function_name=function_name,
		config=config,
		context_reset=context_opt == 'reset',
		close_figs=context_opt == 'close-figs',
		code_includes=source_file_includes)
		with warnings.catch_warnings(record=True) as w:
		if msg := options.get('filter-warning', False):
		warnings.filterwarnings('ignore', message=msg)

		results = render_figures(code=code,
		code_path=source_file_name,
		output_dir=build_dir,
		output_base=output_base,
		context=keep_context,
		function_name=function_name,
		config=config,
		context_reset=context_opt == 'reset',
		close_figs=context_opt == 'close-figs',
		code_includes=source_file_includes)
		errors = []
		except PlotError as err:
		reporter = state.memo.reporter
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -174,3 +174,11 @@ Plot 21 is generated via an include directive:
		Plot 22 uses a different specific function in a file with plot commands:

		.. plot:: range6.py range10

		Plot 23 filters a missing glyph warning

		.. plot::
		:filter-warning: Glyph

		plt.text(.5, .5, "Hello 🙃 World!")