TD — explo hypermarché

Ce TD vous guide dans l’exploration des données d'un magasin hypermarché fictif à l'aide de DuckDB 🦆

avec en entrée un excel de commandes qq peu fouilli "comme on les aime"

👉 Certaines cellules contiennent des TODO à compléter.

Installation locale & commandes

Récupérer les outils git, VS Code et uv

• git ou winget install --id Git.Git -e --source winget
  Dire à git qui vous êtes

  git config --global user.name "PrenomNom"
  git config --global user.email votresuper@email.fr

• uv ou powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
• VS Code ou windows store

Rappel git clone

cd ~/votreDossierDeTravailPréféré

# copie local du répo
git clone https://github.com/AntoineGiraud/marimo_hypermarche.git

# aller dans le dossier récupéré
cd marimo_hypermarche

Astuces de développement (uv sync, venv)

• uv sync
  • télécharge python si non présent
  • initialise un environnement virtuel python (venv) si non présent
  • télécharge les dépendances / extensions python
• .venv/Scripts/activate.ps1 (unix source .venv/bin/activate)
  Rend la commande streamlit disponible dans le terminal
  • si erreur d'autorisation PowerShell :
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
• ruff : linter + formater python écrit en rust
  • ruff format -> activé à chaque ctrl+s (cf. .vscode/settings.json)
  • ruff check fix -> disponible via VS Code (ctrl+maj+p puis ruff fix)

Explorer DuckDB avec Marimo

# `uv run` optionel si venv activé !
uv run marimo edit marimo_hypermarche.py

Alternative sans installation via les codespaces

Lancez un codespace Github

Une fois connecté, lancez le notebook marimo & débuter le TD

uv run marimo edit marimo_hypermarche.py