René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Bug]: revealed type for `Figure.subfigures` is not correct","articleBody":"### Bug summary\n\nThe overloads for `subfigures` aren't quite correct\n\nThe issue is that\n\nhttps://github.com/matplotlib/matplotlib/blob/4af03f44b6be8dce3651d7a93a593e110998dbe1/lib/matplotlib/figure.py#L1604\n\nhas `squeeze=True` as the default, but the first overload incorrectly notes `False` as the default\n\nhttps://github.com/matplotlib/matplotlib/blob/1295158096805f6675cbb42f982ff6c1402e9ba7/lib/matplotlib/figure.pyi#L193-L204\n\n### Code for reproduction\n\n```Python\nimport matplotlib.pyplot as plt\nfrom typing import reveal_type\n\nfig = plt.figure(layout='constrained', figsize=(10, 4))\n\nreveal_type(fig.subfigures(1, 2, wspace=0.07))\nreveal_type(fig.subfigures(1, 1, wspace=0.07))\n\nreveal_type(fig.subfigures(1, 2, wspace=0.07, squeeze=True))\nreveal_type(fig.subfigures(1, 1, wspace=0.07, squeeze=True))\n```\n\n### Actual outcome\n\n(running the above with mypy)\n\n```\nt.py:6: note: Revealed type is \"numpy.ndarray[builtins.tuple[Any, ...], numpy.dtype[Any]]\"\nt.py:7: note: Revealed type is \"numpy.ndarray[builtins.tuple[Any, ...], numpy.dtype[Any]]\"\nt.py:9: note: Revealed type is \"Union[numpy.ndarray[builtins.tuple[Any, ...], numpy.dtype[Any]], matplotlib.figure.SubFigure]\"\nt.py:10: note: Revealed type is \"Union[numpy.ndarray[builtins.tuple[Any, ...], numpy.dtype[Any]], matplotlib.figure.SubFigure]\"\n```\n\nNote that the reveal types differ, even though `squeeze=True` is the default\n\n### Expected outcome\n\n```\nt.py:6: note: Revealed type is \"Union[numpy.ndarray[builtins.tuple[Any, ...], numpy.dtype[Any]], matplotlib.figure.SubFigure]\"\nt.py:7: note: Revealed type is \"Union[numpy.ndarray[builtins.tuple[Any, ...], numpy.dtype[Any]], matplotlib.figure.SubFigure]\"\nt.py:9: note: Revealed type is \"Union[numpy.ndarray[builtins.tuple[Any, ...], numpy.dtype[Any]], matplotlib.figure.SubFigure]\"\nt.py:10: note: Revealed type is \"Union[numpy.ndarray[builtins.tuple[Any, ...], numpy.dtype[Any]], matplotlib.figure.SubFigure]\"\n```\n\n### Additional information\n\n_No response_\n\n### Operating system\n\n_No response_\n\n### Matplotlib Version\n\n3.10.3\n\n### Matplotlib Backend\n\n_No response_\n\n### Python version\n\n3.12\n\n### Jupyter version\n\n_No response_\n\n### Installation\n\npip","author":{"url":"https://github.com/MarcoGorelli","@type":"Person","name":"MarcoGorelli"},"datePublished":"2025-07-15T13:00:18.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/30313/matplotlib/issues/30313"}