iotlabkit 1.0.0__tar.gz → 1.0.1__tar.gz

{iotlabkit-1.0.0/src/iotlabkit.egg-info → iotlabkit-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iotlabkit
-Version: 1.0.0
+Version: 1.0.1
 Summary: A Beginner-Friendly IoT Lab Code Generator for MSc/MCA Practicals (Programs 5-17)
 Author: IoT Lab Contributors
 License: MIT

{iotlabkit-1.0.0 → iotlabkit-1.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iotlabkit"
-version = "1.0.0"
+version = "1.0.1"
 description = "A Beginner-Friendly IoT Lab Code Generator for MSc/MCA Practicals (Programs 5-17)"
 readme = "README.md"
 requires-python = ">=3.9"

{iotlabkit-1.0.0 → iotlabkit-1.0.1}/src/iotlabkit/__init__.py

@@ -4,7 +4,7 @@ Designed for MSc/MCA Semester 3 IoT Laboratory practicals (Programs 5-17).
 Generates clean, working, self-contained project templates in Learning and Exam modes.
 """
 
-__version__ = "1.0.0"
+__version__ = "1.0.1"
 __author__ = "IoT Lab Contributors"
 __license__ = "MIT"
 

{iotlabkit-1.0.0 → iotlabkit-1.0.1}/src/iotlabkit/cli.py

@@ -70,14 +70,14 @@ def cmd_info(args: argparse.Namespace) -> int:
     program_id = args.program_id
 
     if program_id in EXCLUDED_PROGRAM_IDS:
-        print(f"\n❌ Error: Program {program_id} is outside the supported syllabus scope.")
+        print(f"\nError: Program {program_id} is outside the supported syllabus scope.")
         print("   Only Programs 5 through 17 are included in iotlabkit.\n")
         return 1
 
     try:
         p = get_program(program_id)
     except ValueError as err:
-        print(f"\n❌ Error: {err}\n")
+        print(f"\nError: {err}\n")
         return 1
 
     print("\n" + "=" * 75)
@@ -89,11 +89,11 @@ def cmd_info(args: argparse.Namespace) -> int:
     print(f"Data Source / API: {p.source_info}")
 
     print("\nOperational Flags:")
-    print(f"  • Internet Required  : {'Yes' if p.requires_internet else 'No'}")
-    print(f"  • Cloud Credentials  : {'Yes' if p.requires_credentials else 'No'}")
-    print(f"  • External Broker    : {'Yes' if p.requires_broker else 'No'}")
-    print(f"  • Local Dataset      : {'Yes' if p.requires_dataset else 'No'}")
-    print(f"  • Local Server       : {'Yes' if p.requires_server else 'No'}")
+    print(f"  - Internet Required  : {'Yes' if p.requires_internet else 'No'}")
+    print(f"  - Cloud Credentials  : {'Yes' if p.requires_credentials else 'No'}")
+    print(f"  - External Broker    : {'Yes' if p.requires_broker else 'No'}")
+    print(f"  - Local Dataset      : {'Yes' if p.requires_dataset else 'No'}")
+    print(f"  - Local Server       : {'Yes' if p.requires_server else 'No'}")
 
     print("\nRequired Python Dependencies:")
     if p.dependencies:
@@ -111,7 +111,7 @@ def cmd_info(args: argparse.Namespace) -> int:
 
     print("\nGenerated Files:")
     for gf in p.generated_files:
-        print(f"  • {gf}")
+        print(f"  - {gf}")
 
     if p.viva_preview:
         print("\nSample Viva Questions & Answers:")
@@ -121,8 +121,8 @@ def cmd_info(args: argparse.Namespace) -> int:
 
     print("=" * 75)
     print(f"To generate this practical:")
-    print(f"  iotlabkit create {p.id} --mode learning   # Detailed guide & comments")
-    print(f"  iotlabkit create {p.id} --mode exam       # Concise code for lab examination")
+    print(f"  iotlabkit create {p.id} --mode learning   (detailed guide)")
+    print(f"  iotlabkit create {p.id} --mode exam       (concise exam code)")
     print("=" * 75 + "\n")
     return 0
 
@@ -132,7 +132,7 @@ def cmd_create(args: argparse.Namespace) -> int:
     program_id = args.program_id
 
     if program_id in EXCLUDED_PROGRAM_IDS:
-        print(f"\n❌ Error: Program {program_id} is outside the supported syllabus scope.")
+        print(f"\nError: Program {program_id} is outside the supported syllabus scope.")
         print("   Only Programs 5 through 17 are included in iotlabkit.\n")
         return 1
 
@@ -146,7 +146,7 @@ def cmd_create(args: argparse.Namespace) -> int:
         )
         return 0
     except Exception as err:
-        print(f"\n❌ Error generating practical {program_id}: {err}\n")
+        print(f"\nError generating practical {program_id}: {err}\n")
         return 1
 
 

{iotlabkit-1.0.0 → iotlabkit-1.0.1}/src/iotlabkit/doctor.py

@@ -62,7 +62,7 @@ def run_doctor() -> int:
     # 1. Python Environment
     print("\n[1] Python Runtime:")
     py_ok, py_msg = check_python_version()
-    status_icon = "✓" if py_ok else "✗"
+    status_icon = "[OK]" if py_ok else "[X]"
     print(f"  {status_icon} Python Version   : {py_msg}")
     print(f"    Platform         : {platform.system()} {platform.release()} ({platform.machine()})")
     if not py_ok:
@@ -78,7 +78,7 @@ def run_doctor() -> int:
     ]
     for binary, desc in tools:
         found, msg = check_tool(binary)
-        icon = "✓" if found else "!"
+        icon = "[OK]" if found else "[ ]"
         print(f"  {icon} {binary:<16}: {msg} - {desc}")
 
     # 3. Layer Dependencies
@@ -112,7 +112,7 @@ def run_doctor() -> int:
         print(f"  -- {group_name} --")
         for pkg_name, imp_name in pkgs:
             installed, ver_info = check_python_package(pkg_name, imp_name)
-            icon = "✓" if installed else "✗"
+            icon = "[OK]" if installed else "[ ]"
             print(f"    {icon} {pkg_name:<16}: {ver_info}")
             if not installed:
                 missing_packages.append(pkg_name)
@@ -129,7 +129,7 @@ def run_doctor() -> int:
     ]
     for var_name, desc in env_vars:
         is_set, safe_info = check_env_var_safe(var_name)
-        icon = "✓" if is_set else "-"
+        icon = "[OK]" if is_set else "[-]"
         print(f"  {icon} {var_name:<26}: {safe_info} ({desc})")
 
     # 5. Diagnostic Summary
@@ -137,7 +137,7 @@ def run_doctor() -> int:
     print("                          Summary & Recommendations")
     print("=" * 70)
     if missing_packages:
-        print(f"\n! Note: {len(missing_packages)} optional packages are currently uninstalled.")
+        print(f"\nNote: {len(missing_packages)} optional packages are currently uninstalled.")
         print("  To install packages for specific practicals, you can run:")
         print("    pip install iotlabkit[analytics]   # For Data Analytics practicals (11-14)")
         print("    pip install iotlabkit[ml]          # For Machine Learning practicals (15-17)")
@@ -145,7 +145,7 @@ def run_doctor() -> int:
         print("    pip install iotlabkit[dashboard]   # For Streamlit dashboards")
         print("    pip install iotlabkit[all]         # To install all dependencies at once")
     else:
-        print("\n✓ All Python packages for all 13 practicals are installed and ready!")
+        print("\nAll Python packages for all 13 practicals are installed and ready!")
 
     print(
         "\nReminder: Programs 8 (CoAP) runs with zero external packages (pure standard library).\n"

{iotlabkit-1.0.0 → iotlabkit-1.0.1}/src/iotlabkit/generator.py

@@ -21,7 +21,7 @@ def prompt_overwrite_confirmation(directory: str) -> bool:
     if not existing_files:
         return True
 
-    print(f"\n⚠️  Warning: Target directory '{directory}' already exists and contains {len(existing_files)} file(s):")
+    print(f"\nWarning: Target directory '{directory}' already exists and contains {len(existing_files)} file(s):")
     for f in existing_files[:5]:
         print(f"   - {f}")
     if len(existing_files) > 5:
@@ -77,7 +77,7 @@ def generate_program(
     generator_fn = prog_info.get_generator()
     files_to_write: Dict[str, str] = generator_fn(target_abs, clean_mode)
 
-    print(f"\n🚀 Generating Program {prog_info.id}: {prog_info.title}")
+    print(f"\nGenerating Program {prog_info.id}: {prog_info.title}")
     print(f"   Mode: {clean_mode.upper()}")
     print(f"   Target Directory: {target_abs}\n")
 
@@ -89,10 +89,10 @@ def generate_program(
 
         with open(full_path, "w", encoding="utf-8") as f:
             f.write(content)
-        print(f"   ✓ Created: {rel_path}")
+        print(f"   Created: {rel_path}")
 
     print("\n" + "=" * 70)
-    print(f"🎉 Project successfully generated in '{target_dir}'!")
+    print(f"Project generated in '{target_dir}'.")
     print("=" * 70)
     print("\nNext steps to run this practical:")
     print(f"  1. Navigate to the project directory:")

iotlabkit-1.0.1/src/iotlabkit/templates/program_05.py

@@ -0,0 +1,209 @@
+"""Template generator for Program 5: HTTP REST API + Cloud Database + Dashboard."""
+
+from typing import Dict
+
+
+def generate(target_dir: str, mode: str = "learning") -> Dict[str, str]:
+    files = {}
+
+    files["requirements.txt"] = (
+        "requests>=2.28.0\n"
+        "python-dotenv>=1.0.0\n"
+        "flask>=2.2.0\n"
+        "streamlit>=1.25.0\n"
+    )
+
+    files[".env.example"] = (
+        "PORT=5000\n"
+        "HOST=127.0.0.1\n"
+        "CLOUD_PROVIDER=supabase\n"
+        "SUPABASE_URL=https://your-project.supabase.co\n"
+        "SUPABASE_KEY=your-supabase-key\n"
+        "FIREBASE_DATABASE_URL=https://your-project.firebaseio.com\n"
+    )
+
+    files[".gitignore"] = (
+        ".env\n"
+        "__pycache__/\n"
+        "*.py[cod]\n"
+        "data/local_telemetry.json\n"
+    )
+
+    files["supabase_schema.sql"] = (
+        "CREATE TABLE IF NOT EXISTS sensor_telemetry (\n"
+        "    id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,\n"
+        "    created_at TIMESTAMP WITH TIME ZONE DEFAULT TIMEZONE('utc'::text, NOW()) NOT NULL,\n"
+        "    sensor_id TEXT NOT NULL DEFAULT 'DHT22_01',\n"
+        "    temperature DOUBLE PRECISION NOT NULL,\n"
+        "    humidity DOUBLE PRECISION NOT NULL\n"
+        ");\n"
+    )
+
+    files["firebase_setup.md"] = (
+        "# Firebase Setup Guide\n\n"
+        "1. Open https://console.firebase.google.com/ and create a project.\n"
+        "2. Go to Build -> Realtime Database -> Create Database.\n"
+        "3. Select test mode rules.\n"
+        "4. Copy database URL to .env under FIREBASE_DATABASE_URL.\n"
+        "5. Set CLOUD_PROVIDER=firebase in .env.\n"
+    )
+
+    # server.py
+    files["server.py"] = (
+        "import json\n"
+        "import os\n"
+        "from datetime import datetime, timezone\n"
+        "from flask import Flask, request, jsonify\n"
+        "import requests\n"
+        "from dotenv import load_dotenv\n\n"
+        "load_dotenv()\n\n"
+        "app = Flask(__name__)\n\n"
+        "HOST = os.getenv('HOST', '127.0.0.1')\n"
+        "PORT = int(os.getenv('PORT', 5000))\n"
+        "CLOUD_PROVIDER = os.getenv('CLOUD_PROVIDER', 'supabase').lower().strip()\n"
+        "SUPABASE_URL = os.getenv('SUPABASE_URL', '').rstrip('/')\n"
+        "SUPABASE_KEY = os.getenv('SUPABASE_KEY', '')\n"
+        "FIREBASE_URL = os.getenv('FIREBASE_DATABASE_URL', '').rstrip('/')\n"
+        "LOCAL_BACKUP = os.path.join(os.path.dirname(__file__), 'data', 'local_telemetry.json')\n\n"
+        "def save_to_supabase(record):\n"
+        "    if not SUPABASE_URL or not SUPABASE_KEY or 'your-project' in SUPABASE_URL:\n"
+        "        return False\n"
+        "    headers = {'apikey': SUPABASE_KEY, 'Authorization': f'Bearer {SUPABASE_KEY}', 'Content-Type': 'application/json'}\n"
+        "    resp = requests.post(f'{SUPABASE_URL}/rest/v1/sensor_telemetry', json=record, headers=headers, timeout=5)\n"
+        "    return resp.status_code in (200, 201, 204)\n\n"
+        "def save_to_firebase(record):\n"
+        "    if not FIREBASE_URL or 'your-firebase' in FIREBASE_URL:\n"
+        "        return False\n"
+        "    resp = requests.post(f'{FIREBASE_URL}/sensor_telemetry.json', json=record, timeout=5)\n"
+        "    return resp.status_code == 200\n\n"
+        "def save_local(record):\n"
+        "    os.makedirs(os.path.dirname(LOCAL_BACKUP), exist_ok=True)\n"
+        "    data = []\n"
+        "    if os.path.exists(LOCAL_BACKUP):\n"
+        "        try:\n"
+        "            with open(LOCAL_BACKUP, 'r', encoding='utf-8') as f:\n"
+        "                data = json.load(f)\n"
+        "        except Exception:\n"
+        "            data = []\n"
+        "    data.append(record)\n"
+        "    with open(LOCAL_BACKUP, 'w', encoding='utf-8') as f:\n"
+        "        json.dump(data, f, indent=2)\n\n"
+        "@app.route('/api/telemetry', methods=['POST'])\n"
+        "def receive_telemetry():\n"
+        "    payload = request.get_json(silent=True) or {}\n"
+        "    temp = float(payload.get('temperature', 25.0))\n"
+        "    hum = float(payload.get('humidity', 60.0))\n"
+        "    record = {\n"
+        "        'sensor_id': str(payload.get('sensor_id', 'DHT22_01')),\n"
+        "        'temperature': temp,\n"
+        "        'humidity': hum,\n"
+        "        'created_at': datetime.now(timezone.utc).isoformat()\n"
+        "    }\n"
+        "    saved_cloud = False\n"
+        "    if CLOUD_PROVIDER == 'supabase':\n"
+        "        saved_cloud = save_to_supabase(record)\n"
+        "    elif CLOUD_PROVIDER == 'firebase':\n"
+        "        saved_cloud = save_to_firebase(record)\n"
+        "    save_local(record)\n"
+        "    status = 'Cloud Stored' if saved_cloud else 'Saved Locally'\n"
+        "    print(f\"[{datetime.now().strftime('%H:%M:%S')}] Telemetry: Temp={temp}C, Humidity={hum}% -> {status}\")\n"
+        "    return jsonify({'message': 'Accepted', 'cloud_synced': saved_cloud, 'record': record}), 201\n\n"
+        "@app.route('/api/telemetry', methods=['GET'])\n"
+        "def get_telemetry():\n"
+        "    if os.path.exists(LOCAL_BACKUP):\n"
+        "        with open(LOCAL_BACKUP, 'r', encoding='utf-8') as f:\n"
+        "            data = json.load(f)\n"
+        "        return jsonify(list(reversed(data[-50:]))), 200\n"
+        "    return jsonify([]), 200\n\n"
+        "if __name__ == '__main__':\n"
+        "    print(f'Starting REST API server on http://{HOST}:{PORT}')\n"
+        "    app.run(host=HOST, port=PORT, debug=False)\n"
+    )
+
+    # client_sender.py
+    files["client_sender.py"] = (
+        "import argparse\n"
+        "import time\n"
+        "import requests\n\n"
+        "DEFAULT_URL = 'http://127.0.0.1:5000/api/telemetry'\n"
+        "READINGS = [\n"
+        "    (24.5, 62.0), (24.8, 61.5), (25.1, 60.8), (25.4, 59.9), (25.7, 58.5)\n"
+        "]\n\n"
+        "def send_reading(url, temp, hum):\n"
+        "    payload = {'sensor_id': 'DHT22_01', 'temperature': temp, 'humidity': hum}\n"
+        "    try:\n"
+        "        r = requests.post(url, json=payload, timeout=3)\n"
+        "        print(f\"Sent: Temp={temp}C, Hum={hum}% | Response: {r.status_code}\")\n"
+        "    except Exception as e:\n"
+        "        print('Send error:', e)\n\n"
+        "def main():\n"
+        "    parser = argparse.ArgumentParser()\n"
+        "    parser.add_argument('--url', default=DEFAULT_URL)\n"
+        "    parser.add_argument('--temp', type=float)\n"
+        "    parser.add_argument('--humidity', type=float)\n"
+        "    args = parser.parse_args()\n\n"
+        "    if args.temp is not None and args.humidity is not None:\n"
+        "        send_reading(args.url, args.temp, args.humidity)\n"
+        "        return\n\n"
+        "    print('Streaming sample sensor readings...')\n"
+        "    for t, h in READINGS:\n"
+        "        send_reading(args.url, t, h)\n"
+        "        time.sleep(1.5)\n\n"
+        "if __name__ == '__main__':\n"
+        "    main()\n"
+    )
+
+    # dashboard.py
+    files["dashboard.py"] = (
+        "import os\n"
+        "import json\n"
+        "import requests\n"
+        "import streamlit as st\n\n"
+        "st.title('Sensor Telemetry Dashboard')\n\n"
+        "REST_API_URL = os.getenv('REST_API_URL', 'http://127.0.0.1:5000/api/telemetry')\n"
+        "LOCAL_FILE = os.path.join(os.path.dirname(__file__), 'data', 'local_telemetry.json')\n\n"
+        "def fetch_data():\n"
+        "    try:\n"
+        "        resp = requests.get(REST_API_URL, timeout=3)\n"
+        "        if resp.status_code == 200:\n"
+        "            return resp.json()\n"
+        "    except Exception:\n"
+        "        pass\n"
+        "    if os.path.exists(LOCAL_FILE):\n"
+        "        try:\n"
+        "            with open(LOCAL_FILE, 'r', encoding='utf-8') as f:\n"
+        "                return list(reversed(json.load(f)))\n"
+        "        except Exception:\n"
+        "            pass\n"
+        "    return []\n\n"
+        "records = fetch_data()\n"
+        "if not records:\n"
+        "    st.write('No telemetry records found. Start python server.py and send data.')\n"
+        "else:\n"
+        "    latest = records[0]\n"
+        "    st.write(f\"Latest Reading: Temperature = {latest.get('temperature', 0)} C | Humidity = {latest.get('humidity', 0)} %\")\n"
+        "    temps = [r.get('temperature', 0) for r in reversed(records[-30:])]\n"
+        "    hums = [r.get('humidity', 0) for r in reversed(records[-30:])]\n"
+        "    st.line_chart({'Temperature': temps, 'Humidity': hums})\n"
+        "    st.write('Recent Records:')\n"
+        "    st.dataframe(records[:20])\n"
+    )
+
+    # README.md
+    files["README.md"] = (
+        "# Program 5 — HTTP REST API + Cloud DB + Dashboard\n\n"
+        "## Run\n"
+        "```bash\n"
+        "# Terminal 1: Start REST Server\n"
+        "python server.py\n\n"
+        "# Terminal 2: Send Sensor Data\n"
+        "python client_sender.py\n\n"
+        "# Terminal 3: View Dashboard\n"
+        "streamlit run dashboard.py\n"
+        "```\n\n"
+        "## Viva Q&A\n"
+        "- Q: What is REST?\n"
+        "  A: Representational State Transfer, a stateless HTTP-based architecture using methods like GET and POST.\n"
+    )
+
+    return files

iotlabkit-1.0.1/src/iotlabkit/templates/program_06.py

@@ -0,0 +1,203 @@
+"""Template generator for Program 6: MQTT + Cloud Database + Dashboard."""
+
+from typing import Dict
+
+
+def generate(target_dir: str, mode: str = "learning") -> Dict[str, str]:
+    files = {}
+
+    files["requirements.txt"] = (
+        "paho-mqtt>=1.6.1\n"
+        "requests>=2.28.0\n"
+        "python-dotenv>=1.0.0\n"
+        "streamlit>=1.25.0\n"
+    )
+
+    files[".env.example"] = (
+        "MQTT_BROKER=broker.hivemq.com\n"
+        "MQTT_PORT=1883\n"
+        "MQTT_TOPIC=iot/lab/telemetry\n"
+        "CLOUD_PROVIDER=supabase\n"
+        "SUPABASE_URL=https://your-project.supabase.co\n"
+        "SUPABASE_KEY=your-supabase-key\n"
+        "FIREBASE_DATABASE_URL=https://your-project.firebaseio.com\n"
+    )
+
+    files[".gitignore"] = (
+        ".env\n"
+        "__pycache__/\n"
+        "*.py[cod]\n"
+        "data/local_mqtt_telemetry.json\n"
+    )
+
+    files["supabase_schema.sql"] = (
+        "CREATE TABLE IF NOT EXISTS mqtt_telemetry (\n"
+        "    id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,\n"
+        "    created_at TIMESTAMP WITH TIME ZONE DEFAULT TIMEZONE('utc'::text, NOW()) NOT NULL,\n"
+        "    topic TEXT NOT NULL,\n"
+        "    sensor_id TEXT NOT NULL DEFAULT 'DHT22_01',\n"
+        "    temperature DOUBLE PRECISION NOT NULL,\n"
+        "    humidity DOUBLE PRECISION NOT NULL\n"
+        ");\n\n"
+        "ALTER TABLE mqtt_telemetry ENABLE ROW LEVEL SECURITY;\n"
+        "CREATE POLICY \"Allow anon read\" ON mqtt_telemetry FOR SELECT USING (true);\n"
+        "CREATE POLICY \"Allow anon insert\" ON mqtt_telemetry FOR INSERT WITH CHECK (true);\n"
+    )
+
+    files["subscriber.py"] = (
+        "import json\n"
+        "import os\n"
+        "from datetime import datetime, timezone\n"
+        "import requests\n"
+        "from dotenv import load_dotenv\n"
+        "import paho.mqtt.client as mqtt\n\n"
+        "load_dotenv()\n\n"
+        "BROKER = os.getenv('MQTT_BROKER', 'broker.hivemq.com')\n"
+        "PORT = int(os.getenv('MQTT_PORT', 1883))\n"
+        "TOPIC = os.getenv('MQTT_TOPIC', 'iot/lab/telemetry')\n"
+        "CLOUD_PROVIDER = os.getenv('CLOUD_PROVIDER', 'supabase').lower().strip()\n"
+        "SUPABASE_URL = os.getenv('SUPABASE_URL', '').rstrip('/')\n"
+        "SUPABASE_KEY = os.getenv('SUPABASE_KEY', '')\n"
+        "FIREBASE_URL = os.getenv('FIREBASE_DATABASE_URL', '').rstrip('/')\n"
+        "LOCAL_BACKUP = os.path.join(os.path.dirname(__file__), 'data', 'local_mqtt_telemetry.json')\n\n"
+        "def save_to_supabase(record):\n"
+        "    if not SUPABASE_URL or not SUPABASE_KEY or 'your-project' in SUPABASE_URL:\n"
+        "        return False\n"
+        "    headers = {'apikey': SUPABASE_KEY, 'Authorization': f'Bearer {SUPABASE_KEY}', 'Content-Type': 'application/json'}\n"
+        "    resp = requests.post(f'{SUPABASE_URL}/rest/v1/mqtt_telemetry', json=record, headers=headers, timeout=5)\n"
+        "    return resp.status_code in (200, 201, 204)\n\n"
+        "def save_to_firebase(record):\n"
+        "    if not FIREBASE_URL or 'your-firebase' in FIREBASE_URL:\n"
+        "        return False\n"
+        "    resp = requests.post(f'{FIREBASE_URL}/mqtt_telemetry.json', json=record, timeout=5)\n"
+        "    return resp.status_code == 200\n\n"
+        "def save_local(record):\n"
+        "    os.makedirs(os.path.dirname(LOCAL_BACKUP), exist_ok=True)\n"
+        "    data = []\n"
+        "    if os.path.exists(LOCAL_BACKUP):\n"
+        "        try:\n"
+        "            with open(LOCAL_BACKUP, 'r', encoding='utf-8') as f:\n"
+        "                data = json.load(f)\n"
+        "        except Exception:\n"
+        "            data = []\n"
+        "    data.append(record)\n"
+        "    with open(LOCAL_BACKUP, 'w', encoding='utf-8') as f:\n"
+        "        json.dump(data, f, indent=2)\n\n"
+        "def on_connect(client, userdata, flags, rc):\n"
+        "    if rc == 0:\n"
+        "        print(f'Connected to MQTT broker {BROKER}:{PORT}')\n"
+        "        client.subscribe(TOPIC)\n"
+        "        print(f'Subscribed to topic: {TOPIC}')\n"
+        "    else:\n"
+        "        print('Connection failed with code', rc)\n\n"
+        "def on_message(client, userdata, msg):\n"
+        "    try:\n"
+        "        payload = json.loads(msg.payload.decode('utf-8'))\n"
+        "        temp = float(payload.get('temperature', 0))\n"
+        "        hum = float(payload.get('humidity', 0))\n"
+        "        record = {\n"
+        "            'topic': msg.topic,\n"
+        "            'sensor_id': str(payload.get('sensor_id', 'DHT22_01')),\n"
+        "            'temperature': temp,\n"
+        "            'humidity': hum,\n"
+        "            'created_at': datetime.now(timezone.utc).isoformat()\n"
+        "        }\n"
+        "        saved = False\n"
+        "        if CLOUD_PROVIDER == 'supabase':\n"
+        "            saved = save_to_supabase(record)\n"
+        "        elif CLOUD_PROVIDER == 'firebase':\n"
+        "            saved = save_to_firebase(record)\n"
+        "        save_local(record)\n"
+        "        status = 'Cloud Stored' if saved else 'Saved Locally'\n"
+        "        print(f\"[{datetime.now().strftime('%H:%M:%S')}] Received on {msg.topic}: Temp={temp}C, Hum={hum}% -> {status}\")\n"
+        "    except Exception as e:\n"
+        "        print('Message parse error:', e)\n\n"
+        "def main():\n"
+        "    client = mqtt.Client()\n"
+        "    client.on_connect = on_connect\n"
+        "    client.on_message = on_message\n"
+        "    print(f'Connecting to {BROKER}:{PORT}...')\n"
+        "    client.connect(BROKER, PORT, keepalive=60)\n"
+        "    client.loop_forever()\n\n"
+        "if __name__ == '__main__':\n"
+        "    main()\n"
+    )
+
+    # publisher.py
+    files["publisher.py"] = (
+        "import argparse\n"
+        "import json\n"
+        "import os\n"
+        "import time\n"
+        "from dotenv import load_dotenv\n"
+        "import paho.mqtt.client as mqtt\n\n"
+        "load_dotenv()\n\n"
+        "BROKER = os.getenv('MQTT_BROKER', 'broker.hivemq.com')\n"
+        "PORT = int(os.getenv('MQTT_PORT', 1883))\n"
+        "TOPIC = os.getenv('MQTT_TOPIC', 'iot/lab/telemetry')\n"
+        "READINGS = [(26.0, 70.0), (26.3, 69.2), (26.7, 68.5), (27.1, 67.8), (27.4, 66.9)]\n\n"
+        "def main():\n"
+        "    parser = argparse.ArgumentParser()\n"
+        "    parser.add_argument('--temp', type=float)\n"
+        "    parser.add_argument('--humidity', type=float)\n"
+        "    args = parser.parse_args()\n\n"
+        "    client = mqtt.Client()\n"
+        "    client.connect(BROKER, PORT, 60)\n\n"
+        "    if args.temp is not None and args.humidity is not None:\n"
+        "        payload = json.dumps({'sensor_id': 'DHT22_01', 'temperature': args.temp, 'humidity': args.humidity})\n"
+        "        client.publish(TOPIC, payload)\n"
+        "        print(f'Published: Temp={args.temp}C, Hum={args.humidity}% to {TOPIC}')\n"
+        "        return\n\n"
+        "    print('Publishing sequence of sensor readings...')\n"
+        "    for t, h in READINGS:\n"
+        "        payload = json.dumps({'sensor_id': 'DHT22_01', 'temperature': t, 'humidity': h})\n"
+        "        client.publish(TOPIC, payload)\n"
+        "        print(f'Published: Temp={t}C, Hum={h}%')\n"
+        "        time.sleep(1.5)\n"
+        "    client.disconnect()\n\n"
+        "if __name__ == '__main__':\n"
+        "    main()\n"
+    )
+
+    # dashboard.py
+    files["dashboard.py"] = (
+        "import os\n"
+        "import json\n"
+        "import streamlit as st\n\n"
+        "st.title('MQTT Telemetry Dashboard')\n\n"
+        "LOCAL_FILE = os.path.join(os.path.dirname(__file__), 'data', 'local_mqtt_telemetry.json')\n"
+        "if os.path.exists(LOCAL_FILE):\n"
+        "    with open(LOCAL_FILE, 'r', encoding='utf-8') as f:\n"
+        "        records = list(reversed(json.load(f)))\n"
+        "    if records:\n"
+        "        latest = records[0]\n"
+        "        st.write(f\"Latest Reading: Temp = {latest.get('temperature')} C | Humidity = {latest.get('humidity')} %\")\n"
+        "        temps = [r.get('temperature', 0) for r in reversed(records[-30:])]\n"
+        "        hums = [r.get('humidity', 0) for r in reversed(records[-30:])]\n"
+        "        st.line_chart({'Temperature': temps, 'Humidity': hums})\n"
+        "        st.write('Stored Telemetry Records:')\n"
+        "        st.dataframe(records[:25])\n"
+        "    else:\n"
+        "        st.write('No records found in local database.')\n"
+        "else:\n"
+        "    st.write('No MQTT telemetry received yet. Run python subscriber.py and python publisher.py.')\n"
+    )
+
+    # README.md
+    files["README.md"] = (
+        "# Program 6 — MQTT + Cloud DB + Dashboard\n\n"
+        "## Run\n"
+        "```bash\n"
+        "# Terminal 1: Start Subscriber\n"
+        "python subscriber.py\n\n"
+        "# Terminal 2: Publish Data\n"
+        "python publisher.py\n\n"
+        "# Terminal 3: View Dashboard\n"
+        "streamlit run dashboard.py\n"
+        "```\n\n"
+        "## Viva Q&A\n"
+        "- Q: What is MQTT?\n"
+        "  A: Message Queuing Telemetry Transport, a lightweight publish-subscribe messaging protocol over TCP.\n"
+    )
+
+    return files