Launchpad Translations API

Development of a Launchpad Translations API.

This Launchpad enhancement proposal discusses extending the functionality of Launchpad Translations by allowing read and write access to translations-related data from Launchpad through launchpadlib.

On Launchpad: https://blueprints.launchpad.net/rosetta/+spec/api

As the $PERSON
I want $FEATURE
so that $BENEFIT

Consider clarifying the feature by describing what it is not?

Rationale

Why are we doing this now?

What value does this give our users? Which users?

Stakeholders

• Ubuntu Translations Community: David Planella, Adi Roiban

• Ubuntu Desktop Team: Arne Goetje

• Canonical OEM team: Kyle Nitzsche

Constraints

The new behaviour must provide a way to access translations data from Launchpad, either in read (or depending on the value) or write mode through launchpadlib, without the need for an admin to query the database.

It must not provide a way to circumvent any security privileges built in the layers above (e.g. Launchpad UI)

Subfeatures

The API can be initially subdivided in several areas, which will be exposed separately below.

Reporting

Languages

Retrieve the list of all languages available in Launchpad.

DATA:

• Language code
• Language name in English
• Language state (visible or not)
• Plural forms (optional, for checking language support)
• Text direction (optional)

It would be nice to some other data presented on language page https://translations.launchpad.net/+languages/ro , but this is a good start

It would be nice to be able to query just a specific language.

PO Templates

Retrieve the list of all templates available for a series in Launchpad.

DATA:

• template name in Launchpad
• priority
• length
• date last updated
• domain name
• iscurrent (active or not)
• source package
• is in lang pack
• the list of POFiles associated with this POTemplate
• in how many languages it is translates (nice to have)

It would be nice to be able to query a template from a series, based on the Launchpad template name.

PO Files

Retrieve the list of all PO files for a template in a series.

The list should contain:

• language code
• when the translation was last updated
• number of translated messages
• number of unreviewed messages
• number of changed messages
• who was the last translator

Import queue

Translation

Workflows

What are the workflows for this feature? Provide mockups for each workflow.

You do not have to get the mockups and workflows right at this point. In fact, it is better to have several alternatives, delaying deciding on the final set of workflows until the last responsible moment.

Success

How will we know when we are done?

How will we measure how well we have done?

Thoughts?

Previous discussion on the API development Proposed API calls