pydevices-examples/tools/example_interpreters.toml at main · PyDevices/pydevices-examples · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
# Canonical interpreter targets for cross-interpreter example tests.
# Agents: read this file and tools/README.md (Example test matrix) before running.
#
# Run from repo root:
#   python tools/example_test_kit.py

[defaults]
duration_s = 2
timeout_s = 15
oneshot_timeout_s = 10

# Subprocess interpreters — cwd is lib/ unless noted.

[interpreters.micropython]
platform = "micropython"
display_backend = "SDLDisplay"
available_on = ["linux", "wsl", "macos"]
kind = "subprocess"
command = ["micropython"]
cwd = "lib"
resolve = ["PATH", "~/bin/micropython"]
setup_notes = "MicroPython unix build with SDL display support resolved via PATH or ~/bin/micropython."

[interpreters."micropython.exe"]
platform = "micropython"
display_backend = "SDLDisplay"
available_on = ["windows", "wsl"]
kind = "subprocess"
command = ["micropython.exe", "-X", "heapsize=64M"]
cwd = "lib"
resolve = ["PATH", "~/bin/micropython.exe"]
setup_notes = "MicroPython Windows (.exe). Async modes may be limited. Resolved via PATH or ~/bin/micropython.exe."
timeout_s = 25

[interpreters.circuitpython]
platform = "circuitpython"
display_backend = "SDLDisplay"
available_on = ["linux", "wsl", "macos"]
kind = "subprocess"
command = ["circuitpython"]
cwd = "lib"
resolve = ["PATH", "~/bin/circuitpython"]
setup_notes = "CircuitPython unix with SDL resolved via PATH or ~/bin/circuitpython."

[interpreters.cpython-venv]
platform = "cpython"
display_backend = "SDLDisplay"
available_on = ["linux", "wsl", "macos"]
kind = "subprocess"
command = [".venv/bin/python"]
cwd = "lib"
resolve = ["repo:.venv/bin/python"]
setup_notes = "Repo-root .venv (source .venv/bin/activate equivalent)."

[interpreters."python.exe"]
platform = "cpython"
display_backend = "SDLDisplay"
available_on = ["windows", "wsl"]
kind = "subprocess"
command = ["python.exe"]
cwd = "lib"
resolve = ["PATH", "~/bin/python.exe"]
setup_notes = "Windows CPython on PATH."

# Launcher interpreters — cwd is repo root.

[interpreters.pyscript]
platform = "pyscript"
display_backend = "PSDisplay"
available_on = ["linux", "wsl", "macos", "windows"]
kind = "pyscript"
status = "active"
command_template = ["pyscript.py", "-m", "{example}", "--no-open"]
cwd = "."
setup_notes = "Requires portal server or local fallback on port 8000. Host tool: pyscript.py (on PATH)."

[interpreters.jupyter]
platform = "jupyter"
display_backend = "JNDisplay"
available_on = ["linux", "wsl", "macos"]
kind = "jupyter"
status = "active"
command_template = ["jupyter.py", "examples/{example}.py", "--no-open"]
cwd = "lib"
setup_notes = "Requires .venv with jupyterlab, ipywidgets, ipyevents, pillow. Host tool: jupyter.py (on PATH)."

[interpreters.android]
platform = "android"
display_backend = "SDLDisplay"
available_on = ["wsl", "linux"]
kind = "android"
status = "active"
command_template = ["android.py", "examples/{example}.py"]
cwd = "lib"
# Emulator paint is slow; kit uses >=20s oneshot hold + observe (see example_test_kit).
duration_s = 20
timeout_s = 120
oneshot_timeout_s = 45
setup_notes = "Requires adb.exe (WSL) or adb, a connected emulator/device, and the PyDevices Runner APK. Host tool: android.py (on PATH). Opt in with --only-interpreter android (not in the default 5/7 desktop matrix)."