Jupyterlite extension to allow code to be pre-run in the repl app
Project description
jupyterlite-repl-prerun
Jupyterlite extension to allow code to be pre-run in the repl app
Requirements
- JupyterLab >= 3.0
Install
To install the extension, execute:
pip install jupyterlite_repl_prerun
Usage
JupyterLite allows you to embed a live REPL in a webpage. This extension allows you to specify code that should be pre-run in the REPL using the prerun
URL parameter. For example, when using the pyodide
kernel, you can use this extension to install a package not included by default in pyodide
or to set configuration variables.
Example:
<iframe
src="https://jupyterlite-repl-prerun.rtfd.io/en/latest/lite/repl/index.html?kernel=python&prerun=import%20numpy%20as%20np&prerun-code=print(np.pi)"
width="100%"
height="100%"
></iframe>
To launch this example, click the JupyterLite badge at the top of this page.
Note that if you also want to include code to be displayed and run in the REPL, you can use the prerun-code
URL parameter. For example, the URL above will pre-run the code to import numpy
and then display and run the code to print pi
. prerun-code
replaces the usual JupyterLite code
parameter, which cannot be combined with prerun
.
To encode a, potentially multi-line, string in a URL, you can use an online
URL encoder. Or you can use the urllib.parse.quote
function in Python. For example, assuming that the code you want to pre-run is in a file prerun.py
, you can use the following command to encode the contents of the file:
CODE_FROM_PRERUN_DOT_PY=$(python -c "import urllib.parse; f= open('prerun.py','r'); out= [urllib.parse.quote(line,safe='')+'%0A' for line in f.readlines() if line[0] != '#']; f.close(); print(''.join(out))")
Use in your own JupyterLite deployment
You can add this extension to your own JupyterLite deployment by installing the extension into the environment you are using to build the JupyterLite deployment. Look at the JupyterLite documentation on adding extensions.
Uninstall
To remove the extension, execute:
pip uninstall jupyterlite_repl_prerun
Contributing
Development install
Note: You will need NodeJS to build the extension package.
The jlpm
command is JupyterLab's pinned version of
yarn that is installed with JupyterLab. You may use
yarn
or npm
in lieu of jlpm
below.
# Clone the repo to your local environment
# Change directory to the jupyterlite_repl_prerun directory
# Install package in development mode
pip install -e "."
# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite
# Rebuild extension Typescript source after making changes
jlpm build
You can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.
# Watch the source directory in one terminal, automatically rebuilding when needed
jlpm watch
# Run JupyterLab in another terminal
jupyter lab
With the watch command running, every saved change will immediately be built locally and available in your running JupyterLab. Refresh JupyterLab to load the change in your browser (you may need to wait several seconds for the extension to be rebuilt).
By default, the jlpm build
command generates the source maps for this extension to make it easier to debug using the browser dev tools. To also generate source maps for the JupyterLab core extensions, you can run the following command:
jupyter lab build --minimize=False
Development uninstall
pip uninstall jupyterlite_repl_prerun
In development mode, you will also need to remove the symlink created by jupyter labextension develop
command. To find its location, you can run jupyter labextension list
to figure out where the labextensions
folder is located. Then you can remove the symlink named jupyterlite-repl-prerun
within that folder.
Packaging the extension
See RELEASE
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for jupyterlite_repl_prerun-0.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8bebebb772a1e8ee693b23b25527b80ebd945952e3561398f4c86f5a31e4a6f3 |
|
MD5 | 0c0efd44e55d0f90c9478ef88134b921 |
|
BLAKE2b-256 | d4b1d2b88ee8a4fc3a52aae15c7983a2a7d386218107819c17725508b9ebf108 |
Hashes for jupyterlite_repl_prerun-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0a33b2d833e81755525ad36a852ad7f018499c6b287c032e3112cdc78ff6a6db |
|
MD5 | 14d922d86ddbe43b41fa309b8d6623ff |
|
BLAKE2b-256 | da694a67fa7efceef209b1855337c09dff0fbd93eb36cb4e50d44a92a83d5bca |