Add a polars part and minor changes

.github/workflows/publish.yaml

@@ -1,6 +1,6 @@
 name: Publish slides and notebooks
 
-on: 
+on:
   push:
     branches:
       - main
@@ -11,24 +11,24 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
-          python-version: '3.10'
-      - run: pip install -r requirements.txt
+          python-version: "3.13"
+
+      - name: Install the default version of uv
+        id: setup-uv
+        uses: astral-sh/setup-uv@v7
 
       - name: Set up quarto
         uses: quarto-dev/quarto-actions/setup@v2
 
-      - name: Render FR version
-        uses: quarto-dev/quarto-actions/render@v2
-        env:
-          QUARTO_PROFILE: fr
-      - name: Render EN version
-        uses: quarto-dev/quarto-actions/render@v2
-        env:
-          QUARTO_PROFILE: en
+      - name: Render FR and EN version
+        run: |
+          uv run quarto render --profile fr
+          uv run quarto render --profile en
+
       - name: Publish to GitHub Pages (and render)
         uses: quarto-dev/quarto-actions/publish@v2
         with:

.gitignore

@@ -153,3 +153,5 @@ dmypy.json
 .pyre/
 
 /.quarto/
+
+**/*.quarto_ipynb

README.md

@@ -1,8 +1,8 @@
 # Formation - Initiation à Python
 
-*Auteur : Romain Avouac*
+_Auteur : Romain Avouac_
 
-*Contributeurs : Yves-Laurent Bénichou, Olivier Chateau, Thomas Faria, Antoine Palazzolo*
+_Contributeurs : Yves-Laurent Bénichou, Olivier Chateau, Thomas Faria, Antoine Palazzolo_
 
 ## Site associé
 
@@ -15,6 +15,7 @@ Ce projet contient les supports de cours de l'auto-formation d'initiation à Pyt
 ## Génération des notebooks
 
 Afin de favoriser la reproductibilité de la formation, les sources des supports de cours sont disponibles au format `.qmd` ([Quarto](https://quarto.org/)) dans les différents sous-dossiers du dossier `source/`. Les notebooks `Jupyter` (format `.ipynb`) exécutables associés peuvent être générés en suivant les étapes suivantes :
+
 - [installer Quarto](https://quarto.org/docs/get-started/)
 - cloner le dépôt de la formation :
 
@@ -26,13 +27,13 @@ cd formation-python-initiation
 - installer les packages `Python` nécessaires :
 
 ```bash
-pip install -r requirements.txt
+uv sync
 ```
 
 - générer les notebooks :
 
 ```bash
-quarto render --profile notebooks
+uv run quarto render --profile notebooks
 ```
 
-Une fois l'étape de *rendering* terminée, les notebooks générés au format `.ipynb` sont disponibles dans les différents sous-dossiers du dossier `source/`.
+Une fois l'étape de _rendering_ terminée, les notebooks générés au format `.ipynb` sont disponibles dans les différents sous-dossiers du dossier `source/`.

_quarto-en.yaml

@@ -7,7 +7,7 @@ website:
     style: 'docked'
     contents:
       - section: "Fundamentals"
-        contents: 
+        contents:
           - text: "Basic types and variables"
             href: source/fundamentals/types-variables/tutorial.qmd
           - text: "Data structures 1: lists and tuples"
@@ -23,7 +23,7 @@ website:
           - text: "Introduction to object-oriented programming"
             href: source/fundamentals/oop/tutorial.qmd
       - section: "Data handling"
-        contents: 
+        contents:
           - text: "File manipulation"
             href: source/manipulation/modules-files/tutorial.qmd
           - text: "Working with CSV and JSON files"
@@ -32,10 +32,12 @@ website:
             href: source/manipulation/numpy/tutorial.qmd
           - text: "Processing tabular data with Pandas"
             href: source/manipulation/pandas/tutorial.qmd
+          - text: "Processing tabular data with Polars"
+            href: source/manipulation/polars/tutorial.qmd
           - text: "Introduction to data visualization"
             href: source/manipulation/dataviz/tutorial.qmd
       - section: "Projects"
-        contents: 
+        contents:
           - text: "Project 1 - Connect 4"
             href: source/projects/puissance4/tutorial.qmd
           - text: "Project 2 - Wheather forecast"

_quarto-fr.yaml

@@ -4,7 +4,7 @@ website:
     style: 'docked'
     contents:
       - section: "Fondamentaux du langage"
-        contents: 
+        contents:
           - text: "Types de base et variables"
             href: source/fundamentals/types-variables/tutorial.qmd
           - text: "Structures de données 1 : listes et tuples"
@@ -20,7 +20,7 @@ website:
           - text: "Notions de programmation orientée objet"
             href: source/fundamentals/oop/tutorial.qmd
       - section: "Manipulation de données"
-        contents: 
+        contents:
           - text: "Manipulation de fichiers"
             href: source/manipulation/modules-files/tutorial.qmd
           - text: "Travailler avec des fichiers CSV et JSON"
@@ -29,10 +29,12 @@ website:
             href: source/manipulation/numpy/tutorial.qmd
           - text: "Traiter des données tabulaires avec Pandas"
             href: source/manipulation/pandas/tutorial.qmd
+          - text: "Traiter des données tabulaires avec Polars"
+            href: source/manipulation/polars/tutorial.qmd
           - text: "Introduction à la visualisation de données"
             href: source/manipulation/dataviz/tutorial.qmd
       - section: "Projets"
-        contents: 
+        contents:
           - text: "Projet 1 - Puissance 4"
             href: source/projects/puissance4/tutorial.qmd
           - text: "Projet 2 - Prédictions météorologiques"

pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "formation-python-initiation"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "matplotlib",
+    "numpy",
+    "pandas",
+    "pyarrow",
+    "scikit-learn",
+    "cartiflette>=0.1.9",
+    "geopandas>=1.1.1",
+    "plotnine>=0.15.2",
+    "polars>=1.36.1",
+    "pyarrow>=22.0.0",
+    "requests>=2.32.5",
+    "seaborn>=0.13.2",
+    "xlrd>=2.0.2",
+    "fastexcel>=0.19.0",
+    "jupyter>=1.1.1",
+]

source/fundamentals/oop/tutorial.qmd

@@ -24,7 +24,7 @@ print(type({}))
 
 def f(x):
     print(x)
-          
+
 print(type(f))
 ```
 
@@ -43,10 +43,10 @@ class Citron:
         self.saveur = "acide"
         self.couleur = couleur
         self.jus = qte_jus
-        
+
     def recup_qte_jus(self):
         print("Il reste " + str(self.jus) + " mL de jus dans le citron.")
-        
+
     def extraire_jus(self, quantite):
         if quantite > self.jus:
             print("Il n'y a pas assez de jus dans le citron pour la quantité demandée.")
@@ -64,7 +64,7 @@ Analysons la syntaxe de construction d'une classe d'objets :
 
 - le constructeur a un paramètre obligatoire : `self`. C'est une référence aux **instances** qui vont être créées à partir de cette classe. Notons la syntaxe qui définit un attribut : `self.attribut = valeur`.
 
-- les autres méthodes sont définies par l'utilisateur. Elles prennent également le `self` en paramètre, ce qui leur permet d'effectuer des opérations sur / à partir des attributs. Comme ce sont des fonctions, elles peuvent également admettre d'autres paramètres. Ainsi, la fonction `extraire_jus` prend un paramètre `quantite` qui définit quelle quantité de jus on extrait du citron lorsqu'on le presse.
+- les autres méthodes sont définies par l'utilisateur. Elles prennent également le `self` en paramètre, ce qui leur permet d'effectuer des opérations sur / à partir des attributs. Comme ce sont des fonctions, elles peuvent également admettre d'autres paramètres. Ainsi, la fonction `extraire_jus` prend un paramètre `quantite` qui définit quelle quantité de jus on extrait du citron lorsqu'on le presse. On peut remarquer que les méthodes ne prennent pas de déclaration `return`, contrairement aux fonctions.
 
 
 ## La classe et ses instances
@@ -202,7 +202,7 @@ Les trois exécutions donnent des résultats différents, alors que le code exé
 
 - 3/ A quoi sert le constructeur `__init__` ?
 
-- 4/ A quoi sert le `self` ? 
+- 4/ A quoi sert le `self` ?
 
 - 5/ Quelle est la différence entre une classe et une instance ?
 
@@ -268,10 +268,10 @@ class Citron:
         self.saveur = "acide"
         self.couleur = couleur
         self.jus = qte_jus
-        
+
     def recup_qte_jus(self):
         print("Il reste " + str(self.jus) + " mL de jus dans le citron.")
-        
+
     def extraire_jus(self, quantite):
         if quantite > self.jus:
             print("Il n'y a pas assez de jus dans le citron pour la quantité demandée.")
@@ -297,19 +297,19 @@ class Citron:
         self.couleur = couleur
         self.masse = masse
         self.jus = masse / 4
-        
+
     def recup_masse(self):
         print("La masse du citron est " + str(self.masse) + " grammes.")
-        
+
     def recup_qte_jus(self):
         print("Il reste " + str(self.jus) + " mL de jus dans le citron.")
-        
+
     def extraire_jus(self, quantite):
         if quantite > self.jus:
             print("Il n'y a pas assez de jus dans le citron pour la quantité demandée.")
         else:
             self.jus = max(0, self.jus - quantite)  # évite toute valeur négative de `jus`
-            
+
 citron = Citron("jaune", 500)
 
 citron.recup_masse()
@@ -333,7 +333,7 @@ Implémenter une classe `Compte` avec :
 
 - une méthode `depot` qui admet un paramètre `montant`. Lorsqu'un dépôt est effectué, le solde du compte est incrémenté du montant du dépôt.
 
-- une méthode `retrait` qui admet un paramètre `montant`. Lorsqu'un retrait est effectué : 
+- une méthode `retrait` qui admet un paramètre `montant`. Lorsqu'un retrait est effectué :
 
     - si le montant est inférieur au solde : le solde est décrémenté du montant, est on affiche "Retrait accepté.".
 
@@ -344,7 +344,7 @@ Implémenter une classe `Compte` avec :
     - si le montant est inférieur au solde de client1 : le solde de client1 est décrémenté du montant, le solde de client2 est incrémenté du montant.
 
     - si le montant est supérieur au solde de client1 : on affiche "Transfert refusé : fonds insuffisants." et les soldes des deux clients restent inchangés.
-    
+
 Créer deux clients et tester que les différentes fonctionnalités à implémenter marchent comme prévu.
 
 ```{python}
@@ -362,27 +362,27 @@ class Compte:
     def __init__(self, titulaire, solde):
         self.titulaire = titulaire
         self.solde = solde
-        
+
     def affiche_solde(self):
         print("Le solde du compte de " + self.titulaire + " est " + str(self.solde) + " euros.")
-        
+
     def depot(self, montant):
         self.solde += montant
-    
+
     def retrait(self, montant):
         if self.solde >= montant:
             self.solde -= montant
             print("Retrait accepté.")
         else:
             print("Retrait refusé : fonds insuffisants.")
-            
+
     def transfert(self, destinataire, montant):
         if self.solde >= montant:
             destinataire.solde += montant
             self.solde -= montant
         else:
             print("Transfert refusé : fonds insuffisants.")
-            
+
 client1 = Compte("Bernard", 2000)
 client2 = Compte("Bianca", 5000)
 
@@ -830,4 +830,4 @@ client1.show_balance() # + 2000
 :::
 
 
-:::
+:::