Module:Auphen/sandbox/frame/doc

This is the documentation for Module:Auphen/sandbox/frame, a working copy of Module:Auphen/frame, the template-facing wrapper around the Auphen sound engine. It is a test rig rather than production code: no article, entry or template should depend on it, and its output is not evidence of what the live engine does.

It differs from the live frame in two places only — its header comment, and the require, which names Module:Auphen/sandbox in place of Module:Auphen. A candidate engine placed in the sandbox can therefore be driven through the same wrapper as the live one and the two compared side by side before the candidate is promoted. The per-language data pages it reads are the live ones at Module:Auphen/<code>; there are no sandbox copies of those. When the live frame changes, this copy has to be brought back into step with it by hand.

Template:Auphen invokes the live frame, so {{auphen}} never reaches this module. It is called directly, and exports nothing beyond the two entry points below:

{{#invoke:Auphen/sandbox/frame|auphen|word|code|ruleset}}

{{#invoke:Auphen/sandbox/frame|raw|word|code|ruleset}}

auphen formats the result: an estimated pronunciation is wrapped in slashes and marked up as IPA, while a named ruleset returns plain text. raw returns the engine's output unformatted, which is what a comparison table wants.

Parameters

Parameter	Purpose
1	The word, in the language's orthography. Required. It is passed to the engine unaltered; a ~ is a word boundary handled there rather than here, each part being run as its own word.
2	The language registry code, such as YAQ-HE or YBS-PJ. Required. It is upper-cased before the matching Module:Auphen/<code> data page is loaded.
3	The name of a ruleset from that data page's sets table. Left empty, the module runs the page's pronounce ruleset instead and marks the result as an estimate.

All three are trimmed of surrounding whitespace. For an estimate the engine is built from the data page's ipacats (falling back to cats) together with its ipa_rules; for a named ruleset it is built from cats (falling back to ipacats) and no spelling rules are applied.

A missing word, a missing code, a code with no data page, or a ruleset name absent from sets yields an error rather than a script failure. auphen shows the message as an error span prefixed Auphen: and files the calling page into Category:Auphen errors — the live maintenance category, which a failing sandbox call will populate like any other; raw returns the message prefixed ERROR:.

Data pages are loaded with require rather than mw.loadData, because the read-only proxy mw.loadData returns does not enumerate nested tables under pairs(), which would hide the category members; the frame then copies the category tables into plain Lua tables before handing them to the engine. Template:Auphen/testcases holds the acceptance tests against the live frame, and the same rows can be pointed at this module to measure a candidate against them. The engine's design notes and behaviour log are on Module talk:Auphen.