Merge pull request #4 from StructuralWizard/include-day1

Day 1 written

Author: StructuralWizard

.gitignore

@@ -9,7 +9,12 @@ _site/
 .sass-cache/
 .jekyll-cache/
 .jekyll-metadata
+package-lock.json
+package.json
 
 # Ignore folders generated by Bundler
 .bundle/
 vendor/
+
+# Ignore folders for mermaid diagrams
+.assets/

_config.yml

@@ -6,3 +6,36 @@ url: https://just-the-docs.github.io
 
 aux_links:
   Template Repository: https://github.com/just-the-docs/just-the-docs-template
+
+
+collections:
+  python_code:
+    output: true
+
+just_the_docs:
+  collections:
+    python_code:
+      name: Python Code
+      description: Python code examples for the 10 Days of Code
+      nav_exclude: false # to exclude the entire collection from the main navigation
+      nav_fold: true # to fold the collection, instead of showing links to all its top-level pages2
+      search_exclude: false # to exclude all the collection pages from search results
+  # For copy button on code
+  enable_copy_code_button: true
+
+# Back to top link
+back_to_top: true
+back_to_top_text: "Back to top"
+
+
+mermaid:
+  # Version of mermaid library
+  # Pick an available version from https://cdn.jsdelivr.net/npm/mermaid/
+  version: "11.6.0"
+  # for (v10+)
+  path: "/assets/js/mermaid.esm.min.mjs"
+  #path: "./node_modules/mermaid/dist/mermaid.esm.min.mjs"
+  # for (<v10):
+  # path: "/assets/js/mermaid.min.js"
+  # Note: copy both `mermaid.esm.min.mjs` (v10+) or `mermaid.min.js` (<v10) and the associated
+  # `.map` file from the specified version of `mermaid/dist` to `/assets/js/`.

_python_code/Day1/Monster_Maze_Tutorial.ipynb

@@ -0,0 +1,111 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "75e340c4",
+   "metadata": {},
+   "source": [
+    "# 🧟‍♂️ Monster Maze Python Tutorial\n",
+    "Welcome to the Monster Maze! In this tutorial, you’ll build a fun text-based game while learning core Python concepts."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a90a9c09",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "import random\n",
+    "\n",
+    "# Constants\n",
+    "ROOMS = [\"Hall\", \"Kitchen\", \"Dining Room\", \"Library\", \"Garden\"]\n",
+    "ITEMS = [\"sword\", \"shield\", \"potion\"]\n",
+    "MONSTERS = [\"goblin\", \"zombie\", \"troll\"]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "06cb7692",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "# Player dictionary\n",
+    "player = {\n",
+    "    \"name\": \"Hero\",\n",
+    "    \"health\": 100,\n",
+    "    \"inventory\": []\n",
+    "}\n",
+    "\n",
+    "# Functions\n",
+    "def describe_room(room):\n",
+    "    print(f\"You are in the {room}.\")\n",
+    "    if random.random() < 0.3:\n",
+    "        item = random.choice(ITEMS)\n",
+    "        print(f\"You found a {item}!\")\n",
+    "        player[\"inventory\"].append(item)\n",
+    "    if random.random() < 0.3:\n",
+    "        monster = random.choice(MONSTERS)\n",
+    "        print(f\"A {monster} appears!\")\n",
+    "        fight(monster)\n",
+    "\n",
+    "def fight(monster):\n",
+    "    if \"sword\" in player[\"inventory\"]:\n",
+    "        print(f\"You defeated the {monster} with your sword!\")\n",
+    "    else:\n",
+    "        print(f\"The {monster} attacked you! You lose 20 health.\")\n",
+    "        player[\"health\"] -= 20\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c4647a04",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "# Game loop\n",
+    "def play_game():\n",
+    "    print(\"Welcome to the Monster Maze!\")\n",
+    "    print(\"Find the exit without losing all your health.\")\n",
+    "\n",
+    "    visited = []\n",
+    "    while player[\"health\"] > 0:\n",
+    "        room = random.choice(ROOMS)\n",
+    "        if room not in visited:\n",
+    "            visited.append(room)\n",
+    "        describe_room(room)\n",
+    "        print(f\"Health: {player['health']}, Inventory: {player['inventory']}\")\n",
+    "        if input(\"Continue? (y/n) \") != \"y\":\n",
+    "            break\n",
+    "\n",
+    "    if player[\"health\"] <= 0:\n",
+    "        print(\"You have been defeated in the maze.\")\n",
+    "    else:\n",
+    "        print(\"You escaped the Monster Maze!\")\n",
+    "\n",
+    "play_game()\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9d03cbce",
+   "metadata": {},
+   "source": [
+    "\n",
+    "## 📝 Reflection\n",
+    "\n",
+    "- What happens when you find an item?\n",
+    "- How is randomness used in the game?\n",
+    "- Try changing the monsters, items, or rooms. What happens?\n"
+   ]
+  }
+ ],
+ "metadata": {},
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

