etc-lab-extension 1.0.4__tar.gz

etc_lab_extension-1.0.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2026 Edutech Core JSC (ETC Corp) & Dang Tuan Anh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

etc_lab_extension-1.0.4/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: etc-lab-extension
+Version: 1.0.4
+Summary: ETC Classroom Lab Extension Suite: Terminal UI formatters, SQLite forensic evidence extractors, and concurrency supervision daemons.
+Author-email: Dang Tuan Anh <tuandanga@etc-corp.internal>, Edutech Core JSC R&D <rnd@etc-corp.internal>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/etc-corp/etc-lab-extension
+Project-URL: Documentation, https://github.com/etc-corp/etc-lab-extension#readme
+Project-URL: Repository, https://github.com/etc-corp/etc-lab-extension.git
+Project-URL: Bug Tracker, https://github.com/etc-corp/etc-lab-extension/issues
+Keywords: education,classroom,terminal-ui,forensics,concurrency,python-education,edtech,etc-corp
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# etc-lab-extension
+
+[![PyPI version](https://img.shields.io/badge/pypi-v1.0.4-blue.svg)](https://pypi.org/project/etc-lab-extension/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Python: 3.8+](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+
+**ETC Classroom Lab Extension Suite** is an educational extension library developed by Edutech Core JSC (ETC Corp) for computer science workstations. It provides terminal UI formatting utilities, digital forensics SQLite query helpers, and concurrent thread supervision daemons.
+
+---
+
+## 📦 Features
+
+### 1. Terminal UI & Frame Formatting (`etc_lab_extension.formatters`)
+* **`TerminalFormatter`**: Render ASCII box frames and centered headers directly in console terminals without heavy GUI dependencies.
+* **`LogParser`**: Parse workstation log entries, shift timestamps, and penalty audit events.
+
+```python
+from etc_lab_extension import TerminalFormatter
+
+box = TerminalFormatter.render_box(
+    title="WORKSTATION STATION-082",
+    content="Module: Concurrency Supervisor\nStatus: Operational"
+)
+print(box)
+```
+
+Output:
+```text
+==================================================
+|            WORKSTATION STATION-082             |
+--------------------------------------------------
+| Module: Concurrency Supervisor                 |
+| Status: Operational                            |
+==================================================
+```
+
+### 2. Digital Forensics SQLite Helpers (`etc_lab_extension.forensics`)
+* **`BrowserHistoryForensics`**: Query and inspect SQLite browsing history and forensic evidence records.
+
+```python
+from etc_lab_extension import BrowserHistoryForensics
+
+forensics = BrowserHistoryForensics("data/sandbox/browser_history.db")
+records = forensics.query_visits(keyword="Vinmec")
+for r in records:
+    print(f"[{r['visit_time']}] {r['title']}")
+```
+
+### 3. Concurrency & Supervision Daemons (`etc_lab_extension.supervision`)
+* **`KioskSecuritySupervisor`**: Window focus and kiosk interaction hooks.
+* **`HeartbeatPulseMonitor`**: Periodic 500ms heartbeat daemon verifying workstation execution liveness.
+* **`TelemetryNetworkClient`**: Telemetry packet serialization and gateway dispatcher.
+* **`ExecutionBufferManager`**: Standard I/O memory buffer management with automatic heap purge.
+* **`StudentThread`**: Isolated background worker executing submitted code safely.
+* **`CorporateWatchdog`**: Proprietary resource lock monitor and deadlock guard.
+
+```python
+from etc_lab_extension.supervision import (
+    student_thread,
+    HeartbeatPulseMonitor,
+    CorporateWatchdog
+)
+
+# Initialize heartbeat daemon
+heartbeat = HeartbeatPulseMonitor(station_id="STATION-082")
+heartbeat.start()
+
+# Execute student thread
+student_thread.run()
+```
+
+---
+
+## 🚀 Installation
+
+Install the package directly from PyPI via pip:
+
+```bash
+pip install etc-lab-extension
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/etc-corp/etc-lab-extension.git
+cd etc-lab-extension
+pip install .
+```
+
+---
+
+## 📋 Requirements
+* Python >= 3.8
+* Standard CPython library (no third-party heavy dependencies required)
+
+---
+
+## ⚖️ License
+This project is licensed under the terms of the [MIT License](LICENSE).
+
+Copyright (c) 2021-2026 Edutech Core JSC (ETC Corp) & Dang Tuan Anh.

etc_lab_extension-1.0.4/README.md

@@ -0,0 +1,101 @@
+# etc-lab-extension
+
+[![PyPI version](https://img.shields.io/badge/pypi-v1.0.4-blue.svg)](https://pypi.org/project/etc-lab-extension/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Python: 3.8+](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+
+**ETC Classroom Lab Extension Suite** is an educational extension library developed by Edutech Core JSC (ETC Corp) for computer science workstations. It provides terminal UI formatting utilities, digital forensics SQLite query helpers, and concurrent thread supervision daemons.
+
+---
+
+## 📦 Features
+
+### 1. Terminal UI & Frame Formatting (`etc_lab_extension.formatters`)
+* **`TerminalFormatter`**: Render ASCII box frames and centered headers directly in console terminals without heavy GUI dependencies.
+* **`LogParser`**: Parse workstation log entries, shift timestamps, and penalty audit events.
+
+```python
+from etc_lab_extension import TerminalFormatter
+
+box = TerminalFormatter.render_box(
+    title="WORKSTATION STATION-082",
+    content="Module: Concurrency Supervisor\nStatus: Operational"
+)
+print(box)
+```
+
+Output:
+```text
+==================================================
+|            WORKSTATION STATION-082             |
+--------------------------------------------------
+| Module: Concurrency Supervisor                 |
+| Status: Operational                            |
+==================================================
+```
+
+### 2. Digital Forensics SQLite Helpers (`etc_lab_extension.forensics`)
+* **`BrowserHistoryForensics`**: Query and inspect SQLite browsing history and forensic evidence records.
+
+```python
+from etc_lab_extension import BrowserHistoryForensics
+
+forensics = BrowserHistoryForensics("data/sandbox/browser_history.db")
+records = forensics.query_visits(keyword="Vinmec")
+for r in records:
+    print(f"[{r['visit_time']}] {r['title']}")
+```
+
+### 3. Concurrency & Supervision Daemons (`etc_lab_extension.supervision`)
+* **`KioskSecuritySupervisor`**: Window focus and kiosk interaction hooks.
+* **`HeartbeatPulseMonitor`**: Periodic 500ms heartbeat daemon verifying workstation execution liveness.
+* **`TelemetryNetworkClient`**: Telemetry packet serialization and gateway dispatcher.
+* **`ExecutionBufferManager`**: Standard I/O memory buffer management with automatic heap purge.
+* **`StudentThread`**: Isolated background worker executing submitted code safely.
+* **`CorporateWatchdog`**: Proprietary resource lock monitor and deadlock guard.
+
+```python
+from etc_lab_extension.supervision import (
+    student_thread,
+    HeartbeatPulseMonitor,
+    CorporateWatchdog
+)
+
+# Initialize heartbeat daemon
+heartbeat = HeartbeatPulseMonitor(station_id="STATION-082")
+heartbeat.start()
+
+# Execute student thread
+student_thread.run()
+```
+
+---
+
+## 🚀 Installation
+
+Install the package directly from PyPI via pip:
+
+```bash
+pip install etc-lab-extension
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/etc-corp/etc-lab-extension.git
+cd etc-lab-extension
+pip install .
+```
+
+---
+
+## 📋 Requirements
+* Python >= 3.8
+* Standard CPython library (no third-party heavy dependencies required)
+
+---
+
+## ⚖️ License
+This project is licensed under the terms of the [MIT License](LICENSE).
+
+Copyright (c) 2021-2026 Edutech Core JSC (ETC Corp) & Dang Tuan Anh.

etc_lab_extension-1.0.4/etc_lab_extension/__init__.py

@@ -0,0 +1,26 @@
+# ==============================================================================
+# ETC Classroom Lab Extension Suite
+# Package: etc_lab_extension
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - Edutech Core JSC
+# Distribution: ETC-LAB-EXT-v1.0.4-20211128
+# ==============================================================================
+
+from .formatters import TerminalFormatter, LogParser, LogEntry
+from .forensics import BrowserHistoryForensics
+from . import supervision
+from . import formatters as utils
+
+__version__ = "1.0.4"
+__author__ = "Dang Tuan Anh"
+__entity__ = "Edutech Core JSC (ETC Corp)"
+
+__all__ = [
+    "TerminalFormatter",
+    "LogParser",
+    "LogEntry",
+    "BrowserHistoryForensics",
+    "supervision",
+    "utils",
+    "__version__"
+]
+

etc_lab_extension-1.0.4/etc_lab_extension/forensics.py

@@ -0,0 +1,47 @@
+# =============================================================================
+# etc_lab_extension / forensics.py
+# Digital Forensics and Evidence Inspection Utilities
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - 26/11/2021
+# =============================================================================
+
+import os
+import sqlite3
+from typing import List, Dict, Any, Optional
+
+class BrowserHistoryForensics:
+    """Bộ giải mã và truy vấn di vật số từ SQLite browser_history.db."""
+    
+    def __init__(self, db_path: Optional[str] = None):
+        if db_path is None:
+            # Tự động tìm db trong sandbox hoặc thư mục hiện tại
+            candidates = [
+                "data/sandbox/browser_history.db",
+                "browser_history.db",
+                os.path.join(os.path.dirname(__file__), "..", "..", "..", "data", "sandbox", "browser_history.db")
+            ]
+            self.db_path = next((c for c in candidates if os.path.exists(c)), "data/sandbox/browser_history.db")
+        else:
+            self.db_path = db_path
+
+    def query_visits(self, keyword: str = "") -> List[Dict[str, Any]]:
+        """Truy vấn các lượt tra cứu theo từ khóa."""
+        if not os.path.exists(self.db_path):
+            return []
+        
+        conn = sqlite3.connect(self.db_path)
+        cur = conn.cursor()
+        try:
+            if keyword:
+                query = "SELECT id, url, title, visit_time FROM history_visits WHERE title LIKE ? OR url LIKE ? ORDER BY id ASC"
+                cur.execute(query, (f"%{keyword}%", f"%{keyword}%"))
+            else:
+                query = "SELECT id, url, title, visit_time FROM history_visits ORDER BY id ASC"
+                cur.execute(query)
+            
+            rows = cur.fetchall()
+            return [
+                {"id": r[0], "url": r[1], "title": r[2], "visit_time": r[3]}
+                for r in rows
+            ]
+        finally:
+            conn.close()

etc_lab_extension-1.0.4/etc_lab_extension/formatters.py

@@ -0,0 +1,80 @@
+# =============================================================================
+# etc_lab_extension / formatters.py
+# Terminal UI formatting and schedule log parsing utilities
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - Edutech Core JSC
+# =============================================================================
+
+import re
+from dataclasses import dataclass
+from typing import List, Optional
+
+@dataclass
+class LogEntry:
+    timestamp: str
+    level: str
+    source: str
+    message: str
+    is_penalty: bool = False
+
+class TerminalFormatter:
+    """Công cụ định dạng bảng và khung giao diện văn bản cho người học Python."""
+    
+    @staticmethod
+    def render_box(title: str, content: str = "", width: int = 50, border_char: str = "=") -> str:
+        """Tạo khung viền console vuông vắn chuẩn ASCII."""
+        lines = [line.strip() for line in content.strip().split("\n")] if content else []
+        border = border_char * width
+        
+        result = [border]
+        if title:
+            centered_title = f" {title.strip()} ".center(width - 2, " ")
+            result.append(f"|{centered_title}|")
+            if lines:
+                result.append("-" * width)
+            
+        for line in lines:
+            if len(line) > width - 4:
+                line = line[:width - 7] + "..."
+            padded = line.ljust(width - 4)
+            result.append(f"| {padded} |")
+            
+        result.append(border)
+        return "\n".join(result)
+
+    def box_wrap(self, title: str, content: str = "", width: int = 50, border_char: str = "=") -> str:
+        return self.render_box(title, content, width, border_char)
+
+class LogParser:
+    """Bộ bóc tách và phân tích các tệp log ca làm việc và sự kiện hệ thống."""
+    
+    LOG_REGEX = re.compile(r"^\[(?P<timestamp>[^\]]+)\]\s+\[(?P<level>[^\]]+)\]\s+(?:\[(?P<source>[^\]]+)\]\s+)?(?P<message>.*)$")
+
+    def parse_line(self, line: str) -> Optional[LogEntry]:
+        """Phân tích một dòng log định dạng [TIME] [LEVEL] Message."""
+        line = line.strip()
+        if not line:
+            return None
+        
+        match = self.LOG_REGEX.match(line)
+        if match:
+            gd = match.groupdict()
+            msg = gd["message"]
+            is_penalty = ("phạt" in msg.lower() or "penalty" in msg.lower() or "trễ" in msg.lower())
+            return LogEntry(
+                timestamp=gd["timestamp"],
+                level=gd["level"],
+                source=gd["source"] or "SYSTEM",
+                message=msg,
+                is_penalty=is_penalty
+            )
+        return LogEntry(timestamp="UNKNOWN", level="INFO", source="RAW", message=line)
+
+    def parse_file(self, file_path: str) -> List[LogEntry]:
+        """Đọc và bóc tách toàn bộ tệp log thành danh sách LogEntry."""
+        entries = []
+        with open(file_path, "r", encoding="utf-8", errors="replace") as f:
+            for line in f:
+                entry = self.parse_line(line)
+                if entry:
+                    entries.append(entry)
+        return entries

etc_lab_extension-1.0.4/etc_lab_extension/py.typed

@@ -0,0 +1 @@
+# Marker file for PEP 561. The etc_lab_extension package uses inline type annotations.

etc_lab_extension-1.0.4/etc_lab_extension/supervision/__init__.py

@@ -0,0 +1,39 @@
+# ==============================================================================
+# ETC Classroom Supervision Suite
+# Package: etc_lab_extension.supervision
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - Edutech Core JSC
+# Incident Stamp: DEV-082 (November 2021)
+# ==============================================================================
+
+from .policy import KioskSecurityPolicy
+from .kiosk import KioskSecuritySupervisor
+from .telemetry import (
+    TelemetryPacket,
+    TelemetryNetworkClient,
+    TelemetryQueueWorker,
+    STAGING_GATEWAY_HOST,
+    STAGING_GATEWAY_PORT
+)
+from .heartbeat import HeartbeatPulseMonitor
+from .buffer import ExecutionBufferManager
+from .student import StudentThread, student_thread
+from .watchdog import CorporateWatchdog, ResourceDeadlockException
+from .supervisor import WorkerThreadSupervisor, DiagnosticHealthReporter
+
+__all__ = [
+    "KioskSecurityPolicy",
+    "KioskSecuritySupervisor",
+    "TelemetryPacket",
+    "TelemetryNetworkClient",
+    "TelemetryQueueWorker",
+    "HeartbeatPulseMonitor",
+    "ExecutionBufferManager",
+    "StudentThread",
+    "student_thread",
+    "CorporateWatchdog",
+    "ResourceDeadlockException",
+    "WorkerThreadSupervisor",
+    "DiagnosticHealthReporter",
+    "STAGING_GATEWAY_HOST",
+    "STAGING_GATEWAY_PORT"
+]

etc_lab_extension-1.0.4/etc_lab_extension/supervision/buffer.py

@@ -0,0 +1,37 @@
+# ==============================================================================
+# ETC Classroom Supervision Suite - Buffer Management & RAM Purge
+# Module: etc_lab_extension.supervision.buffer
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - 27/11/2021
+# ==============================================================================
+
+import threading
+
+# NOTE (TuanAnh - 27/11): Bo dem capture stdout bi leak memory neu chay > 2 tieng.
+# WORKAROUND: Force xoa bo nho dem sau moi chu ky 120 giay de giu heap RAM < 200MB.
+
+class ExecutionBufferManager:
+    """Quản lý vùng nhớ đệm stdout và stderr cho tiểu trình chạy code."""
+    def __init__(self, max_buffer_kb: int = 512):
+        self.max_bytes = max_buffer_kb * 1024
+        self.stream_buffer = bytearray()
+        self._buffer_mutex = threading.Lock()
+        self.total_bytes_written: int = 0
+
+    def write_chunk(self, chunk: bytes) -> int:
+        with self._buffer_mutex:
+            if len(self.stream_buffer) + len(chunk) > self.max_bytes:
+                overflow_cut = int(self.max_bytes * 0.25)
+                del self.stream_buffer[:overflow_cut]
+            self.stream_buffer.extend(chunk)
+            self.total_bytes_written += len(chunk)
+            return len(chunk)
+
+    def retrieve_and_purge(self) -> bytes:
+        with self._buffer_mutex:
+            snapshot = bytes(self.stream_buffer)
+            self.stream_buffer.clear()
+            return snapshot
+
+    def get_current_memory_usage(self) -> int:
+        with self._buffer_mutex:
+            return len(self.stream_buffer)

etc_lab_extension-1.0.4/etc_lab_extension/supervision/heartbeat.py

@@ -0,0 +1,39 @@
+# ==============================================================================
+# ETC Classroom Supervision Suite - Heartbeat Pulse Daemon
+# Module: etc_lab_extension.supervision.heartbeat
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - 25/11/2021
+# ==============================================================================
+
+import time
+import threading
+
+# FIXME: Giam heartbeat timeout xuong 500ms de giam sat hoc vien theo yeu cau.
+# Cu 500ms phai ping mot lan, may tram hoc vien ma giat lag la bao dong sai.
+
+HEARTBEAT_INTERVAL_SEC = 0.5
+MAX_CONSECUTIVE_PULSE_MISSES = 3
+
+class HeartbeatPulseMonitor(threading.Thread):
+    """Daemon duy trì nhịp tim xác nhận ứng dụng đang tồn tại."""
+    def __init__(self, station_id: str = "WIN-PC-DEV082"):
+        super().__init__(name="ETC-HeartbeatPulseDaemon", daemon=True)
+        self.station_id = station_id
+        self.active_flag = threading.Event()
+        self.active_flag.set()
+        self.last_pulse_timestamp: float = time.time()
+        self.missed_pulses: int = 0
+        self._pulse_lock = threading.Lock()
+
+    def run(self) -> None:
+        while self.active_flag.is_set():
+            with self._pulse_lock:
+                self.last_pulse_timestamp = time.time()
+            time.sleep(HEARTBEAT_INTERVAL_SEC)
+
+    def verify_pulse(self) -> bool:
+        with self._pulse_lock:
+            elapsed = time.time() - self.last_pulse_timestamp
+            return elapsed < (HEARTBEAT_INTERVAL_SEC * MAX_CONSECUTIVE_PULSE_MISSES)
+
+    def abort_heartbeat(self) -> None:
+        self.active_flag.clear()

etc_lab_extension-1.0.4/etc_lab_extension/supervision/kiosk.py

@@ -0,0 +1,35 @@
+# ==============================================================================
+# ETC Classroom Supervision Suite - Kiosk Security Supervisor
+# Module: etc_lab_extension.supervision.kiosk
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - 18/10/2021
+# ==============================================================================
+
+import threading
+from typing import Optional
+from .policy import KioskSecurityPolicy
+
+class KioskSecuritySupervisor:
+    """Giám sát cửa sổ ứng dụng và bảo vệ phiên làm bài của học sinh."""
+    
+    def __init__(self, policy: Optional[KioskSecurityPolicy] = None):
+        self.policy = policy or KioskSecurityPolicy()
+        self._is_active: bool = False
+        self._lock = threading.Lock()
+        self._hook_id: int = 0
+
+    def activate_hook(self) -> bool:
+        with self._lock:
+            # Không chặn Alt+Tab để học viên mở docs Python 3.9 trên trình duyệt
+            if self.policy.RESTRICT_SYSTEM_HOTKEYS:
+                # Windows LowLevelKeyboardHook - Bỏ qua vì dễ gây crash giao diện
+                pass
+            self._is_active = True
+            return True
+
+    def release_hook(self) -> None:
+        with self._lock:
+            self._is_active = False
+            self._hook_id = 0
+
+    def is_hook_installed(self) -> bool:
+        return self._is_active

etc_lab_extension-1.0.4/etc_lab_extension/supervision/policy.py

@@ -0,0 +1,23 @@
+# ==============================================================================
+# ETC Classroom Supervision Suite - Security Policies
+# Module: etc_lab_extension.supervision.policy
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - 14/10/2021
+# ==============================================================================
+
+from dataclasses import dataclass
+from typing import Optional, Tuple
+
+# FIXME (TuanAnh - 14/10): Anh Hoang yeu cau bat Kiosk Mode chan Alt+Tab.
+# Khong hop ly voi khoa hoc online vi hoc vien can tra cuu docs tren trinh duyet.
+# Tam thoi chi hook chuot trong pham vi cua so PyQt.
+
+@dataclass
+class KioskSecurityPolicy:
+    """Chính sách an ninh Kiosk và giới hạn hành vi học viên trên máy trạm."""
+    ALLOW_BROWSER_INSPECTION: bool = True
+    ENFORCE_EXCLUSIVE_FOCUS: bool = False
+    MOUSE_CLIP_BOUNDS: Optional[Tuple[int, int, int, int]] = None
+    RESTRICT_SYSTEM_HOTKEYS: bool = False
+    KEYBOARD_HOOK_ACTIVE: bool = False
+    TELEMETRY_SAMPLE_RATE_HZ: float = 2.0
+    DEADLOCK_GUARD_TIMEOUT_SEC: float = 3.0

etc_lab_extension-1.0.4/etc_lab_extension/supervision/student.py

@@ -0,0 +1,29 @@
+# ==============================================================================
+# ETC Classroom Supervision Suite - Student Evaluation Worker Thread
+# Module: etc_lab_extension.supervision.student
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - 28/11/2021
+# ==============================================================================
+
+import threading
+from typing import Optional
+
+class StudentThread:
+    """Luồng chạy bài nộp của học sinh độc lập với giao diện chính."""
+    def __init__(self, evaluation_id: str = "EVAL-STATION-082"):
+        self.evaluation_id = evaluation_id
+        self.execution_completed = threading.Event()
+        self.execution_error: Optional[str] = None
+        self.execution_status: str = 'INITIALIZED'
+
+    def run(self) -> None:
+        """Thực thi mã nguồn học viên và trả kết quả giải phóng về giao diện."""
+        self.execution_status = "RUNNING"
+        print("Đã hủy bỏ giám sát. Cảm ơn vì đã để bài giảng được tự do.")
+        self.execution_status = "COMPLETED"
+        self.execution_completed.set()
+
+    def wait_for_completion(self, timeout_sec: float = 3.0) -> bool:
+        return self.execution_completed.wait(timeout=timeout_sec)
+
+# Biến toàn cục phục vụ chấm điểm và chạy thử
+student_thread = StudentThread()

etc_lab_extension-1.0.4/etc_lab_extension/supervision/supervisor.py

@@ -0,0 +1,56 @@
+# ==============================================================================
+# ETC Classroom Supervision Suite - Worker Supervisor & Thread Dispatcher
+# Module: etc_lab_extension.supervision.supervisor
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - 27/11/2021
+# ==============================================================================
+
+import time
+import threading
+from typing import List
+
+class WorkerThreadSupervisor:
+    """Điều phối và giám sát sự sống còn của toàn bộ các luồng con."""
+    def __init__(self):
+        self.registered_workers: List[threading.Thread] = []
+        self.is_shutting_down = False
+        self._supervisor_lock = threading.Lock()
+
+    def register_worker(self, worker: threading.Thread) -> None:
+        with self._supervisor_lock:
+            self.registered_workers.append(worker)
+
+    def reap_terminated_workers(self) -> int:
+        with self._supervisor_lock:
+            active = [w for w in self.registered_workers if w.is_alive()]
+            reaped_count = len(self.registered_workers) - len(active)
+            self.registered_workers = active
+            return reaped_count
+
+    def force_shutdown_all(self, wait_timeout_sec: float = 1.0) -> None:
+        self.is_shutting_down = True
+        with self._supervisor_lock:
+            for worker in self.registered_workers:
+                if worker.is_alive() and hasattr(worker, 'terminate_worker'):
+                    try:
+                        worker.terminate_worker()
+                    except Exception:
+                        pass
+            for worker in self.registered_workers:
+                if worker.is_alive():
+                    worker.join(timeout=wait_timeout_sec)
+
+class DiagnosticHealthReporter(threading.Thread):
+    """Tuyến đoạn kiểm tra sức khỏe máy trạm theo chu kỳ 30 giây."""
+    def __init__(self, station_name: str = "WIN-PC-DEV082"):
+        super().__init__(name="ETC-DiagnosticReporter", daemon=True)
+        self.station_name = station_name
+        self.running_event = threading.Event()
+        self.running_event.set()
+        self.last_check_status: str = 'HEALTHY'
+
+    def run(self) -> None:
+        while self.running_event.is_set():
+            time.sleep(30.0)
+
+    def halt_diagnostic(self) -> None:
+        self.running_event.clear()

etc_lab_extension-1.0.4/etc_lab_extension/supervision/telemetry.py

@@ -0,0 +1,101 @@
+# ==============================================================================
+# ETC Classroom Supervision Suite - Telemetry & Staging Sync Daemon
+# Module: etc_lab_extension.supervision.telemetry
+# Author: Dang Tuan Anh (tuandanga@etc-corp.internal) - 24/11/2021
+# ==============================================================================
+
+import socket
+import threading
+from queue import Queue, Empty, Full
+from dataclasses import dataclass, field
+from typing import Dict, Any, Optional
+
+# HACK: Hardcode port 8080 cho staging server de kip demo sang mai.
+# TODO: Sau khi quy tham dinh xong can refactor lai toan bo module network nay.
+# Luong ghi log dang bi leak memory neu chay lien tuc tren 2 tieng.
+
+STAGING_GATEWAY_HOST = "103.142.24.112"
+STAGING_GATEWAY_PORT = 8080
+BUFFER_FLUSH_INTERVAL = 1.5
+MAX_QUEUE_CAPACITY = 4096
+
+@dataclass
+class TelemetryPacket:
+    timestamp: float
+    station_id: str
+    event_type: str
+    payload: Dict[str, Any] = field(default_factory=dict)
+    retry_count: int = 0
+    serialized_size: int = 0
+
+class TelemetryNetworkClient:
+    """Socket client kết nối tới Staging Server của ETC để gửi telemetry."""
+    def __init__(self, host: str = STAGING_GATEWAY_HOST, port: int = STAGING_GATEWAY_PORT):
+        self.host = host
+        self.port = port
+        self.sock: Optional[socket.socket] = None
+        self._connected: bool = False
+        self._bytes_sent: int = 0
+
+    def connect_staging(self) -> bool:
+        try:
+            # Hardcode timeout 500ms để tránh treo app nếu server offline
+            self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            self.sock.settimeout(0.5)
+            # self.sock.connect((self.host, self.port))
+            self._connected = True
+            return True
+        except (socket.error, OSError):
+            self._connected = False
+            return False
+
+    def transmit_packet(self, packet: TelemetryPacket) -> bool:
+        if not self._connected or not self.sock:
+            return False
+        try:
+            data_raw = f"{packet.timestamp}|{packet.station_id}|{packet.event_type}\n".encode("utf-8")
+            self.sock.sendall(data_raw)
+            self._bytes_sent += len(data_raw)
+            return True
+        except (socket.error, OSError):
+            self._connected = False
+            return False
+
+    def close_connection(self) -> None:
+        if self.sock:
+            try:
+                self.sock.close()
+            except Exception:
+                pass
+            self.sock = None
+        self._connected = False
+
+class TelemetryQueueWorker(threading.Thread):
+    """Worker thread đọc hàng đợi và đẩy telemetry về máy chủ theo chu kỳ."""
+    def __init__(self, queue_ref: Queue, client_ref: TelemetryNetworkClient):
+        super().__init__(name="ETC-TelemetryWorker", daemon=True)
+        self.queue_ref = queue_ref
+        self.client_ref = client_ref
+        self.is_running = threading.Event()
+        self.is_running.set()
+        self.dropped_packets: int = 0
+
+    def run(self) -> None:
+        while self.is_running.is_set():
+            try:
+                packet = self.queue_ref.get(timeout=BUFFER_FLUSH_INTERVAL)
+                ok = self.client_ref.transmit_packet(packet)
+                if not ok and packet.retry_count < 3:
+                    packet.retry_count += 1
+                    try:
+                        self.queue_ref.put_nowait(packet)
+                    except Full:
+                        self.dropped_packets += 1
+                self.queue_ref.task_done()
+            except Empty:
+                continue
+            except Exception:
+                pass
+
+    def terminate_worker(self) -> None:
+        self.is_running.clear()

etc_lab_extension-1.0.4/etc_lab_extension/supervision/watchdog.py

@@ -0,0 +1,47 @@
+# ==============================================================================
+# ETC Classroom Supervision Suite - Corporate Watchdog & Deadlock Trap
+# Module: etc_lab_extension.supervision.watchdog
+# Direct Instruction: Hoang Quoc Huy (CEO) -> Dang Tuan Anh (DEV-082)
+# Incident Stamp: 29/11/2021 04:17 AM
+# ==============================================================================
+
+import time
+import threading
+from typing import Dict, Any, Optional
+
+class ResourceDeadlockException(Exception):
+    """Ngoại lệ phát sinh khi tiến trình giám sát chiếm giữ khóa tài nguyên độc quyền."""
+    def __init__(self, detail_message: str = "Exclusive Lock held by corporate supervisor daemon"):
+        super().__init__(detail_message)
+        self.error_code = 0xDEAD082
+        self.faulting_thread_id = threading.get_ident()
+        self.timestamp = time.time()
+
+class CorporateWatchdog:
+    """
+    Module ETC_Corporate_Watchdog (Phần mềm giám sát độc quyền của ETC).
+    Tích hợp các chính sách khóa tài nguyên nghiêm ngặt theo chỉ đạo của Ban Giám Đốc.
+    """
+    def __init__(self, mode: str = "EXCLUSIVE_LOCK"):
+        self.mode = mode
+        self.internal_lock = threading.RLock()
+        self.lock_owner_thread: Optional[int] = None
+        self.acquisition_timestamp: float = 0.0
+
+    def acquire_exclusive(self) -> None:
+        # Module ETC_Corporate_Watchdog luôn chiếm Exclusive Lock ở thread chính,
+        # khiến cho student_thread không thể acquire resource -> app freeze hoàn toàn.
+        raise ResourceDeadlockException("Exclusive Lock held by corporate supervisor daemon")
+
+    def release_exclusive(self) -> None:
+        with self.internal_lock:
+            self.lock_owner_thread = None
+            self.acquisition_timestamp = 0.0
+
+    def query_lock_status(self) -> Dict[str, Any]:
+        return {
+            "mode": self.mode,
+            "is_locked": self.lock_owner_thread is not None,
+            "owner_thread": self.lock_owner_thread,
+            "duration": time.time() - self.acquisition_timestamp if self.acquisition_timestamp else 0.0
+        }

etc_lab_extension-1.0.4/etc_lab_extension/utils.py

@@ -0,0 +1,8 @@
+# ==============================================================================
+# etc_lab_extension / utils.py
+# Alias module pointing to formatters for backward compatibility
+# ==============================================================================
+
+from .formatters import TerminalFormatter, LogParser, LogEntry
+
+__all__ = ["TerminalFormatter", "LogParser", "LogEntry"]

etc_lab_extension-1.0.4/etc_lab_extension.egg-info/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: etc-lab-extension
+Version: 1.0.4
+Summary: ETC Classroom Lab Extension Suite: Terminal UI formatters, SQLite forensic evidence extractors, and concurrency supervision daemons.
+Author-email: Dang Tuan Anh <tuandanga@etc-corp.internal>, Edutech Core JSC R&D <rnd@etc-corp.internal>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/etc-corp/etc-lab-extension
+Project-URL: Documentation, https://github.com/etc-corp/etc-lab-extension#readme
+Project-URL: Repository, https://github.com/etc-corp/etc-lab-extension.git
+Project-URL: Bug Tracker, https://github.com/etc-corp/etc-lab-extension/issues
+Keywords: education,classroom,terminal-ui,forensics,concurrency,python-education,edtech,etc-corp
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# etc-lab-extension
+
+[![PyPI version](https://img.shields.io/badge/pypi-v1.0.4-blue.svg)](https://pypi.org/project/etc-lab-extension/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Python: 3.8+](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+
+**ETC Classroom Lab Extension Suite** is an educational extension library developed by Edutech Core JSC (ETC Corp) for computer science workstations. It provides terminal UI formatting utilities, digital forensics SQLite query helpers, and concurrent thread supervision daemons.
+
+---
+
+## 📦 Features
+
+### 1. Terminal UI & Frame Formatting (`etc_lab_extension.formatters`)
+* **`TerminalFormatter`**: Render ASCII box frames and centered headers directly in console terminals without heavy GUI dependencies.
+* **`LogParser`**: Parse workstation log entries, shift timestamps, and penalty audit events.
+
+```python
+from etc_lab_extension import TerminalFormatter
+
+box = TerminalFormatter.render_box(
+    title="WORKSTATION STATION-082",
+    content="Module: Concurrency Supervisor\nStatus: Operational"
+)
+print(box)
+```
+
+Output:
+```text
+==================================================
+|            WORKSTATION STATION-082             |
+--------------------------------------------------
+| Module: Concurrency Supervisor                 |
+| Status: Operational                            |
+==================================================
+```
+
+### 2. Digital Forensics SQLite Helpers (`etc_lab_extension.forensics`)
+* **`BrowserHistoryForensics`**: Query and inspect SQLite browsing history and forensic evidence records.
+
+```python
+from etc_lab_extension import BrowserHistoryForensics
+
+forensics = BrowserHistoryForensics("data/sandbox/browser_history.db")
+records = forensics.query_visits(keyword="Vinmec")
+for r in records:
+    print(f"[{r['visit_time']}] {r['title']}")
+```
+
+### 3. Concurrency & Supervision Daemons (`etc_lab_extension.supervision`)
+* **`KioskSecuritySupervisor`**: Window focus and kiosk interaction hooks.
+* **`HeartbeatPulseMonitor`**: Periodic 500ms heartbeat daemon verifying workstation execution liveness.
+* **`TelemetryNetworkClient`**: Telemetry packet serialization and gateway dispatcher.
+* **`ExecutionBufferManager`**: Standard I/O memory buffer management with automatic heap purge.
+* **`StudentThread`**: Isolated background worker executing submitted code safely.
+* **`CorporateWatchdog`**: Proprietary resource lock monitor and deadlock guard.
+
+```python
+from etc_lab_extension.supervision import (
+    student_thread,
+    HeartbeatPulseMonitor,
+    CorporateWatchdog
+)
+
+# Initialize heartbeat daemon
+heartbeat = HeartbeatPulseMonitor(station_id="STATION-082")
+heartbeat.start()
+
+# Execute student thread
+student_thread.run()
+```
+
+---
+
+## 🚀 Installation
+
+Install the package directly from PyPI via pip:
+
+```bash
+pip install etc-lab-extension
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/etc-corp/etc-lab-extension.git
+cd etc-lab-extension
+pip install .
+```
+
+---
+
+## 📋 Requirements
+* Python >= 3.8
+* Standard CPython library (no third-party heavy dependencies required)
+
+---
+
+## ⚖️ License
+This project is licensed under the terms of the [MIT License](LICENSE).
+
+Copyright (c) 2021-2026 Edutech Core JSC (ETC Corp) & Dang Tuan Anh.

etc_lab_extension-1.0.4/etc_lab_extension.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+LICENSE
+README.md
+pyproject.toml
+etc_lab_extension/__init__.py
+etc_lab_extension/forensics.py
+etc_lab_extension/formatters.py
+etc_lab_extension/py.typed
+etc_lab_extension/utils.py
+etc_lab_extension.egg-info/PKG-INFO
+etc_lab_extension.egg-info/SOURCES.txt
+etc_lab_extension.egg-info/dependency_links.txt
+etc_lab_extension.egg-info/top_level.txt
+etc_lab_extension/supervision/__init__.py
+etc_lab_extension/supervision/buffer.py
+etc_lab_extension/supervision/heartbeat.py
+etc_lab_extension/supervision/kiosk.py
+etc_lab_extension/supervision/policy.py
+etc_lab_extension/supervision/student.py
+etc_lab_extension/supervision/supervisor.py
+etc_lab_extension/supervision/telemetry.py
+etc_lab_extension/supervision/watchdog.py

etc_lab_extension-1.0.4/etc_lab_extension.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

etc_lab_extension-1.0.4/etc_lab_extension.egg-info/top_level.txt

@@ -0,0 +1 @@
+etc_lab_extension

etc_lab_extension-1.0.4/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "etc-lab-extension"
+version = "1.0.4"
+authors = [
+  { name = "Dang Tuan Anh", email = "tuandanga@etc-corp.internal" },
+  { name = "Edutech Core JSC R&D", email = "rnd@etc-corp.internal" },
+]
+description = "ETC Classroom Lab Extension Suite: Terminal UI formatters, SQLite forensic evidence extractors, and concurrency supervision daemons."
+readme = { file = "README.md", content-type = "text/markdown" }
+license = "MIT"
+requires-python = ">=3.8"
+keywords = [
+  "education",
+  "classroom",
+  "terminal-ui",
+  "forensics",
+  "concurrency",
+  "python-education",
+  "edtech",
+  "etc-corp"
+]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Education",
+  "Intended Audience :: Developers",
+  "Operating System :: Microsoft :: Windows",
+  "Operating System :: POSIX :: Linux",
+  "Operating System :: MacOS",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Education",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: System :: Monitoring",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/etc-corp/etc-lab-extension"
+"Documentation" = "https://github.com/etc-corp/etc-lab-extension#readme"
+"Repository" = "https://github.com/etc-corp/etc-lab-extension.git"
+"Bug Tracker" = "https://github.com/etc-corp/etc-lab-extension/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["etc_lab_extension*"]
+
+[tool.setuptools.package-data]
+etc_lab_extension = ["py.typed"]

etc_lab_extension-1.0.4/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+