Repository navigation
MangoThonny v0.4.2
·
112 commits
to main
since this release
MangoThonny v0.4.2 Release Notes
Date: 2026-09-10
Learning Log release
MangoThonny v0.4.2 adds the first integrated MangoBox Learning Log workflow for Host Python and High-Level MicroPython while keeping ordinary learner Shell output readable.
Added / changed
- High-Level MicroPython raw
@@MANGO_EVENT@@output is hidden by default from the learner Shell and can be re-enabled throughView -> 顯示 High-Level MicroPython 原始紀錄; - hiding raw event text affects display only and does not disable Learning Log capture;
- Host Python and High-Level MicroPython write into the same per-user Learning Log store under
%LOCALAPPDATA%\MangoBox\MangoThonny\user_data\logs; - default Host Python event logging no longer writes
mangobox_events.jsonlinto the student's current working directory; - polling sensor reads use
api_callsemantics while true device transitions remainsensor_eventrecords; - Learning Log export UI supports current run, current session, today and custom time range;
- export metadata supports student id and task id without rewriting the canonical local JSONL;
- each export ZIP contains
events.jsonl,manifest.jsonandsummary.csv; summary.csvis Excel-friendly and includes learner/session/run/origin/source/component/action fields;- Learning Log UI was adjusted for Windows DPI scaling so the bottom controls remain accessible;
- MangoThonny title bar and About dialog derive the displayed MangoThonny version from the current build metadata instead of a stale hard-coded value.
Compatibility retained
- Thonny base:
4.1.7; - bundled Python:
3.10.11; - Host Student API:
0.4.6; - canonical Host import:
mangobox; - legacy Host import:
mangox2; - Standard Teaching Packages v1;
- Mango App Exporter;
- Windows AppUserModelID / taskbar identity from
v0.4.1.
Runtime firmware is versioned and released independently. The matching current Runtime baseline is MangoX2 v0.2.7 and MangoLite v0.6.2.
Exact release artifacts
Built locally from code-bearing source commit:
ba182eafb700109cfe0e16a4cc65163003250fc8
MangoThonny-Portable-v0.4.2.zip
SHA-256: FA6F1EDC7852B8905A1ADF66CC5B8D65952250B350C1000327AA8D6401078A12
MangoThonny-Setup-v0.4.2.exe
SHA-256: 0A87386F48F0B1A35955D886C3BC12CB3C18601CC8F213F10531615F1EBB7F57
Installer build size: 92.2 MB.
Language: Traditional Chinese bundled overlay.
Validation summary
- MangoThonny Learning Log regression contract: PASS;
- focused MangoThonny build-info / event-visibility / packaging regression: PASS;
v0.4.2-rc3GUI smoke: PASS;- Learning Log dialog clipping / DPI fix: PASS;
- Host Python capture / export path: PASS;
- High-Level MicroPython capture / display toggle / JSONL path: PASS;
- Learning Log export ZIP / manifest / summary CSV: PASS;
- representative MangoLite + Pico W Light polling capture: PASS;
- representative MangoX2 + Pico and Pico 2 W High-Level Runtime smoke: PASS under the independent Runtime release line;
- exact
v0.4.2Portable Build + Package Verification: PASS; - exact
v0.4.2Installer build: PASS; - installed
mangothonny-build.jsonreports0.4.2: PASS; - installed-mode marker reports
version=0.4.2: PASS.
The final v0.4.2 artifacts differ from the fully smoke-tested v0.4.2-rc3 only by release-version promotion and current-main synchronization that does not change MangoThonny feature behavior.
See V0.4.2_VALIDATION.md for detailed release evidence.