simple, custom Jupyter widgets
Project description
anywidget 
custom jupyter widgets made easy
- create widgets without complicated cookiecutter templates
- publish to PyPI like any other Python package
- prototype within
.ipynbor.pyfiles - run in Jupyter, JupyterLab, Google Colab, VSCode, and more
- develop (optionally) with Vite for instant HMR
Installation
pip install anywidget
Usage
import anywidget
import traitlets
ESM = """
export function render(view) {
let count = () => view.model.get("value");
let btn = document.createElement("button");
btn.innerHTML = `count is ${count()}`;
btn.addEventListener("click", () => {
view.model.set("value", count() + 1);
view.model.save_changes();
});
view.model.on("change:value", () => {
btn.innerHTML = `count is ${count()}`;
});
view.el.appendChild(btn);
}
"""
class CounterWidget(anywidget.AnyWidget):
_esm = ESM
value = traitlets.Int(0).tag(sync=True)
CounterWidget()
Development
pip install -e .
If you are using the classic Jupyter Notebook you need to install the nbextension:
jupyter nbextension install --py --symlink --sys-prefix anywidget
jupyter nbextension enable --py --sys-prefix anywidget
Note for developers:
- the
-epip option allows one to modify the Python code in-place. Restart the kernel in order to see the changes. - the
--symlinkargument on Linux or OS X allows one to modify the JavaScript code in-place. This feature is not available with Windows.
For developing with JupyterLab:
jupyter labextension develop --overwrite anywidget
Release
npm version [major|minor|patch]
git tag -a vX.X.X -m "vX.X.X"
git push --follow-tags
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
anywidget-0.0.5.tar.gz
(11.8 kB
view details)
Built Distribution
anywidget-0.0.5-py3-none-any.whl
(21.3 kB
view details)
File details
Details for the file anywidget-0.0.5.tar.gz.
File metadata
- Download URL: anywidget-0.0.5.tar.gz
- Upload date:
- Size: 11.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 30e919ecd3f38295ca377efec39d21d862c2083e90fc4c4477c17c98e57a4246 |
|
| MD5 | 853d19570ab1fc3b60eeba82b054b9e9 |
|
| BLAKE2b-256 | d4935f3b64fb734b658e104aea52e67d95cfaed8f606a25855bcdd3047674181 |
File details
Details for the file anywidget-0.0.5-py3-none-any.whl.
File metadata
- Download URL: anywidget-0.0.5-py3-none-any.whl
- Upload date:
- Size: 21.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9b68d5178505bcc43ad3f999b56a52f5809dadaabed0fb1eeac07d6e91aebe69 |
|
| MD5 | 7b8edd4ffc716ed715e89f6533f1eef1 |
|
| BLAKE2b-256 | 6c81f65ad50fc91ee379885b8c91be8c0c16ca2811e6fe007223a990e5f75f5e |
