OpenSite/Reference/Features/Python workbench - Revision history

BathAfrica: Link adjacent OpenSite reference pages in reading order

2026-10-29T21:15:45Z

Link adjacent OpenSite reference pages in reading order

← Older revision		Revision as of 14:15, 29 October 2026
Line 27:		Line 27:
	[[Category:OpenSite documentation]]		[[Category:OpenSite documentation]]

	<div class="os-page-nav">{{Docnav\|OpenSite/~~Getting started~~\|OpenSite/~~Guides~~\|OpenSite/Guides\|All guides}}</div>		<div class="os-page-nav">{{Docnav\|OpenSite/Reference/Features/Plugins\|OpenSite/Reference/Features/Python scripting\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Reorganize OpenSite reference with shared scope and related workflows

2026-10-29T20:59:54Z

Reorganize OpenSite reference with shared scope and related workflows

← Older revision		Revision as of 13:59, 29 October 2026
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
			{{OpenSite scope}}
	{{BathAfrica Feature		{{BathAfrica Feature
	\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.
	\|id=python.workbench		\|id=python.workbench
	\|summary=Edit, run, and debug Python in the desktop workbench, and publish Matplotlib figures to a host viewer.		\|summary=Edit, run, and debug Python in the desktop workbench, and publish Matplotlib figures to a host viewer.
Line 14:		Line 14:
	}}		}}


			== Try this workflow ==
			[[OpenSite/Guides/Run your first script\|Run your first script]] — a worked lesson with expected results.

	== Documentation basis ==		== Documentation basis ==
Line 23:		Line 26:
	[[OpenSite\|OpenSite overview]] · [[OpenSite/Reference\|Reference]] · [[OpenSite/Guides\|Guides]]		[[OpenSite\|OpenSite overview]] · [[OpenSite/Reference\|Reference]] · [[OpenSite/Guides\|Guides]]
	[[Category:OpenSite documentation]]		[[Category:OpenSite documentation]]

			<div class="os-page-nav">{{Docnav\|OpenSite/Getting started\|OpenSite/Guides\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Use BathAfrica sidebar contents without duplicate inline contents box

2026-10-29T20:11:42Z

Use BathAfrica sidebar contents without duplicate inline contents box

← Older revision		Revision as of 13:11, 29 October 2026
Line 1:		Line 1:
			__NOTOC__
	{{BathAfrica Feature		{{BathAfrica Feature
	\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.		\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.

BathAfrica: Publish Cursor documentation reconciled with OpenSite source 77c3fee; tests not rerun

2026-10-29T20:07:54Z

Publish Cursor documentation reconciled with OpenSite source 77c3fee; tests not rerun

New page

{{BathAfrica Feature
|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.
|id=python.workbench
|summary=Edit, run, and debug Python in the desktop workbench, and publish Matplotlib figures to a host viewer.
|status=Implemented in the reviewed development source. Historical test evidence is recorded by the repository; no test rerun or product release is claimed by this publication.
|units=Script buffers are not engineering documents. A quantity edited through an existing document command keeps its canonical SI value.
|behavior=The workbench id is <code>opensite.workbench.python</code>; its GUI extension is <code>opensite.extension.python-workbench</code>. It shares the console interpreter and execution lane. New, Open, Save, Save As and Close operate on script tabs. Run supports a file, selection or current line. Rerun retains interpreter/application state. Unsaved execution does not save the buffer. Current-file assistance is separate from runtime console completion. Debug supports Python-line stepping and cooperative stop. <code>opensite.plot.show()</code> publishes open figures; <code>show(figure)</code> and <code>publish(figure)</code> use the Agg-backed plot viewer. Script stdout/stderr is assembled in the host Output panel; the interactive Console remains separate.
|errors=A second run while the lane is queued, running, paused, or stopping is rejected. A closed or replaced document read returns <code>stale_document</code>. A document read from the Python lane during an application-thread callback returns <code>reentrant_call</code>. An expression watch is rejected. A plot outside the size or memory limits is rejected and reported. Stop raises <code>KeyboardInterrupt</code> at the next Python check.
|limitations=Assistance is the current file. It does not infer types across files. The debugger steps Python lines. Native code stays running until it returns to Python. Stop is cooperative. Zoom and pan navigate the published raster and do not redraw Matplotlib axes. The embedded interpreter and Agg are not a sandbox. The distributable GUI SDK is not installed.
|hosts=The Windows desktop when GUI and Python are both enabled. The headless SDK does not load this extension.
|licensing=No new third-party editor, language server, or debugger package. Matplotlib remains the scientific-bundle component. In-process Python is trusted code.
|verification=Repository evidence references (not rerun for this publication): <code>docs/verification/Phase-11-Python-Workbench.md</code>. ADR-0042.
}}

== Documentation basis ==
Source-reviewed against development commit <code>77c3fee13944bcc4b5d487c77eb1f82fbe4c6ea7</code>, branch <code>feature/phase-13c-properties-python-expressions</code>. This review inspected the implementation and repository evidence; it did not run the Windows application or repeat CTest.

* <code>src/extensions/python_workbench/python_workbench_extension.cpp</code>
* <code>docs/verification/Phase-13C-Integration.md</code>

[[OpenSite|OpenSite overview]] · [[OpenSite/Reference|Reference]] · [[OpenSite/Guides|Guides]]
[[Category:OpenSite documentation]]