BathAfrica: Add rewritten practical lesson with steps, code and expected results

2026-10-29T21:01:18Z

Add rewritten practical lesson with steps, code and expected results

New page

__NOTOC__
{{OpenSite scope}}
{{OpenSite lesson
|id=opensite.help.save-and-reload-settings
|summary=Save selected user-setting state to a fresh file and reload it.
|prerequisites=Embedded OpenSite Python and a writable practice directory. The script restores the original language setting on completion.
|steps==== Read the starting value ===
Store the original language tag before making the lesson change.

=== Save a new settings file ===
Set the tag to French and save to a fresh temporary folder. The format is <code>opensite-settings</code>, not a document model.

=== Change and reload ===
Change to English, reload the saved file and confirm that the stored tag returns to <code>fr</code>.

=== Restore the session ===
The finally block restores the original tag. A language tag selects available catalog text; it does not download translations.

|result=The reloaded value is fr; the original setting is restored afterwards.
|limitations=Do not put credentials in settings. File success does not make an arbitrary exported value secret-safe. Settings-file persistence and engineering-document persistence are distinct.
}}

== Complete example ==
{{Code|lang=python|code=<nowiki>from pathlib import Path
from tempfile import mkdtemp
import opensite

original = opensite.execute("settings.get", {"key": "locale.language"})["value"]
path = Path(mkdtemp(prefix="opensite-settings-")) / "preferences.json"
try:
opensite.execute("settings.set", {"key": "locale.language", "value": "fr"})
opensite.settings_save(str(path))
opensite.execute("settings.set", {"key": "locale.language", "value": "en"})
opensite.settings_load(str(path))
restored = opensite.execute("settings.get", {"key": "locale.language"})["value"]
assert restored == "fr"
print("Stored language:", restored)
finally:
opensite.execute("settings.set", {"key": "locale.language", "value": original})
# Selecting a language does not install a missing translation catalog.</nowiki>}}

<div class="os-page-nav">{{Docnav|OpenSite/Guides/Set preferences|OpenSite/Guides/Troubleshoot a workflow|OpenSite/Guides|All guides}}</div>
[[Category:OpenSite documentation]]

OpenSite/Guides/Save and reload settings - Revision history

BathAfrica: Add rewritten practical lesson with steps, code and expected results