OpenSite/Guides/Use Python Console - Revision history

BathAfrica: 1 revision imported: Deep platform overview and material action/field references; centred diagram and screenshot placeholders.

2026-10-30T07:33:22Z

1 revision imported: Deep platform overview and material action/field references; centred diagram and screenshot placeholders.

← Older revision	Revision as of 00:33, 30 October 2026
(No difference)

BathAfrica: Deep overview, material field/action reference and centred source-based diagrams/screenshot slots

2026-10-30T07:26:27Z

Deep overview, material field/action reference and centred source-based diagrams/screenshot slots

← Older revision		Revision as of 00:26, 30 October 2026
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{OpenSite scope}}		{{OpenSite scope}}
			{{OpenSite image\|file=OpenSite_Python_Console.png\|caption=Prompt-aware Console: editable input, transcript, completion and execution status.}}

	{{OpenSite lesson		{{OpenSite lesson
	\|id=opensite.help.use-python-console		\|id=opensite.help.use-python-console
Line 35:		Line 37:
	<div class="os-page-nav">{{Docnav\|OpenSite/Python\|OpenSite/Guides/Edit Python scripts\|OpenSite/User manual\|User manual}}</div>		<div class="os-page-nav">{{Docnav\|OpenSite/Python\|OpenSite/Guides/Edit Python scripts\|OpenSite/User manual\|User manual}}</div>
	[[Category:OpenSite documentation]]		[[Category:OpenSite documentation]]

BathAfrica: Add source-reviewed, step-by-step OpenSite user workflow

2026-10-29T22:08:30Z

Add source-reviewed, step-by-step OpenSite user workflow

New page

__NOTOC__
{{OpenSite scope}}
{{OpenSite lesson
|id=opensite.help.use-python-console
|summary=Try small calculations in the interactive prompt, then move repeatable work into a script.
|prerequisites=A desktop with its Python console extension and matching runtime. Use only trusted Python.
|steps=
=== Show the console ===
Open the Python console from the View → Python area. Read the banner and Ready/Busy/Error status. If the build reports Python unavailable, use [[OpenSite/Guides/Troubleshoot startup]].

=== Run a simple expression ===
At the current prompt enter <code>2 + 3</code> and press Enter. A completed expression should report <code>5</code>. Earlier prompts/output remain a transcript rather than an editable script.

=== Enter multiline input ===
Shift+Enter inserts a line; Ctrl+Enter submits the current input buffer. Keep indentation correct for Python blocks. History is limited and in memory; it is not a durable script library.

=== Try an OpenSite quantity ===
{{Code|lang=python|code=<nowiki>import opensite
length = opensite.Q("250 mm")
print(length.value_in("m"))
# Expected: 0.25</nowiki>}}

=== Read errors and stop appropriately ===
Read the traceback and the final error, not only the first output line. The console, editor, debugger and Python expressions share one lane. Wait for a running operation or request interruption; native extension work can take time to return.

=== Save repeatable work elsewhere ===
Copy a useful sequence into a saved UTF-8 <code>.py</code> editor file. See [[OpenSite/Guides/Edit Python scripts]]. Console history/transcript and <code>.osdoc</code> saving are separate.
|result=You can run a small expression, recognize its output and retain repeatable work as a script.
|limitations=Clearing the console is not an interpreter reset. The interpreter keeps imports, variables and application state for the session.
}}

== Continue learning ==
[[OpenSite/User manual|User manual]] · [[OpenSite/Tutorials|Tutorial pathways]] · [[OpenSite/Support|Get help]]

<div class="os-page-nav">{{Docnav|OpenSite/Python|OpenSite/Guides/Edit Python scripts|OpenSite/User manual|User manual}}</div>
[[Category:OpenSite documentation]]