Make panel and panel.io lazy imports

doc/how_to/interact/interact_abbreviations.md

@@ -14,7 +14,6 @@ To use `interact`, you need to define a function that you want to explore. Here
 
 ```{pyodide}
 import panel as pn
-from panel.interact import interact
 from panel import widgets
 
 pn.extension() # for notebook
@@ -26,7 +25,7 @@ def f(x):
 When you pass this function to `interact` along with `x=10`, a slider is generated and bound to the function parameter, such that when you interact with the widget, the function is called.
 
 ```{pyodide}
-interact(f, x=10)
+pn.interact(f, x=10)
 ```
 
 When you pass an integer-valued keyword argument of `10` (`x=10`) to `interact`, it generates an integer-valued slider control with a range of `[-10,+3*10]`. In this case, `10` is an *abbreviation* for an actual slider widget:
@@ -38,7 +37,7 @@ slider_widget = widgets.IntSlider(start=-10,end=30,step=1,value=10)
 In fact, we can get the same result if we pass this `IntSlider` as the keyword argument for `x`:
 
 ```{pyodide}
-interact(f, x=slider_widget)
+pn.interact(f, x=slider_widget)
 ```
 
 This examples clarifies how `interact` processes its keyword arguments:
@@ -64,35 +63,35 @@ If a 2-tuple of integers is passed `(min,max)`, an integer-valued slider is prod
 
 
 ```{pyodide}
-interact(f, x=(0, 4))
+pn.interact(f, x=(0, 4))
 ```
 
 If a 3-tuple of integers is passed `(min,max,step)`, the step size can also be set.
 
 
 ```{pyodide}
-interact(f, x=(0, 8, 2))
+pn.interact(f, x=(0, 8, 2))
 ```
 
 A float-valued slider is produced if the elements of the tuples are floats. Here the minimum is `0.0`, the maximum is `10.0` and step size is `0.1` (the default).
 
 
 ```{pyodide}
-interact(f, x=(0.0, 10.0))
+pn.interact(f, x=(0.0, 10.0))
 ```
 
 The step size can be changed by passing a third element in the tuple.
 
 
 ```{pyodide}
-interact(f, x=(0.0, 10.0, 0.01))
+pn.interact(f, x=(0.0, 10.0, 0.01))
 ```
 
 For both integer and float-valued sliders, you can pick the initial value of the widget by supplying a default keyword argument when you define the underlying Python function. Here we set the initial value of a float slider to `5.5`.
 
 
 ```{pyodide}
-@interact(x=(0.0, 20.0, 0.5))
+@pn.interact(x=(0.0, 20.0, 0.5))
 def h(x=5.5):
     return x
 
@@ -103,28 +102,28 @@ You can also set the initial value by passing a fourth element in the tuple.
 
 
 ```{pyodide}
-interact(f, x=(0.0, 20.0, 0.5, 5.5))
+pn.interact(f, x=(0.0, 20.0, 0.5, 5.5))
 ```
 
 Use `None` as the third element to just set min, max, and value.
 
 
 ```{pyodide}
-interact(f, x=(0.0, 20.0, None, 5.5))
+pn.interact(f, x=(0.0, 20.0, None, 5.5))
 ```
 
 Dropdown menus are constructed by passing a list of strings. In this case, the strings are both used as the names in the dropdown menu UI and passed to the underlying Python function.
 
 
 ```{pyodide}
-interact(f, x=['apples', 'oranges'])
+pn.interact(f, x=['apples', 'oranges'])
 ```
 
 When working with numeric data ``interact`` will automatically add a discrete slider:
 
 
 ```{pyodide}
-interact(f, x=dict([('one', 10), ('two', 20)]))
+pn.interact(f, x=dict([('one', 10), ('two', 20)]))
 ```
 
 ## Related Resources

doc/how_to/interact/interact_fix_values.md

@@ -12,14 +12,14 @@ First, let's declare a simple function.
 
 ```{pyodide}
 import panel as pn
-from panel.interact import fixed
+from panel._interact import fixed
 pn.extension() # for notebook
 
 def f(x, y):
     return x, y
 ```
 
