Interacts for the Sage Jupyter notebook

This is mostly the same as the stock ipywidgets.interact, but with some customizations for Sage.

EXAMPLES:

sage: from sage.repl.ipython_kernel.interact import interact
sage: @interact
....: def f(x=(0,10)):
....:     pass
Interactive function <function f ...> with 1 widget
  x: IntSlider(value=5, min=0, max=10, step=1, description=u'x')
sage: f.widget.children
(IntSlider(value=5, min=0, max=10, step=1, description=u'x'), Output())
class sage.repl.ipython_kernel.interact.sage_interactive(*args, **kwds)

Bases: ipywidgets.widgets.interaction.interactive

Wrapper around the ipywidgets interactive which handles some SageNB specifics.

EXAMPLES:

sage: from sage.repl.ipython_kernel.interact import sage_interactive
sage: def myfunc(x=10, y="hello", z=None): pass
sage: sage_interactive(myfunc, x=(0,100), z=["one", "two", "three"])
Interactive function <function myfunc ...> with 3 widgets
  x: IntSlider(value=10, min=0, max=100, step=1, description=u'x')
  y: Text(value=u'hello', description=u'y')
  z: Dropdown(value='one', options=['one', 'two', 'three'], description=u'z')
signature()

Return the fixed signature of the interactive function (after a possible auto_update parameter was removed).

EXAMPLES:

sage: from sage.repl.ipython_kernel.interact import sage_interactive
sage: def myfunc(x=[1,2,3], auto_update=False): pass
sage: sage_interactive(myfunc).signature().parameters
OrderedDict([('x', <Parameter ... 'x'>)])
classmethod widget_from_iterable(abbrev, *args, **kwds)

Convert an unspecified iterable to a widget.

This behaves like in ipywidgets, except that an iterator (like a generator object) becomes a SelectionSlider.

EXAMPLES:

sage: from sage.repl.ipython_kernel.interact import sage_interactive
sage: sage_interactive.widget_from_iterable([1..5])
Dropdown(value=1, options=[1, 2, 3, 4, 5])
sage: sage_interactive.widget_from_iterable(iter([1..5]))
SelectionSlider(value=1, options=[1, 2, 3, 4, 5])
sage: sage_interactive.widget_from_iterable((1..5))
SelectionSlider(value=1, options=[1, 2, 3, 4, 5])
sage: sage_interactive.widget_from_iterable(x for x in [1..5])
SelectionSlider(value=1, options=[1, 2, 3, 4, 5])
sage: def gen():
....:     yield 1; yield 2; yield 3; yield 4; yield 5
sage: sage_interactive.widget_from_iterable(gen())
SelectionSlider(value=1, options=[1, 2, 3, 4, 5])
classmethod widget_from_single_value(abbrev, *args, **kwds)

Convert a single value (i.e. a non-iterable) to a widget.

This supports the Sage Color class. Any unknown type is changed to a string for evaluating. This is meant to support symbolic expressions like sin(x).

EXAMPLES:

sage: from sage.repl.ipython_kernel.interact import sage_interactive
sage: sage_interactive.widget_from_single_value("sin(x)")
Text(value=u'sin(x)')
sage: sage_interactive.widget_from_single_value(sin(x))
EvalText(value=u'sin(x)')
sage: from sage.plot.colors import Color
sage: sage_interactive.widget_from_single_value(Color('cornflowerblue'))
SageColorPicker(value='#6495ed')
classmethod widget_from_tuple(abbrev, *args, **kwds)

Convert a tuple to a widget.

This supports two SageNB extensions: (description, abbrev) if description is a string and (default, abbrev) if abbrev is not a single value.

Symbolic expressions are changed to a floating-point number.

EXAMPLES:

sage: from sage.repl.ipython_kernel.interact import sage_interactive
sage: sage_interactive.widget_from_tuple( (0, 10) )
IntSlider(value=5, min=0, max=10, step=1)
sage: sage_interactive.widget_from_tuple( (3, (0, 10)) )
IntSlider(value=3, min=0, max=10, step=1)
sage: sage_interactive.widget_from_tuple( (2, dict(one=1, two=2, three=3)) )
Dropdown(value=2, options={'three': 3, 'two': 2, 'one': 1})
sage: sage_interactive.widget_from_tuple( (sqrt(2), pi) )
FloatSlider(value=2.277903107981444, min=1.4142135623730951, max=3.141592653589793, step=0.1)