replace %cat with {literalinclude}

Author: parmentelat

notebooks/101/03-files-and-strings.md

@@ -40,23 +40,14 @@ with open("tmp-names.txt", 'w') as writer:
     print("Charlie", file=writer)
 ```
 
-si vous faites tourner ça sur votre ordi, vous devez constater la présence d'un nouveau fichier `tmp-names.txt` dans votre explorateur de fichier; et dedans nous avons écrit trois lignes avec les 3 noms
+si vous faites tourner ça sur votre ordi, vous devez constater la présence d'un
+nouveau fichier `tmp-names.txt` dans votre explorateur de fichier; et dedans
+nous avons écrit trois lignes avec les 3 noms:
 
-```{code-cell} ipython3
-# ceci est juste pour vérifier le contenu du fichier qu'on vient de créer
-# le %cat est de nouveau une magic IPython - ne marchera pas dans python 'tout court'
-
-%cat tmp-names.txt
+```{literalinclude} tmp-names.txt
+:caption: pour vérifier le contenu du fichier qu'on vient de créer
 ```
 
-````{admonition} c'est quoi cat ?
-
-`cat` est une commande du terminal Unix qui concatène le contenu de plusieurs fichiers  
-comme on n'en donne qu'un seul, la commande affiche le contenu de ce fichier
-
-et on y trouve bien ce à quoi on s'attendait
-````
-
 +++
 
 ### que retenir ?

notebooks/101/04-exos-bases.md

@@ -23,10 +23,16 @@ nbhosting:
 
 +++
 
-Voici un nouveau fichier de données
+Voici un nouveau fichier de données `data-students.txt` qui contient
 
-```{code-cell} ipython3
-%cat data-students.txt
+```{literalinclude} data-students.txt
+:linenos:
+```
+
+```{admonition} pour le créer sur votre ordi
+mettez votre souris dans le fichier ci-dessus  
+cela affiche une icone 'copier' dans le coin en haut à gauche  
+copiez le contenu créez le fichier avec par exemple vs-code
 ```
 
 On vous demande d'écrire un programme qui produit ce texte

notebooks/101/05-print-vs-return.md

@@ -81,8 +81,7 @@ dit autrement, la logique de Python dans ce mode c'est
 
 je vous montre la différence avec ce programme totalement bidon
 
-```{code-cell} ipython3
-%cat run_or_repl.py
+```{literalinclude} run_or_repl.py
 ```
 
 #### normal run

notebooks/5-6-type-hints-nb.md

@@ -83,16 +83,18 @@ ajouter('abc', 'def')
 %pip install mypy
 ```
 
-```{code-cell} ipython3
-# avec ce fichier source
+du coup avec ce fichier source
 
-%cat samples/typehints.py
+```{literalinclude} samples/typehints.py
+:caption: dans le dossier `samples/`
+:linenos:
+:emphasize-lines: 3,8
 ```
 
-```{code-cell} ipython3
-# on obtient ces diagnostics d'erreur sans avoir besoin d'exécuter
-# ce qui signifie qu'on peut le faire AVANT même de faire les tests
+on obtient ces diagnostics d'erreur sans avoir besoin d'exécuter  
+ce qui signifie qu'on peut le faire AVANT même de faire les tests
 
+```{code-cell} ipython3
 !mypy samples/typehints.py
 ```
 

notebooks/6-1-modules-nb.md

@@ -66,7 +66,7 @@ un module, c’est principalement juste un espace de noms
 c’est grâce à ces différents espaces de noms que deux fichiers `foo.py` et `bar.py` peuvent tous les deux définir la même variable `tutu` sans que ça pose le moindre problème de les utiliser tous les deux dans la même application
 ````
 
-+++
++++ {"slideshow": {"slide_type": ""}, "tags": []}
 
 ### c'est quoi un module ?
 
@@ -77,15 +77,12 @@ c’est grâce à ces différents espaces de noms que deux fichiers `foo.py` et
 * les différents composants du code sont alors accessibles **comme un attribut** du module  
   (c'est à dire les variables qui sont définis au *toplevel* dans le fichier source)
 
-```{code-cell} ipython3
----
-slideshow:
-  slide_type: ''
-tags: []
----
-# regardons ce qu'il y a dans ce fichier source
 
