Tests for translations

[patrickjahns]

It would be great to have acceptance tests for apps that show/display strings for translations.

Trying to catch when translations are not / no-longer working like in owncloud/files_antivirus#291

[phil-davis]

Note: core has a test that switches language to Russian and checks.

It will be "easy enough" to do similar checks in apps, at least of a few sample strings which demonstrate that the translation infrastructure is working. But to cover every place that has a string to be translated is not "easy" and not maintainable - translators can update the translation at any moment.

[phil-davis]

Is the text of API responses translated?
(probably the text of "success" will be "OK" and not get translated! But the text of failures like "group already exists" or... might be translated).

We could change the system language to Deutsch and check some API responses to see that they are translated. The current translation of those is unlikely to change, so the tests will not get broken.

[DeepDiver1975]

All Web Apis respect the accept-language Header. The given language Code ist used for strings which are returned

[DeepDiver1975]

https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language

[jasson99]

I changed the system language to 'default_language' => 'de' . Then I created a new user namely deutschUser and added it to the admin group. When the deutschUser now logs in, the language in the web UI is Deutsch. But, when the deutschUser makes an API request to create an already existing user, the message is still "User already exists".

[phil-davis]

@jasson99 try sending the Accept-Language header with the curl command. Set it to * (all languages) and that might make the API choose the system language, rather than English. Then also try sending a specific language code.

See the link in comment #608 (comment)

[phil-davis]

@DeepDiver1975 or anyone. Are occ commands supposed to have any translation capability?
e.g. translate to the system language, for input prompts and/or output success/error messages?

[DeepDiver1975]

@DeepDiver1975 or anyone. Are occ commands supposed to have any translation capability?

no - plain english

[phil-davis]

Hmmm - exceptions out of DAV do not seem to be translated, e.g. https://github.com/owncloud/core/blob/master/apps/dav/lib/Connector/Sabre/Directory.php#L262

throw new SabreNotFound('File with name ' . $path . ' could not be located');

curl http://172.17.0.1:8080/remote.php/webdav/notAvailable.txt -u deutchUser:deutchUser -X GET -H "Accept-Language:*" -H "Content-Type: text/plain"
<?xml version="1.0" encoding="utf-8"?>
<d:error xmlns:d="DAV:" xmlns:s="http://sabredav.org/ns">
  <s:exception>Sabre\DAV\Exception\NotFound</s:exception>
  <s:message>File with name notAvailable.txt could not be located</s:message>
</d:error>

I wonder how we find an example WebDAV call that will provide an "interesting" response that gets translated.

[DeepDiver1975]

It is highly possible that not all messages are translated 🤷‍♂️

Let me try to find a working example ...

[DeepDiver1975]

$ curl -H 'Accept-Language: de' -uadmin "http://localhost:8080/ocs/v2.php/apps/files_sharing/api/v1/shares/1"
Enter host password for user 'admin':
<?xml version="1.0"?>
<ocs>
 <meta>
  <status>failure</status>
  <statuscode>404</statuscode>
  <message>Fehlerhafte Freigabe-ID, Freigabe existiert nicht</message>
  <totalitems></totalitems>
  <itemsperpage></itemsperpage>
 </meta>
 <data/>
</ocs>