scoped_js
Giving an embedded program a js that is its own window.
Several Drafter programs can share one Python interpreter, each drawn in
its own iframe (the live demos on a documentation page work this way).
Pyodide's js module is the window the interpreter was started in, which
for a demo is the page around it. A demo that wrote
js.document.getElementById(...) was searching that outer page and never
found its own elements.
make_scoped_builtins builds a replacement for a program's builtins in
which import js gives the program's own window. Python looks imports up
through the builtins of the code doing the importing, so the replacement
reaches only the program it is given to: sys.modules is not touched, and
Drafter's own import js keeps meaning the interpreter's window.
This file is carried inside the browser bundle as text and run with
exec, because the bundle and the installed drafter package can be
different versions. It must not import anything from drafter.
SCOPED_MODULE_NAME = 'js'
module-attribute
The module whose import is answered with the program's own window.
make_scoped_builtins(window)
Copy the builtins, with import js pointed at a given window.
Put the result under "__builtins__" in the globals a program is run
with. Every function the program defines then imports through it, also
when the function is called later (a route run on a click).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
window
|
Any
|
The window the program is drawn in. |
required |
Returns:
| Type | Description |
|---|---|
dict[str, Any]
|
A new builtins dictionary. The real builtins are left as they are. |
Example
program_globals = {
"__name__": "__main__",
"__builtins__": make_scoped_builtins(frame_window),
}
exec("import js\njs.document.title = 'Mine'", program_globals)
make_scoped_import(window, fallback)
Build an __import__ that answers import js with a given window.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
window
|
Any
|
What |
required |
fallback
|
Callable[..., Any]
|
The |
required |
Returns:
| Type | Description |
|---|---|
Callable[..., Any]
|
The replacement |