_python_code/Day1/monster_maze.py

@@ -0,0 +1,99 @@
+import random
+
+# Constants
+ROOMS = ["Hall", "Kitchen", "Library", "Dungeon", "Garden"]
+ITEMS = ["sword", "potion", "shield"]
+MONSTERS = ["Goblin", "Troll", "Skeleton"]
+
+# Global variable
+found_key = False
+
+def print_welcome():
+    """Prints the welcome message with ASCII art."""
+    print("""
+    🧟‍♂️ MONSTER MAZE 🧟‍♀️
+    Escape the maze, defeat monsters, and find the key!
+    """)  # String manipulation and printing
+
+def create_player(name):
+    """Returns a new player dictionary."""
+    return {
+        "name": name,
+        "health": 100,
+        "inventory": [],
+        "location": random.choice(ROOMS)  # Random module
+    }
+
+def describe_room(room):
+    """Describes the current room."""
+    print(f"\nYou are now in the {room}.")
+    if random.random() < 0.4:  # Conditional statement
+        item = random.choice(ITEMS)
+        print(f"You found a {item}!")
+        return item
+    return None
+
+def encounter_monster(player):
+    """Random monster encounter with chance of fight."""
+    if random.random() < 0.3:
+        monster = random.choice(MONSTERS)
+        print(f"\n⚔️ A wild {monster} appears!")
+        if "sword" in player["inventory"]:
+            print("You defeat it with your sword!")
+        else:
+            player["health"] -= 20
+            print("You have no sword! You got hurt!")
+            print(f"Health: {player['health']}")
+            if player["health"] <= 0:
+                print("💀 You have died. Game Over.")
+                exit()
+
+def move_to_new_room(player):
+    """Moves the player to a new random room."""
+    previous = player["location"]
+    player["location"] = random.choice([r for r in ROOMS if r != previous])
+
+def check_for_key(player):
+    """Checks if the player finds the key."""
+    global found_key
+    if not found_key and random.random() < 0.2:
+        found_key = True
+        print("🔑 You found the magic key!")
+        player["inventory"].append("magic key")
+
+def game_loop(player):
+    """Main game loop using recursion."""
+    if found_key:
+        print(f"\n🎉 Congratulations, {player['name']}! You escaped the maze!")
+        return # End the game if key is found
+
+    item = describe_room(player["location"])
+    if item:
+        player["inventory"].append(item)
+    
+    encounter_monster(player)
+    check_for_key(player)
+
+    # While loop & string formatting with f-strings
+    while True:
+        choice = input("\nDo you want to move to another room? (yes/no): ").lower()
+        if choice in ["yes", "y"]:
+            move_to_new_room(player)
+            game_loop(player)  # Recursion
+            break
+        elif choice in ["no", "n"]:
+            print("🛌 You chose to rest. Game Over.")
+            break
+        else:
+            print("Please answer yes or no.")
+
+# Main program
+def main():
+    """Starts the game."""
+    print_welcome()
+    name = input("Enter your name, adventurer: ")
+    player = create_player(name)  # Function with inputs/outputs
+    game_loop(player)
+
+if __name__ == "__main__":
+    main()