Skip to content

MangoThonny v0.4.2

Choose a tag to compare

@circleoyang circleoyang released this 09 Sep 17:21
· 112 commits to main since this release
b08cd2f

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 through View -> 顯示 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.jsonl into the student's current working directory;
  • polling sensor reads use api_call semantics while true device transitions remain sensor_event records;
  • 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.json and summary.csv;
  • summary.csv is 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-rc3 GUI 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.2 Portable Build + Package Verification: PASS;
  • exact v0.4.2 Installer build: PASS;
  • installed mangothonny-build.json reports 0.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.