spacr.qt.terms_i18n

Translated presentations of the End User Licence Agreement.

The agreement is not in the caption catalogs: it is 7,621 characters. Nine locales of it would be roughly double the entire existing runtime catalog, and it would flow into every ratchet, count and coverage figure the translation tooling tracks – so those numbers would stop describing the user interface and start being mostly licence text.

A presentation registered here is a convenience presentation of the English agreement. Section 11.4 of the agreement says so in its own words: if a translation differs from the English in any respect, the English governs. Nothing here is a separate agreement and nothing here is what a profile accepts – terms.record_agreement stores TERMS_VERSION, which is the English document’s version, whichever language was on screen.

Review status is recorded per locale, through the review argument of register(), rather than asserted collectively, and register() refuses an empty one. A locale nobody read must not be recorded as reviewed. No locale presentation is registered in this package at present, so every language shows the English agreement.

Functions

available(→ Tuple[str, ...])	Language codes that have a translated presentation.
paragraphs(code)	The agreement in code, or None to use the English.
register(→ None)	Record one locale's presentation of the agreement.
review_note(→ str)	Who reviewed code's presentation, or "" if it has none.

Package Contents

spacr.qt.terms_i18n.available() → Tuple[str, ...]

Language codes that have a translated presentation.

spacr.qt.terms_i18n.paragraphs(code: str)

The agreement in code, or None to use the English.

Parameters:

code – language code, as spacr.qt.i18n spells it; a code with no registered translation gives None.

spacr.qt.terms_i18n.register(code: str, paragraphs: Tuple[str, ...], review: str) → None

Record one locale’s presentation of the agreement.

Parameters:

• code – language code, as spacr.qt.i18n spells it.

• paragraphs – the agreement’s clauses, in the English order.

• review – who reviewed it and when, or an explicit statement that it is a machine draft. Never left empty.

spacr.qt.terms_i18n.review_note(code: str) → str

Who reviewed code’s presentation, or "" if it has none.

Parameters:

code – language code, as spacr.qt.i18n spells it.