basthon-turtle 0.3.0

Standalone CPython

The browser starts lazily on the first visible turtle operation. It remains alive between commands and receives incremental drawing updates:

from turtle import forward, left

forward(100)
left(90)
forward(50)

Jupyter

Install the portable persistent Jupyter renderer with:

pip install "basthon-turtle[notebook]"

Turtle commands are buffered during each cell and animated in one persistent inline SVG widget after the cell finishes:

from turtle import forward, left

forward(100)
left(90)
forward(50)

For a JupyterLab-specific panel, install basthon-turtle[sidecar] instead. Call jupyter_sidecar(False) before drawing to force the portable inline widget when sidecar is otherwise available. The original done() and svg() workflow remains available.

Marimo

Install the native persistent Marimo renderer with:

pip install "basthon-turtle[notebook]"

from turtle import forward, left

forward(100)
left(90)
forward(50)

The first visible operation mounts a persistent AnyWidget in the current cell. Later turtle calls update that canvas without requiring done() or mo.Html(svg()).

Browser-only Pyodide

Plain Pyodide can host the live mode entirely in one browser tab. Run Python in a Web Worker and forward the semantic turtle protocol to the persistent SVG renderer with postMessage. This keeps animation responsive without a localhost server or WebSocket; see docs/pyodide.md for a complete example.