adding comments

app.py

@@ -116,11 +116,11 @@ print(top_results)
 #------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 
 
-SPOONACULAR_API_KEY = "71259036cfb3405aa5d49c1220a988c5"
-recipe_id_map = {}
+SPOONACULAR_API_KEY = "71259036cfb3405aa5d49c1220a988c5" #our api key
+recipe_id_map = {} #creating dictionary to keep track of which recipe title for which recipe id
 
 # search for recipes
-def search_recipes(ingredient, cuisine, dietary):
+def search_recipes(ingredient, cuisine, dietary): #filter results based on these sends requests
     global recipe_id_map
     url = "https://api.spoonacular.com/recipes/complexSearch"
     params = {
@@ -129,19 +129,19 @@ def search_recipes(ingredient, cuisine, dietary):
         "diet": dietary,
         "number": 3,
         "apiKey": SPOONACULAR_API_KEY
-    }
+    } #updates the dropdown with these titles and stores ids for later
 
     res = requests.get(url, params=params)
     data = res.json()
 
     if "results" not in data or not data["results"]:
         recipe_id_map = {}
-        return gr.update(choices=[], visible=True, label="No recipes found"), gr.update(value="No recipes found.")
+        return gr.update(choices=[], visible=True, label="No recipes found"), gr.update(value="No recipes found.") #if no recipe found
 
-    recipe_id_map = {r["title"]: r["id"] for r in data["results"]}
+    recipe_id_map = {r["title"]: r["id"] for r in data["results"]} 
     return gr.update(choices=list(recipe_id_map.keys()), visible=True, label="Select a recipe"), gr.update(value="Select a recipe from the dropdown above.")
-
-# get recipe details
+#asks user to choose a recipe from dropdown
+# get recipe details from the recipe the user selects
 def get_recipe_details(selected_title):
     if not selected_title or selected_title not in recipe_id_map:
         return "Please select a valid recipe."
@@ -161,26 +161,26 @@ def get_recipe_details(selected_title):
 # UI
 with gr.Blocks() as demo:
     gr.Markdown("## 🥗 The BiteBot")
-
+#creates interface using rows and columns layout
     with gr.Row():
         ingredient = gr.Textbox(label="Preferred Ingredient", placeholder="e.g., chicken")
         cuisine = gr.Textbox(label="Preferred Cuisine", placeholder="e.g., Indian")
         diet = gr.Textbox(label="Dietary Restrictions", placeholder="e.g., vegetarian")
-
+#creates 3 input fields side by side for ingredient, cuisine, restrictions
     search_button = gr.Button("Search Recipes")
     recipe_dropdown = gr.Dropdown(label="Select a recipe", visible=False)
     recipe_output = gr.Markdown()
-
+#triggers the search, displays up to 3 recipes, shows the recipe selected
     search_button.click(
         fn=search_recipes,
         inputs=[ingredient, cuisine, diet],
         outputs=[recipe_dropdown, recipe_output]
-    )
+    ) #when user clicks search runs search recipes function and fills dropdown
 
     recipe_dropdown.change(
         fn=get_recipe_details,
         inputs=recipe_dropdown,
         outputs=recipe_output
-    )
+    ) #when user picks option, runs get recipe details and displays full recipe
 
 demo.launch()