Aller au contenu

Étape 8 : Développement Guidé de l'Application OpenFoodFacts⚓︎

Avec notre projet initialisé, nous allons maintenant commencer à ajouter la logique pour interagir avec l'API OpenFoodFacts. Nous verrons comment utiliser Cline pour nous aider à écrire le code Python nécessaire.

Pour Commencer (Instructions Simples)⚓︎

1. Préparer le Contexte et Ajouter la Dépendance requests⚓︎

Notre application aura besoin de faire des requêtes HTTP pour interroger l'API OpenFoodFacts. La bibliothèque Python la plus courante pour cela est requests.

  • Informer Cline des nouvelles intentions : Dans l'onglet Cline, tapez le prompt suivant pour mettre Ă  jour la Memory Bank :

    Text Only
    Mets Ă  jour la Memory Bank.
Le focus actuel est : Ajouter la capacité à l'application d'appeler l'API OpenFoodFacts, ce qui nécessite la bibliothèque 'requests'.
Les objectifs sont :
- Ajouter 'requests' au fichier requirements.txt.
- Installer 'requests' dans l'environnement virtuel.
- Créer une fonction dans app.py pour récupérer les données d'un produit par son code-barres.
Les prochaines Ă©tapes sont :
1. Modifier requirements.txt et installer la dépendance.
2. Écrire la fonction get_product_info(barcode).
Confirme quand la Memory Bank est Ă  jour.
    Cline devrait proposer de mettre Ă  jour le fichier pertinent de la Memory Bank (probablement activeContext.md). Approuvez (y).

  • Demander Ă  Cline d'ajouter et installer requests : Une fois la Memory Bank Ă  jour, dans Cline, tapez :

    Text Only
    En te basant sur la Memory Bank, mets à jour le fichier requirements.txt pour inclure la bibliothèque 'requests'. Ensuite, installe les dépendances définies dans requirements.txt dans l'environnement virtuel.
    Cline devrait :

    1. Proposer de modifier requirements.txt pour ajouter requests. Approuvez (y). Le fichier devrait maintenant contenir :
      Text Only
      # requirements.txt
# DĂ©pendances du projet Explorateur OpenFoodFacts
requests
    2. Proposer d'exécuter la commande pip install -r requirements.txt. Approuvez (y). Vérifiez dans le terminal de VS Code que l'installation s'est bien déroulée.

2. Créer la Fonction d'Appel API avec Cline⚓︎

  • Demander Ă  Cline d'Ă©crire la fonction : Dans Cline, tapez, en vous assurant que la Memory Bank reflète bien cet objectif :
    Text Only
    En te basant sur la Memory Bank, écris dans le fichier app.py une fonction Python nommée 'get_product_info' qui prend un 'barcode' (code-barres) en argument.
