Exercice : créer et exécuter votre notebook

• 5 minutes

Un notebook est un environnement interactif dans lequel vous pouvez à la fois écrire du code et le documenter. Les notebooks peuvent également afficher des calculs mathématiques et des graphiques.

Vous allez ici créer un fichier .ipynb local et l’exécuter dans Visual Studio Code. Le suffixe .ipynb est utilisé pour faire référence aux notebooks Jupyter, précédemment appelés iPython notebooks : ipynb.

Créer un notebook

Sur votre ordinateur local, créez un fichier appelé ship-manual.ipynb. Vous pouvez créer le fichier dans la vue Explorateur ou à partir de la palette de commandes dans Visual Studio Code, en ouvrant la palette et en tapant Create: New Jupyter Notebook. Ouvrez le fichier dans Visual Studio Code. L’extension Jupyter affiche le fichier vide, et propose d’ajouter des blocs de code et Markdown.

Créer un élément de document dans Markdown

En haut du notebook, vous voyez deux options permettant de créer deux types de blocs de contenu différents dans le notebook : Markdown et le code exécutable. Votre première tâche consiste à créer un titre pour le document. En haut de l’interface du notebook dans Visual Studio Code, sélectionnez le bouton Plus (+) en regard de l’option Markdown. Une boîte de dialogue apparaît. Ajoutez-y la balise Markdown suivante :

# Ship's Instruction Manual

Exécuter votre notebook

Vous devez désormais exécuter votre notebook. Choisissez un noyau dans la liste déroulante en haut à droite.

La liste peut contenir un ou plusieurs noyaux, veillez donc à choisir un noyau Python 3.

Sélectionnez la coche pour remplir le champ Markdown. Vous voyez alors que le texte s’affiche sous la forme <h1> ou comme texte d’en-tête. Vous venez de nommer votre notebook ! Pour voir comment s’affiche ce fichier Markdown, choisissez tout exécuter en haut du notebook.

Créer du code exécutable

À présent, vous pouvez ajouter du code au notebook. Nous allons ajouter un moyen d’afficher un widget pour démarrer le moteur du vaisseau.

Tout d’abord, vous devez installer une bibliothèque appelée ipywidgets. Installez la bibliothèque en ajoutant un nouveau bloc de code sous le bloc titre du notebook. Utilisez pip, le gestionnaire de package Python, pour installer la bibliothèque.

1. Ajoutez cette ligne au nouveau bloc de code : pip install ipywidgets.

    pip install ipywidgets
   

2. Exécutez ce bloc en utilisant la flèche à gauche pour installer la bibliothèque.

   

   Suivez les invites d’installation. ipywidgets doit être en cours d’installation. Attendez que l’installation se termine avant de poursuivre.

3. Ensuite, créez un bouton directement dans votre notebook qui affichera un message lorsque l’on cliquera dessus. Dans un nouveau bloc de code, ajoutez le code suivant :

   import ipywidgets as widgets
   
   ignition = widgets.ToggleButton(
       value=False,
       description='Start Engine',
       button_style='success',
       tooltip='Engage your Engine',
       icon='rocket'
   )
   
   output = widgets.Output()
   
   display(ignition, output)
   
   def on_value_change(change):
       with output:
           if change['new'] == True:
               print("engine started!")
           else:   
               print("engine stopped")
   
   ignition.observe(on_value_change, names='value')
   

4. Exécutez le code en utilisant la flèche située à gauche.

   

   Votre code doit afficher un bouton :

   

   Conseil

   Si le bouton ne s’affiche pas, essayez de passer à un autre noyau Python 3.

   Appuyez sur le bouton pour démarrer le moteur.

   

   Réappuyez sur le bouton pour arrêter le moteur.

   

Comment cela se fait-il ? Vous utilisez la bibliothèque ipywidget pour créer un bouton et écouter sa valeur pour la modifier, en imprimant le message observé. À présent, votre manuel commence à avoir bonne allure et vous pouvez démarrer le moteur de votre vaisseau si celui-ci se bloque !