Make language slug available via session metadata

[minhaminha]

Product Description

Users will now be able to reference the current language slug (i.e. 'en', 'es', etc.) on the screen by referencing instance('commcaresession')/session/context/applanguage

Technical Summary

Jira Ticket

Associated commcare-core PR

This is the formplayer side of the changes. All this code does is ensures that EntityScreenContext has the right locale (a string) value provided on initialization and a null value for any instance that's not directly related to the workflow kicked off by a navigateSessionWithAuth request. Because this process continually recreates the context object, its the ideal entry point to insert this value which will be propagated to the eventual generateRoot function (actual code surrounding this part and further explanation will be in the commcare-core PR).

To be complete this PR also covers an instance of ExternalDataInstance initialization that will now optionally accept a locale argument.

Safety Assurance

Safety story

This shouldn't impact existing data since the EntityScreenContext object is constantly being recreated with updated information and most of the time the locale value will be null.

QA Plan

No plans for QA but will have delivery (who request this feature) do some testing to ensure it's doing what they want.

Special deploy instructions

• This PR can be deployed after merge with no further considerations. (Of course the commcare-core PR will be merged first and this PR updated with those changes before merging/deploying).

Rollback instructions

• This PR can be reverted after deploy with no further considerations. (Ideally should be rolled back with attached commcare-core PR?)

Review

• The set of people pinged as reviewers is appropriate for the level of risk of the change.

[codecov]

Codecov Report

Attention: Patch coverage is 87.50000% with 1 line in your changes missing coverage. Please review.

Project coverage is 70.22%. Comparing base (c069207) to head (3bd8611).

Files with missing lines	Patch %	Lines
...mplayer/session/FormplayerInstanceInitializer.java	85.71%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##             master    #1630      +/-   ##
============================================
+ Coverage     70.16%   70.22%   +0.05%     
- Complexity     1999     2003       +4     
============================================
  Files           254      254              
  Lines          7881     7903      +22     
  Branches        741      743       +2     
============================================
+ Hits           5530     5550      +20     
- Misses         2069     2070       +1     
- Partials        282      283       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[Robert-Costello]

this grabs the last locale created? is that always right one?

[minhaminha]

thanks so much for pointing this out, totally forgot to go back to this. The locales list is always as follows: ['default' (like literally just a string called default), , <all other slugs in order the were added]. The locales.length-1 was previously a placeholder and wouldn't have worked if there were more than one languages. Added a similar comment in the code too to avoid confusion.