Cette fonction doit :
1. Construire l'URL de l'API OpenFoodFacts pour un produit spécifique (par exemple : https://world.openfoodfacts.org/api/v2/product/[barcode].json).
2. Utiliser la bibliothèque 'requests' pour faire une requête GET à cette URL.
3. Vérifier si la requête a réussi (statut code 200).
4. Si oui, retourner les données JSON de la réponse.
5. Si non, ou si le produit n'est pas trouvé (souvent indiqué par un champ 'status: 0' ou 'status_verbose: "product not found"' dans le JSON de réponse même avec un statut 200), retourner None et afficher un message d'erreur approprié.
Assure-toi que la bibliothèque 'requests' est importée au début du fichier app.py.
  • Observer et Approuver : Cline devrait proposer de modifier app.py. Examinez le code. Il pourrait ressembler Ă  ceci :
    Python
    # app.py
import requests # Ajouté par Cline

def get_product_info(barcode):
    api_url = f"https://world.openfoodfacts.org/api/v2/product/{barcode}.json"
    try:
        response = requests.get(api_url)
        response.raise_for_status() # Lève une exception pour les codes d'erreur HTTP (4xx ou 5xx)

        data = response.json()
        if data.get("status") == 0 or data.get("status_verbose") == "product not found":
            print(f"Produit non trouvé pour le code-barres : {barcode}")
            return None
        return data
    except requests.exceptions.HTTPError as http_err:
        print(f"Erreur HTTP: {http_err}")
        return None
    except requests.exceptions.RequestException as req_err:
        print(f"Erreur de requĂŞte: {req_err}")
        return None

def main():
    print("Bienvenue dans l'Explorateur OpenFoodFacts !")
    # Testons notre fonction
    barcode_to_test = "3017620422003" # Exemple: Pâte à tartiner Nutella
    product_data = get_product_info(barcode_to_test)
    if product_data and product_data.get("product"):
        product_name = product_data["product"].get("product_name_fr", "Nom non disponible")
        print(f"Nom du produit : {product_name}")
    else:
        print("Impossible de récupérer les informations du produit.")

if __name__ == "__main__":
    main()
    Approuvez la modification si le code vous semble correct.

3. Tester l'Application⚓︎

  • Ouvrez un terminal dans VS Code (assurez-vous que .venv est activĂ©).
  • ExĂ©cutez app.py :
    Bash
    python app.py
  • Vous devriez voir le nom du produit (ou un message d'erreur si le code-barres est invalide ou si le produit n'est pas trouvĂ©).

Vous avez fait vos premiers pas dans le développement assisté par IA !

Pour Aller Plus Loin (Détails et Options Avancées)⚓︎

Raffiner les Prompts pour le Code⚓︎

  • Soyez spĂ©cifique sur les erreurs Ă  gĂ©rer : Au lieu de juste dire "gĂ©rer les erreurs", vous pouvez prĂ©ciser "gĂ©rer les erreurs de connexion, les timeouts, et les rĂ©ponses non-JSON".
  • Demander des commentaires ou des docstrings : "Ajoute des docstrings Ă  la fonction pour expliquer ce qu'elle fait, ses arguments, et ce qu'elle retourne."
  • SpĂ©cifier la structure de retour : Si vous voulez que la fonction retourne un objet spĂ©cifique ou un dictionnaire formatĂ© d'une certaine manière.
  • ItĂ©rer avec Cline : Si la première version du code n'est pas parfaite, dites Ă  Cline ce qui ne va pas et demandez-lui de la corriger. "Le code ne gère pas bien le cas oĂą le JSON ne contient pas la clĂ© 'product'. Peux-tu ajouter une vĂ©rification ?"

Débogage avec l'IA⚓︎

Si votre code ne fonctionne pas comme prévu :

  1. Décrivez le problème à Cline : "J'exécute app.py, mais j'obtiens cette erreur : [collez l'erreur]. Voici mon code actuel dans app.py : [collez le code]. Peux-tu m'aider à trouver le bug ?"
  2. Fournissez le contexte : Donnez Ă  Cline le message d'erreur exact et le code pertinent.
  3. Demandez des explications : "Explique-moi pourquoi cette erreur se produit et comment la corriger."

Structurer une Application Plus Complexe⚓︎

Pour une application plus grande, vous ne mettriez pas tout dans app.py. Vous pourriez avoir :

  • Un module api_client.py pour toutes les interactions avec OpenFoodFacts.
  • Un module ui.py pour gĂ©rer l'interface utilisateur (par exemple, avec input() ou une bibliothèque d'interface graphique comme Tkinter, PyQt, ou une interface web avec Flask/Django).
  • Un module data_processor.py pour traiter et afficher joliment les donnĂ©es.

Vous pouvez demander à Cline de vous aider à structurer cela : "Je veux réorganiser mon projet. Crée un fichier api_client.py et déplace la fonction get_product_info dedans. Modifie app.py pour qu'il importe et utilise cette fonction depuis api_client.py."

Ajouter des Fonctionnalités (Exemples de Prompts)⚓︎

  • Saisie utilisateur du code-barres :
    Text Only
    Modifie la fonction main() dans app.py pour qu'elle demande Ă  l'utilisateur de saisir un code-barres au lieu d'utiliser un code-barres en dur. Continue de demander jusqu'Ă  ce que l'utilisateur entre 'q' pour quitter.
  • Afficher plus d'informations :
    Text Only
    Modifie la fonction main() pour qu'après avoir récupéré product_data, elle affiche le nom du produit, la marque, le Nutri-Score et la liste des ingrédients. Gère le cas où certains de ces champs sont absents dans les données de l'API.
  • Gestion d'erreurs plus robuste :
    Text Only
    Améliore la gestion des erreurs dans get_product_info. Elle devrait explicitement gérer les `requests.exceptions.Timeout` et les `requests.exceptions.ConnectionError` en plus des erreurs HTTP générales. Affiche des messages clairs pour chaque type d'erreur.

N'oubliez pas de demander à Cline de mettre à jour la Memory Bank (en particulier le contexte actif et la progression) après chaque étape significative ou changement d'orientation. Cela aidera Cline à rester pertinent.