voila
v0.5.8
Rendu de notebooks Jupyter en direct avec des widgets interactifs.
Voilà transforme les notebooks Jupyter en applications Web autonomes.
Contrairement aux blocs-notes convertis en HTML habituels, chaque utilisateur se connectant à l'application Voilà tornado obtient un noyau Jupyter dédié qui peut exécuter les rappels des modifications dans les widgets interactifs Jupyter.
Par défaut, Voilà interdit les requêtes d'exécution depuis le front-end, empêchant ainsi l'exécution de code arbitraire.
Par défaut, Voilà s'exécute avec l'option strip_sources , qui supprime les cellules d'entrée du bloc-notes rendu.
Voilà peut être installé avec le gestionnaire de paquets mamba (ou conda) de conda-forge
mamba install -c conda-forge voila
ou depuis PyPI
pip install voila
Voilà fournit une extension JupyterLab qui affiche un aperçu Voilà de votre bloc-notes dans un volet latéral.
À partir de JupyterLab 3.0, l'extension est automatiquement installée après l'installation voila avec pip install voila .
Si vous souhaitez installer l'extension à partir des sources, exécutez la commande suivante.
jupyter labextension install @voila-dashboards/jupyterlab-preview
Pour afficher l'exemple de bloc-notes bqplot en tant qu'application autonome, exécutez voila bqplot.ipynb . Pour servir un répertoire de notebooks jupyter, exécutez voila joué sans argument.
Par exemple, pour restituer l'exemple de notebook bqplot.ipynb à partir de ce référentiel avec Voilà, vous pouvez d'abord mettre à jour votre environnement actuel avec les exigences de ce notebook (dans ce cas, dans un environnement conda et restituer le notebook avec
mamba env update -f .binder/environment.yml cd notebooks/ voila bqplot.ipynb
Pour plus d'options de ligne de commande (par exemple, pour spécifier un autre numéro de port), exécutez voila --help .
notebook ou jupyter_serverVoilà peut également être utilisé comme extension de serveur Jupyter, à la fois avec le serveur notebook ou avec jupyter_server.
Pour installer l'extension du serveur Jupyter, exécutez
jupyter serverextension enable voila jupyter server extension enable voila
Lors de l'exécution du serveur Jupyter, l'application Voilà est accessible à partir de l'url de base suffixée par voila .
Pour commencer à utiliser Voilà, consultez la documentation complète :
https://voila.readthedocs.io/
Les deux exemples suivants montrent comment un notebook Jupyter autonome peut être transformé en une application distincte, à partir de l'intégration en ligne de commande.
Les sources du notebook Jupyter peuvent être affichées dans une application Voilà si l'option strip_sources est définie sur False .
Voilà est construit sur les formats et protocoles standard Jupyter et est indépendant du langage de programmation du notebook. Dans cet exemple, nous présentons un exemple d'application Voilà alimentée par le noyau C++ Jupyter xeus-cling et le projet xleaflet.
La Galerie Voilà est une collection de tableaux de bord et d'applications en direct construits avec les widgets Voilà et Jupyter.
La plupart des exemples s'appuient sur des bibliothèques de widgets telles que ipywidgets, ipyleaflet, ipyvolume, bqplot et ipympl, et montrent comment créer des applications Web complexes entièrement basées sur des notebooks.
De nouveaux exemples peuvent être ajoutés à la galerie en suivant les étapes répertoriées dans le référentiel voila-gallery/gallery.
Voir CONTRIBUTING.md pour savoir comment contribuer et mettre en place un environnement de développement.
Voilà dépend de nbconvert et jupyter_server.
Nous utilisons un modèle de droit d'auteur partagé qui permet à tous les contributeurs de conserver les droits d'auteur sur leurs contributions.
Ce logiciel est sous licence BSD-3-Clause. Voir le fichier LICENSE pour plus de détails.
