hMh, n d Z ddlZddlZddlmZmZmZ ddlm Z ddl
m Z ddl m
Z
dZd Zd
Zd Zd Zd
Zde
z Zde
z Zi Zded< ded< d Zd!dZd Zd"dZ e e d#d Z ej dej Z d Z e e d$d Z e e d%d Z!dS )&zB
Functions for generating embeddable HTML/javascript of a widget.
N )Widget DOMWidgetwidget)Link) doc_subst)__html_manager_version__zg
{load}
{widget_views}
z-a2
z`
{widget_views}
z
{title}
{snippet}
zNzKhttps://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@%s/dist/embed.jszOhttps://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@%s/dist/embed-amd.jsz
views: widget or collection of widgets or None
The widgets to include views for. If None, all DOMWidgets are
included (not just the displayed ones).
views_attributeay
drop_defaults: boolean
Whether to drop default values from the widget states.
state: dict or None (default)
The state to include. When set to None, the state of all widgets
know to the widget manager is included. Otherwise it uses the
passed state directly. This allows for end users to include a
smaller state, under the responsibility that this state is
sufficient to reconstruct the embedded views.
indent: integer, string or None
The indent to use for the JSON state dump. See `json.dumps` for
full description.
embed_url: string or None
Allows for overriding the URL used to fetch the widget manager
for the embedded code. This defaults (None) to a `jsDelivr` CDN url.
requirejs: boolean (True)
Enables the requirejs-based embedding, which allows for custom widgets.
If True, the embed_url should point to an AMD module.
cors: boolean (True)
If True avoids sending user credentials while requesting the scripts.
When opening an HTML file from disk, some browsers may refuse to load
the scripts.
embed_kwargsc # K t | }|D ]}t | | }t |t r|V ,t |t
t f r |D ]}t |t r|V gt |t r0| D ]}t |t r|V dS )z4Find references to other widgets in a widget's stateN)tuplekeysgetattr
isinstancer listdictvalues)r stater keyvalueitems P/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/ipywidgets/embed.py_find_widget_refs_by_stater _ s D $$ eV $ $ KKKK e}
-
-
dF++ JJJ
t
$
$
dF++ JJJ Fc |t }| | }||| j < t | |d D ] }|j |vrt ||| |S )zLGets the embed state of a widget, and all other widgets it refers to as wellN
drop_defaultsr )r _get_embed_statemodel_idr _get_recursive_state)r storer r refs r r r t s{ } # #- # @ @E "E&/ *&%.AA J J (>}Q (E11fmA6F6OSX6X6X)/)@)@})@)])]fo&^ ^r Tc | t j |d d }nL | d n# t t f$ r | g} Y nw xY wi }| D ]}t ||| t || |S )af Get the state of all widgets specified, and their dependencies.
This uses a simple dependency finder, including:
- any widget directly referenced in the state of an included widget
- any widget in a list/tuple attribute in the state of an included widget
- any widget in a dict attribute in the state of an included widget
- any jslink/jsdlink between two included widgets
What this alogorithm does not do:
- Find widget references in nested list/dict structures
- Find widget references in other types of attributes
Note that this searches the state of the widgets for references, so if
a widget reference is not included in the serialized state, it won't
be considered as a dependency.
Parameters
----------
widgets: single widget or list of widgets.
This function will return the state of every widget mentioned
and of all their dependencies.
drop_defaults: boolean
Whether to drop default values from the widget states.
Returns
-------
A dictionary with the state of the widgets and any widget they
depend on.
Nr widgetsr r )r get_manager_state
IndexError TypeErrorr r* )r- r r r s r dependency_stater1 s < (}dSSST[\ AJJJI& iGGG ? ?F
> > > >5-000 Ls * A Ac J | )d t j D } n$ | d n# t t f$ r | g} Y nw xY w| t j |d d }t j g }||d< d | D }t || S ) a) Gets data for embedding.
Use this to get the raw data for embedding if you have special
formatting needs.
Parameters
----------
{views_attribute}
drop_defaults: boolean
Whether to drop default values from the widget states.
state: dict or None (default)
The state to include. When set to None, the state of all widgets
know to the widget manager is included. Otherwise it uses the
passed state directly. This allows for end users to include a
smaller state, under the responsibility that this state is
sufficient to reconstruct the embedded views.
Returns
-------
A dictionary with the following entries:
manager_state: dict of the widget manager state data
view_specs: a list of widget view specs
Nc < g | ]}t |t |S )r r .0ws r
z embed_data.. s' ZZZqAyAYAYZZZZr r r, r )r- c 6 g | ]}| S r4 )
get_view_specr5 s r r8 z embed_data.. s" 333!//##333r )
manager_state
view_specs)r$ r% r r/ r0 r r. r )viewsr r json_datar< s r
embed_datar? s 2
}ZZM 4 ; ; = =ZZZ !HHHI& GEEE
}(}dSSST[\ (444I Ig33U333J iJ ? ? ??s 6 A
A
z<(script|/script|!--)c 8 t d| S )a Escape a string that will be the content of an HTML script tag.
We replace the opening bracket of ` tags.
)r r
c 3 K | ]>}t t t j | V ?dS )) view_specN)widget_view_templateformatrD jsondumps)r6 rI s r z embed_snippet..
sY ##mDJy widget_viewsr4 ) r? joinDEFAULT_EMBED_REQUIREJS_URLDEFAULT_EMBED_SCRIPT_URLload_requirejs_template
load_templaterK rD rL rM snippet_template) r= r r rR rP requirejscorsdatarT rS rQ r s r
embed_snippetr^ s * e= F F FD99 l+ L
3<Z//BZ &/ B " "]D-19))rH i( CC"4:d?.CF#S#S#STT$ F " , ,V , ,,r IPyWidget exportc t |fi |}||d}|t } |j di |}t | d r| | dS t | d 5 }| | ddd dS # 1 swxY w Y dS )a Write a minimal HTML file with widget views embedded.
Parameters
----------
fp: filename or file-like object
The file to write the HTML output to.
{views_attribute}
title: title of the html page.
template: Template in which to embed the widget state.
This should be a Python string with placeholders
`{{title}}` and `{{snippet}}`. The `{{snippet}}` placeholder
will be replaced by all the widgets.
{embed_kwargs}
)titlesnippetNwriter7 r4 )r^
html_templaterK hasattrrc open) fpr= ra templatekwargsrb r html_codefs r embed_minimal_htmlrl s E,,V,,G F ))&))I r7
"c]] a
GGI s BB
B)NF)T)TN)TNrE NTT)r_ N)"__doc__rL rer- r r r r$ widgets.widget_linkr widgets.docutilsr _versionr rZ rY rX requirejs_snippet_templaterd rJ rW rV
_doc_snippetsr r r* r1 r? compile
IGNORECASErA rD r^ rl r4 r r rv s ? ? ? ? ? ? ? ? ? ? % % % % % % ' ' ' ' ' ' . . . . . . D
i jB B o qI I
$
!
n 2 * ^ ^ ^+ + + +\ =+@ +@ +@ +@Z 2: 6
FF
1
1
1 = $
'- '- '- '-T = r