Part of lp.translations.interfaces.translationpolicy View In Hierarchy
Known subclasses: lp.registry.interfaces.distribution.IDistributionPublic, lp.registry.interfaces.product.IProductView, lp.registry.interfaces.webservice.IProjectGroup
A translation policy defines who can edit translations, and who can add suggestions. (The ability to edit also implies the ability to enter suggestions). Everyone else is allowed only to view the translations.
The policy can "invite" the user to edit or suggest; or it can merely "allow" them to. Whoever is invited is also allowed, but administrators and certain other special users may be allowed without actually being invited.
The invitation is based purely on the access model configured by the user: translation team and translation policy.
| Method | getTranslationGroups | List all applicable translation groups. |
| Method | getTranslators | Find the applicable `TranslationGroup`(s) and translators. |
| Method | getEffectiveTranslationPermission | Get the effective TranslationPermission. |
| Method | invitesTranslationEdits | Does this policy invite person to edit translations? |
| Method | invitesTranslationSuggestions | Does this policy invite person to enter suggestions? |
| Method | allowsTranslationEdits | Is person allowed to edit translations to language? |
| Method | allowsTranslationSuggestions | Is person allowed to enter suggestions for language? |
| Method | sharesTranslationsWithOtherSide | Should translations be shared across `TranslationSide`s? |
This may be an empty list, or a list containing just this policy's translation group, or for a product that is part of a project group, possibly a list of two translation groups.
If there is an inherited policy, its translation group comes first. Duplicates are removed.
Find the applicable `TranslationGroup`(s) and translators.
Zero, one, or two translation groups may apply. Each may have a
`Translator` for the language, with either a person or a team
assigned.
In the case of a product in a project group, there may be up to
two entries. In that case, the entry from the project group
comes first.
:param language: The language that you want the translators for.
:type language: ILanguage
:param store: Optionally a specific store to retrieve from.
:type store: Store
:return: A result set of zero or more tuples:
(`TranslationGroup`, `Translator`, `Person`). The
translation group is always present and unique. The person
is present if and only if the translator is present. The
translator is unique if present, but the person need not be.
TranslationPermission.
Returns the strictest applicable permission out of
self.translationpermission and any inherited
TranslationPermission.
Does this policy invite `person` to edit translations?
The decision is based on the chosen `TranslationPermission`,
`TranslationGroup`(s), the presence of a translation team, and
`person`s membership of the translation team.
As one extreme, the OPEN model invites editing by anyone. The
opposite extreme is CLOSED, which invites editing only by
members of the applicable translation team.
:param person: The user.
:type person: IPerson
:param language: The language to translate to. This will be
used to look up the applicable translation team(s).
:type language: ILanguage
person to enter suggestions?
Similar to invitesTranslationEdits, but for the activity of
entering suggestions. This carries less risk, so generally a
wider public is invited to do this than to edit.
person allowed to edit translations to language?
Similar to invitesTranslationEdits, except administrators and
in the case of Product translations, owners of the product are
always allowed even if they are not invited.
Is `person` allowed to enter suggestions for `language`? Similar to `invitesTranslationSuggestions, except administrators and in the case of Product translations, owners of the product are always allowed even if they are not invited.
Should translations be shared across `TranslationSide`s?
Should translations to this object, as reviewed by `person`,
into `language` be shared with the other `TranslationSide`?
The answer depends on whether the user is invited to edit the
translations on the other side. Administrators and other
specially privileged users are allowed to do that, but that
does not automatically mean that their translations should be
shared there.
:param person: The `Person` providing translations.
:param language: The `Language` being translated to.
:param sourcepackage: When translating a `Distribution`, the
`SourcePackage` that is being translated.
:param purportedly_upstream: Whether `person` provides the
translations in question as coming from upstream.