-Now, call `interact` using the `panel.interact.fixed` function to fix one of the values:
+Now, call `interact` using the `panel._interact.fixed` function to fix one of the values:
 
 ```{pyodide}
 pn.interact(f, x=1, y=fixed(10))

panel/__init__.py

@@ -1,121 +1,5 @@
-"""
-Panel is a high level app and dashboarding framework
-====================================================
+import lazy_loader as lazy
 
-Panel is an open-source Python library that lets you create custom
-interactive web apps and dashboards by connecting user-defined widgets
-to plots, images, tables, or text.
+__getattr__, __dir__, __all__ = lazy.attach_stub(__name__, __file__)
 
-Panel works with the tools you know and ❤️.
-
-Check out https://panel.holoviz.org/
-
-.. figure:: https://user-images.githubusercontent.com/42288570/152672367-6c239073-0ea0-4a2b-a4c0-817e8090e877.gif
-   :alt: Panel Dashboard
-
-   Panel Dashboard
-
-How to develop a Panel app in 3 simple steps
---------------------------------------------
-
-- Write the app
-
->>> import panel as pn
->>> pn.extension(sizing_mode="stretch_width", template="fast")
->>> pn.state.template.param.update(title="My Data App")
->>> pn.panel(some_python_object).servable()
-
-- Run your app
-
-$ panel serve my_script.py --dev --show
-
-or
-
-$ panel serve my_notebook.ipynb --dev --show
-
-The app will be available in your browser!
-
-- Change your code and save it
-
-The app will reload with your changes!
-
-You can also add automatic reload to jupyterlab. Check out
-https://blog.holoviz.org/panel_0.12.0.html#JupyterLab-previews
-
-To learn more about Panel check out
-https://panel.holoviz.org/getting_started/index.html
-"""
-from param import rx
-
-from . import layout  # noqa
-from . import links  # noqa
-from . import pane  # noqa
-from . import param  # noqa
-from . import pipeline  # noqa
-from . import reactive  # noqa
-from . import template  # noqa
-from . import viewable  # noqa
-from . import widgets  # noqa
-from .config import __version__, config, panel_extension as extension  # noqa
-from .depends import bind, depends  # noqa
-from .interact import interact  # noqa
-from .io import (  # noqa
-    _jupyter_server_extension_paths, cache, ipywidget, serve, state,
-)
-from .layout import (  # noqa
-    Accordion, Card, Column, Feed, FlexBox, FloatPanel, GridBox, GridSpec,
-    GridStack, HSpacer, Row, Spacer, Swipe, Tabs, VSpacer, WidgetBox,
-)
-from .pane import panel  # noqa
-from .param import Param, ReactiveExpr  # noqa
-from .template import Template  # noqa
-from .widgets import indicators, widget  # noqa
-
-from . import custom  # isort:skip noqa has to be after widgets
-from . import chat  # isort:skip noqa has to be after widgets
-
-__all__ = (
-    "__version__",
-    "Accordion",
-    "Card",
-    "chat",
-    "Column",
-    "custom",
-    "Feed",
-    "FlexBox",
-    "FloatPanel",
-    "GridBox",
-    "GridSpec",
-    "GridStack",
-    "HSpacer",
-    "Param",
-    "ReactiveExpr",
-    "Row",
-    "Spacer",
-    "Swipe",
-    "Tabs",
-    "Template",
-    "VSpacer",
-    "WidgetBox",
-    "bind",
-    "cache",
-    "config",
-    "depends",
-    "extension",
-    "indicators",
-    "interact",
-    "ipywidget",
-    "layout",
-    "links",
-    "pane",
-    "panel",
-    "param",
-    "pipeline",
-    "rx",
-    "serve",
-    "state",
-    "template",
-    "viewable",
-    "widgets",
-    "widget"
-)
+del lazy

panel/__init__.pyi

@@ -0,0 +1,114 @@
+"""
+Panel works with the tools you know and ❤️.
+
+Check out https://panel.holoviz.org/
+
+.. figure:: https://user-images.githubusercontent.com/42288570/152672367-6c239073-0ea0-4a2b-a4c0-817e8090e877.gif
+   :alt: Panel Dashboard
+
+   Panel Dashboard
+
+How to develop a Panel app in 3 simple steps
+--------------------------------------------
+
+- Write the app
+
+>>> import panel as pn
+>>> pn.extension(sizing_mode="stretch_width", template="fast")
+>>> pn.state.template.param.update(title="My Data App")
+>>> pn.panel(some_python_object).servable()
+
+- Run your app
+
+$ panel serve my_script.py --dev --show
+
+or
+
+$ panel serve my_notebook.ipynb --dev --show
+
+The app will be available in your browser!
+
+- Change your code and save it
+
+The app will reload with your changes!
+
+You can also add automatic reload to jupyterlab. Check out
+https://blog.holoviz.org/panel_0.12.0.html#JupyterLab-previews
+
+To learn more about Panel check out
+https://panel.holoviz.org/getting_started/index.html
+"""
+
+from . import (
+    layout, links, pane, param, pipeline, reactive, template, theme, viewable,
+    widgets,
+)
+from ._interact import interact
+from .config import __version__, config, extension
+from .depends import bind, depends
+from .io import (  # noqa
+    _jupyter_server_extension_paths, cache, ipywidget, serve, state,
+)
+from .layout import (
+    Accordion, Card, Column, Feed, FlexBox, FloatPanel, GridBox, GridSpec,
+    GridStack, HSpacer, Row, Spacer, Swipe, Tabs, VSpacer, WidgetBox,
+)
+from .pane import panel
+from .param import Param, ReactiveExpr, rx
+from .template import Template
+from .widgets import indicators, widget
+
+from . import custom  # isort:skip noqa has to be after widgets
+from . import chat  # isort:skip noqa has to be after widgets
+
+__all__ = [
+    "__version__",
+    "Accordion",
+    "Card",
+    "chat",
+    "Column",
+    "custom",
+    "Feed",
+    "FlexBox",
+    "FloatPanel",
+    "GridBox",
+    "GridSpec",
+    "GridStack",
+    "HSpacer",
+    "Param",
+    "ReactiveExpr",
+    "Row",
+    "Spacer",
+    "Swipe",
+    "Tabs",
+    "Template",
+    "VSpacer",
+    "WidgetBox",
+    "__version__",
+    "bind",
+    "cache",
+    "chat",
+    "config",
+    "custom",
+    "depends",
+    "extension",
+    "indicators",
+    "interact",
+    "ipywidget",
+    "layout",
+    "links",
+    "pane",
+    "panel",
+    "param",
+    "pipeline",
+    "reactive",
+    "rx",
+    "serve",
+    "state",
+    "template",
+    "theme",
+    "viewable",
+    "widget",
+    "widgets",
+    "widget"
+]

panel/compiler.py

@@ -19,6 +19,8 @@
 
 from bokeh.model import Model
 
+os.environ['EAGER_IMPORT'] = '1'
+
 from .config import config, panel_extension
 from .io.resources import RESOURCE_URLS
 from .reactive import ReactiveHTML