iotlabkit 1.0.0__tar.gz → 1.0.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iotlabkit
-Version: 1.0.0
+Version: 1.0.2
 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.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iotlabkit"
-version = "1.0.0"
+version = "1.0.2"
 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.2}/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.2"
 __author__ = "IoT Lab Contributors"
 __license__ = "MIT"
 

{iotlabkit-1.0.0 → iotlabkit-1.0.2}/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.2}/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.2}/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.0 → iotlabkit-1.0.2}/src/iotlabkit/registry.py

@@ -81,6 +81,7 @@ PROGRAMS: Dict[int, ProgramInfo] = {
             "dashboard.py",
             "supabase_schema.sql",
             "firebase_setup.md",
+            "init_db.py",
         ],
         prerequisites=[
             "Python 3.9+",
@@ -130,6 +131,7 @@ PROGRAMS: Dict[int, ProgramInfo] = {
             "publisher.py",
             "dashboard.py",
             "supabase_schema.sql",
+            "init_db.py",
         ],
         prerequisites=[
             "Python 3.9+",
@@ -323,6 +325,7 @@ PROGRAMS: Dict[int, ProgramInfo] = {
             "dashboard.py",
             "supabase_schema.sql",
             "coap_core.py",
+            "init_db.py",
         ],
         prerequisites=[
             "Python 3.9+",

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

@@ -0,0 +1,282 @@
+"""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"
+        "psycopg2-binary>=2.9.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"
+        "SUPABASE_DB_PASSWORD=your-database-password\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"
+        "    try:\n"
+        "        import init_db\n"
+        "        init_db.init_table()\n"
+        "    except Exception:\n"
+        "        pass\n"
+        "    print(f'Starting REST API server on http://{HOST}:{PORT}')\n"
+        "    app.run(host=HOST, port=PORT, debug=False)\n"
+    )
+
+    files["init_db.py"] = (
+        "import os\n"
+        "import re\n"
+        "import requests\n"
+        "from dotenv import load_dotenv\n\n"
+        "load_dotenv()\n\n"
+        "SUPABASE_URL = os.getenv('SUPABASE_URL', '').rstrip('/')\n"
+        "SUPABASE_KEY = os.getenv('SUPABASE_KEY', '')\n"
+        "DATABASE_URL = os.getenv('DATABASE_URL', '')\n"
+        "DB_PASSWORD = os.getenv('SUPABASE_DB_PASSWORD', '')\n"
+        "ACCESS_TOKEN = os.getenv('SUPABASE_ACCESS_TOKEN', '')\n\n"
+        "SQL_QUERY = '''\n"
+        "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"
+        "ALTER TABLE sensor_telemetry ENABLE ROW LEVEL SECURITY;\n"
+        "CREATE POLICY \"Allow anon read\" ON sensor_telemetry FOR SELECT USING (true);\n"
+        "CREATE POLICY \"Allow anon insert\" ON sensor_telemetry FOR INSERT WITH CHECK (true);\n"
+        "'''\n\n"
+        "def init_table():\n"
+        "    if not SUPABASE_URL or 'your-project' in SUPABASE_URL:\n"
+        "        return False\n"
+        "    headers = {'apikey': SUPABASE_KEY, 'Authorization': f'Bearer {SUPABASE_KEY}'}\n"
+        "    try:\n"
+        "        r = requests.get(f'{SUPABASE_URL}/rest/v1/sensor_telemetry?limit=1', headers=headers, timeout=4)\n"
+        "        if r.status_code == 200:\n"
+        "            print('Supabase: Table sensor_telemetry is ready.')\n"
+        "            return True\n"
+        "    except Exception:\n"
+        "        pass\n"
+        "    m = re.search(r'https://([a-z0-9_-]+)\\.supabase\\.co', SUPABASE_URL)\n"
+        "    ref = m.group(1) if m else None\n"
+        "    if ACCESS_TOKEN and ref:\n"
+        "        try:\n"
+        "            resp = requests.post(f'https://api.supabase.com/v1/projects/{ref}/database/query', json={'query': SQL_QUERY}, headers={'Authorization': f'Bearer {ACCESS_TOKEN}', 'Content-Type': 'application/json'}, timeout=8)\n"
+        "            if resp.status_code in (200, 201):\n"
+        "                print('Supabase: Table sensor_telemetry created via API.')\n"
+        "                return True\n"
+        "        except Exception:\n"
+        "            pass\n"
+        "    conn_str = DATABASE_URL\n"
+        "    if not conn_str and DB_PASSWORD and ref:\n"
+        "        conn_str = f'postgresql://postgres:{DB_PASSWORD}@db.{ref}.supabase.co:5432/postgres'\n"
+        "    if conn_str:\n"
+        "        try:\n"
+        "            import psycopg2\n"
+        "            conn = psycopg2.connect(conn_str, connect_timeout=6)\n"
+        "            cur = conn.cursor()\n"
+        "            cur.execute(SQL_QUERY)\n"
+        "            conn.commit()\n"
+        "            cur.close()\n"
+        "            conn.close()\n"
+        "            print('Supabase: Table sensor_telemetry created via PostgreSQL.')\n"
+        "            return True\n"
+        "        except Exception as e:\n"
+        "            print(f'Supabase PostgreSQL note: {e}')\n"
+        "    print('Supabase: Table not found. To create via code, add SUPABASE_DB_PASSWORD in .env, or paste supabase_schema.sql in Supabase SQL editor.')\n"
+        "    return False\n\n"
+        "if __name__ == '__main__':\n"
+        "    init_table()\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