-!cat mod.py
+regardons ce qu'il y a dans ce fichier `mod.py`
+
+```{literalinclude} mod.py
+:linenos:
+:emphasize-lines: 5, 9
 ```
 
 ```{code-cell} ipython3
@@ -356,7 +353,7 @@ principalement deux choses:
     typiquement fonctions, classes, variables globales au module  
     et les ranger dans les attributs du module
 
-2. affecter la variable locale - comme on l'a vu plus haut 
+2. affecter la variable locale - comme on l'a vu plus haut
 
 +++
 
@@ -519,10 +516,9 @@ un module peut avoir deux rôles
 
 chaque module a un attribut `__name__` qui est défini par l’import
 
-```{code-cell} ipython3
-:tags: [gridwidth-1-2]
-
-%cat toplevel.py
+```{literalinclude} toplevel.py
+:linenos:
+:emphasize-lines: 1, 3
 ```
 
 ```{code-cell} ipython3
@@ -532,7 +528,7 @@ import toplevel
 print(toplevel.__name__) 
 ```
 
-#### `if __name__ == "__main__"`
+#### l'idiome `if __name__ == "__main__"`
 
 sauf que, si le module est le point d'entrée (on l'a lancé avec `python foo.py`), alors son exécution n’est pas le résultat d’un import  
 ... et du coup dans ce cas-là on ne trouve pas dans `__name__` ce qu'on pourrait attendre (`foo`) mais la chaine standard `__main__`
@@ -547,10 +543,10 @@ if __name__ == '__main__':
 
 voici un exemple
 
-```{code-cell} ipython3
-:tags: [gridwidth-1-2]
-
-%cat samples/fib.py
+```{literalinclude} samples/fib.py
+:linenos:
+:caption: dans le dossier `samples/`
+:emphasize-lines: 3
 ```
 
 ```{code-cell} ipython3
@@ -640,8 +636,6 @@ def f():
 f()
 ```
 
-+++ {"slideshow": {"slide_type": "slide"}, "tags": []}
-
 ### recharger un module
 
 on a vu plus haut comment configurer IPython pour pouvoir travailler efficacement depuis `ipython` ou un notebook
@@ -650,8 +644,9 @@ en général c'est suffisant, mais si nécessaire on peut aussi utiliser le modu
 
 voici un exemple complet
 
-```{code-cell} ipython3
-%cat toplevel.py
+```{literalinclude} toplevel.py
+:linenos:
+:emphasize-lines: 1, 3
 ```
 
 ```{code-cell} ipython3

notebooks/7-4-argparse-nb.md

@@ -67,11 +67,10 @@ Python permet de retrouver la commande de lancement du point d'entrée au traver
 
 considérons pour commencer le programme suivant
 
-```{code-cell} ipython3
-# %cat est une 'magic' de IPythion
-# qui permet d'afficher le contenu de fact_sysargv.py
-
-%cat samples/fact_sysargv.py
+```{literalinclude} samples/fact_sysargv.py
+:caption: dans le dossier `samples/`
+:linenos:
+:emphasize-lines: 11,14
 ```
 
 ```{code-cell} ipython3
@@ -132,15 +131,18 @@ vous pouvez regarder le code de `fact_sysargv2.py` pour voir comment on a implé
 
 on ne va pas ici entrer dans les détails, mais simplement montrer le code qui se comporterait comme `fact_sysargv2`.py
 
-```{code-cell} ipython3
-%cat samples/fact_argparse.py
+```{literalinclude} samples/fact_argparse.py
+:caption: dans le dossier `samples/`
+:linenos:
+:emphasize-lines: 2, 9, 12, 13, 14, 16, 20, 24, 25
+
 ```
 
 ce code peut sembler un peu plus bavard que tout à l'heure; mais d'abord il donne un programme plus agréable à utiliser
 
 ```{code-cell} ipython3
-# si on ne passe pas les paramètres imposés, 
-# le programme ne fait rien, 
+# si on ne passe pas les paramètres imposés,
+# le programme ne fait rien,
 # mais il nous explique comment on aurait dû l'appeler
 
 ! python samples/fact_argparse.py