API: make mg.show take positional variadic for input Figures

Author: tacaswell

docs/source/index.rst

@@ -164,7 +164,7 @@ explicitly available ::
 
   fig2 = Figure()
 
-  mg.show([fig1, fig2])
+  mg.show(fig1, fig2)
 
 
 which will show both figures and block until they are closed.  As part of the
@@ -186,7 +186,7 @@ Similar to `plt.ion<matplotlib.pyplot.ion>` and
 
   mg.ioff()
   print(mg.is_interactive())
-  mg.show([fig])  # will block!
+  mg.show(fig)  # will block!
 
 
 As with `plt.show<matplotlib.pyplot.show>`, you can explicitly control the
@@ -197,8 +197,8 @@ blocking behavior of `mg.show<mpl_gui.show>` via the *block* keyword argument ::
 
   fig = Figure(label='control blocking')
 
-  mg.show([fig], block=False)  # will never block
-  mg.show([fig], block=True)   # will always block
+  mg.show(fig, block=False)  # will never block
+  mg.show(fig, block=True)   # will always block
 
 
 The interactive state is shared Matplotlib and can also be controlled with

mpl_gui/__init__.py

@@ -46,13 +46,13 @@
 _log = logging.getLogger(__name__)
 
 
-def show(figs, *, block=None, timeout=0):
+def show(*figs, block=None, timeout=0):
     """
     Show the figures and maybe block.
 
     Parameters
     ----------
-    figs : List[Figure]
+    *figs : Figure
         The figures to show.  If they do not currently have a GUI aware
         canvas + manager attached they will be promoted.
 
@@ -247,7 +247,7 @@ def show_all(self, *, block=None, timeout=None):
         if timeout is None:
             timeout = self._timeout
         self._ensure_all_figures_promoted()
-        show(self.figures, block=self._block, timeout=self._timeout)
+        show(*self.figures, block=self._block, timeout=self._timeout)
 
     # alias to easy pyplot compatibility
     show = show_all
@@ -368,7 +368,7 @@ def __enter__(self):
     def __exit__(self, exc_type, exc_value, traceback):
         if exc_value is not None and not self._forgive_failure:
             return
-        show(self.figures, block=self._block, timeout=self._timeout)
+        show(*self.figures, block=self._block, timeout=self._timeout)
 
 
 # from mpl_gui import * # is a langauge miss-feature

mpl_gui/tests/test_examples.py

@@ -14,7 +14,7 @@ def test_no_pyplot():
 def test_promotion():
     fig = mg.Figure(label="test")
     assert fig.canvas.manager is None
-    mg.show([fig], block=False)
+    mg.show(*[fig], block=False)
     assert fig.canvas.manager is not None
 
 
@@ -32,7 +32,7 @@ def test_ion():
         ax = fig.subplots()
         (ln,) = ax.plot(range(5))
         ln.set_color("k")
-        mg.show([fig], timeout=1)
+        mg.show(*[fig], timeout=1)
     assert "start_event_loop" not in fig.canvas.call_info
 
 
@@ -43,7 +43,7 @@ def test_ioff():
 
 def test_timeout():
     fig = mg.Figure()
-    mg.show([fig], block=True, timeout=1)
+    mg.show(*[fig], block=True, timeout=1)
     assert "start_event_loop" in fig.canvas.call_info
 
 
@@ -89,7 +89,7 @@ def test_close_all():
 
     # test revive
     old_canvas = fig.canvas
-    mg.show([fig])
+    mg.show(fig)
     assert fig.canvas is not old_canvas