Pré cours 1 — Installer Livebook · AP

Installez et essayez Livebook avant la première séance. Comme les notebooks Jupyter de vos six séances de PE, Livebook réunit code, résultats et explications dans un fichier, ici du code Elixir dans un .livemd. Nous l’utiliserons dès AP1 ; vous n’avez pas encore besoin d’Elixir dans le terminal ni d’une extension pour votre éditeur.

Installer et ouvrir l’application

La page officielle propose Livebook Desktop pour macOS, Windows et Linux. Choisissez votre système et votre architecture : arm64 pour une puce Apple, x64 pour un Mac Intel ou un PC Intel/AMD. L’application fournit son propre environnement Elixir pour les ateliers.

Sur macOS, ouvrez le .dmg, placez Livebook dans Applications et lancez-le.
Sur Windows, lancez le programme d’installation, puis ouvrez Livebook.
Sur Linux, téléchargez l’AppImage, autorisez son exécution dans les propriétés du fichier et ouvrez-le. Les fichiers proposés sont aussi répertoriés dans le README officiel.

Si Linux refuse l’exécution du fichier, vous pouvez aussi utiliser le terminal, depuis son dossier de téléchargement, en remplaçant le nom ci-dessous par celui du fichier reçu :

chmod +x Livebook.AppImage
./Livebook.AppImage

Lancez Livebook et créez un notebook avec New notebook. Aucun compte de service n’est nécessaire pour travailler localement.

Vérifier avec trois petites cellules

Ajoutez une cellule de code Elixir, recopiez ce calcul et cliquez sur Evaluate ou utilisez Ctrl + Entrée (Cmd + Entrée sur Mac) :

2 + 3

Le résultat doit être 5. Dans une deuxième cellule, affichez les versions utilisées par le notebook :

{System.version(), System.otp_release()}

Vous obtenez deux chaînes de caractères, par ex. {"1.19.5", "28"}. Les numéros peuvent différer : gardez-les si vous devez me signaler un souci. Une troisième cellule permet de distinguer l’affichage dans la console et la valeur renvoyée :

IO.puts("Livebook est prêt")
6 * 7

Vous devez voir le message, puis la valeur 42. Modifiez le message et réévaluez pour vérifier que votre modification est bien prise en compte.

Enregistrer, fermer, rouvrir

Ajoutez une cellule de texte et écrivez une phrase, par ex. « Mon installation fonctionne ».
Enregistrez le notebook sous verification-livebook.livemd dans un dossier de cours que vous savez retrouver. Choisissez bien un fichier sur votre ordinateur, et pas seulement une session ouverte dans Livebook.
Fermez le notebook, puis rouvrez le fichier depuis l’accueil de Livebook.
Retrouvez votre phrase et votre code, puis réévaluez les cellules depuis le haut. L’état de calcul ne remplace pas le fichier enregistré.

L’installation est prête lorsque ces quatre étapes fonctionnent. Livebook Desktop peut fonctionner même si la commande elixir est inconnue dans votre terminal : cette seconde installation sera demandée avant AP6.

Ouvrir votre premier atelier

Depuis la page d’AP1, cliquez sur Run in Livebook pour importer le premier carnet, ap1-01-expressions.livemd, dans votre Livebook. Au besoin, utilisez le lien « Télécharger le .livemd », puis ouvrez le fichier depuis l’accueil de l’application.

Nous travaillerons dans cinq carnets de ce type en séance, un par étape. Sauvegardez régulièrement chacun dans AP1/, sous son nom : ils contiennent directement vos exercices et vos explications. Les petits ateliers de réserve et les laboratoires facultatifs vont dans entrainement/. En AP2 et AP3, gardez les étapes travaillées dans AP2/ et AP3/, sans fusionner les carnets. Le point d’arrêt attendu est annoncé en cours ; le nombre de carnets disponibles n’impose pas de tous les terminer. Chaque nouveau notebook indique quelles cellules de votre travail précédent reprendre : deux Livebooks n’ont pas une mémoire partagée. Les échéances figurent sur Rendre un devoir.

Si quelque chose bloque

Si le bouton Run in Livebook ne trouve pas l’application, lancez-la d’abord et réessayez ; le téléchargement du .livemd reste possible. Si une cellule ne se lance pas, conservez le message complet et les versions, quand elles s’affichent. Pour un refus de lancement de l’application, précisez votre système et le fichier téléchargé.

Pour toute question, vous pouvez me contacter par email avant le cours, comme d’habitude. Cela nous laissera le temps de résoudre l’installation avant AP1.