OpenSite/Reference/Features/Python scripting - Revision history

BathAfrica: Link adjacent OpenSite reference pages in reading order

2026-10-29T21:15:47Z

Link adjacent OpenSite reference pages in reading order

← Older revision		Revision as of 14:15, 29 October 2026
Line 28:		Line 28:
	[[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/Python workbench\|OpenSite/Reference/Features/Quantities and expressions\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Publish organized OpenSite guides and reference navigation

2026-10-29T21:00:08Z

Publish organized OpenSite guides and reference navigation

← Older revision		Revision as of 14:00, 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.scripting		\|id=python.scripting
	\|summary=Use the embedded Python interpreter to call OpenSite quantities, settings, commands and documents.		\|summary=Use the embedded Python interpreter to call OpenSite quantities, settings, commands and documents.
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 24:		Line 27:
	[[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:45Z

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:08:01Z

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.scripting
|summary=Use the embedded Python interpreter to call OpenSite quantities, settings, commands and documents.
|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=Quantity math and formatting call the C++ engine. A profile change does not change the canonical SI value.
|behavior=<code>PythonHost</code> owns one interpreter, one application, and the unavailable account portal. An expression displays its value. A script sets <code>__file__</code> and <code>argv</code> and does not add its directory to the search path. Each call restores the previous stdout and stderr. <code>opensite.execute</code> runs the command registry. A closed document raises <code>stale_document</code>. Production execution does not install the development policy.
|errors=<code>opensite.Error</code> carries the <code>ErrorCode</code> name, message, and context. A Python exception keeps earlier stdout and stderr with the traceback. A failed initialize is inactive. <code>cancel</code> requests <code>KeyboardInterrupt</code> and does not abort native code.
|limitations=Python and native providers are trusted code, not a sandbox. Cancellation is cooperative and does not forcibly stop native code. Production authorization is distinct from the explicit development host. Debug and Release Python binaries use different ABIs. Scientific packages belong to the matching internal scientific prefix, not the older base bundle. No public production shipment or Linux/macOS runtime validation is claimed here.
|hosts=Windows headless <code>opensite-python</code> and <code>OpenSiteConsole.exe</code>, plus the desktop dockable console and Python workbench when GUI and Python are enabled. They share the interpreter/execution lane; they do not create independent runtimes.
|licensing=The production module does not install the development allow-all policy. CPython and pybind11 licenses are recorded with bundle 0.1.0. The scientific notice pack is <code>prefix/notices</code>. The review is <code>docs/verification/Phase-7B-Redistribution-Review.md</code>. The owner approved the FreeType License and the identified GCC runtime and winpthreads notices. That approval is not independent legal advice. A permissive package license does not clear a static codec, font, or GCC runtime object.
|verification=Repository evidence references (not rerun for this publication): CTest <code>python.production</code>, <code>python.development</code>, <code>python.installed</code>, <code>python.init_empty</code>, <code>python.init_missing</code>, and <code>python.relocated</code> on Windows Debug and Release. ADR-0026. <code>docs/verification/Phase-6-Acceptance.md</code>. On 2026-10-11 the complete Visual Studio 2026 suites passed 30 of 30 in Debug and 30 of 30 in Release after the scientific runtime was staged. Linux and macOS were not built.
}}

== 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/python/bindings.cpp</code>
* <code>src/gui/python_console_service.cpp</code>
* <code>docs/verification/Phase-8-Runtime-Acceptance.md</code>

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