Repository URL to install this package:
|
Version:
5.0.0-rc.5 ▾
|
<!doctype html>
<html lang="en">
<head>
<title>Code coverage report for src/onesky/translations.js</title>
<meta charset="utf-8" />
<link rel="stylesheet" href="../../prettify.css" />
<link rel="stylesheet" href="../../base.css" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<style type='text/css'>
.coverage-summary .sorter {
background-image: url(../../sort-arrow-sprite.png);
}
</style>
</head>
<body>
<div class='wrapper'>
<div class='pad1'>
<h1>
<a href="../../index.html">All files</a> / <a href="index.html">src/onesky</a> translations.js
</h1>
<div class='clearfix'>
<div class='fl pad1y space-right2'>
<span class="strong">77.42% </span>
<span class="quiet">Statements</span>
<span class='fraction'>48/62</span>
</div>
<div class='fl pad1y space-right2'>
<span class="strong">30.77% </span>
<span class="quiet">Branches</span>
<span class='fraction'>4/13</span>
</div>
<div class='fl pad1y space-right2'>
<span class="strong">70% </span>
<span class="quiet">Functions</span>
<span class='fraction'>14/20</span>
</div>
<div class='fl pad1y space-right2'>
<span class="strong">79.31% </span>
<span class="quiet">Lines</span>
<span class='fraction'>46/58</span>
</div>
</div>
</div>
<div class='status-line medium'></div>
<pre><table class="coverage">
<tr><td class="line-count quiet">1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184</td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">5x</span>
<span class="cline-any cline-yes">5x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">5x</span>
<span class="cline-any cline-yes">5x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">5x</span>
<span class="cline-any cline-yes">5x</span>
<span class="cline-any cline-yes">5x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">2x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">2x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">4x</span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">2x</span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">2x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">4x</span>
<span class="cline-any cline-yes">4x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">2x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-yes">2x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">2x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1x</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span></td><td class="text"><pre class="prettyprint lang-js">const deepmerge = require('deepmerge');
const { extractDefaultMessages } = require('./extract');
const { getProjectMessagesByLanguage, getProjectLanguages, uploadProjectTranslation } = require('./api');
const { flatten, unflatten } = require('./transform');
const { readJsonFile, writeJsonFile } = require('./utils');
const { getAddedKeys, getChangedKeys, getRenamedKeys, getDeletedKeys, updateMessages } = require('./diff');
/**
* Manage translations for OneSky
*
* @module @doodle/i18n/disty/onesky/translations
*/
/**
* Download translations from a OneSky project for all defined languages in the project
*
* @param {string} projectId
* @param {OneSkyCredentials} credentials
* @returns {Promise<object>}
* @async
*/
const getProjectTranslations = async (projectId, credentials) => {
const projectLanguages = await getProjectLanguages(projectId, credentials);
const languageCodes = projectLanguages.map(({ code }) => code);
const projectMessages = await Promise.all(
languageCodes.map(language => getProjectMessagesByLanguage({ projectId, language }, credentials))
);
return projectMessages.reduce((result, messages, index) => {
result[languageCodes[index]] = unflatten(messages);
return result;
}, {});
};
/**
* Download translations from multiple OneSky projects for all defined languages
* in the respective projects and combine the message translations
*
* @param {string[]} projectIds
* @param {OneSkyCredentials} credentials
* @returns {Promise<object>}
* @async
*/
const getMergedProjectTranslations = async (projectIds, credentials) => {
const errors = {};
const projectsTranslations = await Promise.all(
projectIds.map(projectId =>
getProjectTranslations(projectId, credentials).catch(<span class="fstat-no" title="function not covered" >er</span>ror => {
<span class="cstat-no" title="statement not covered" > errors[projectId] = error;</span>
})
)
);
<span class="missing-if-branch" title="if path not taken" >I</span>if (Object.keys(errors).length) {
<span class="cstat-no" title="statement not covered" > throw new Error(JSON.stringify(errors));</span>
}
return deepmerge.all(projectsTranslations);
};
/**
* Download all translations from multiple OneSky projects and write them to JSON files by language
*
* @param {string[]} projectIds
* @param {string} targetPath
* @param {OneSkyCredentials} credentials
* @returns {Promise<object>}
* @async
*/
const downloadMergedTranslationFiles = async (projectIds, targetPath, credentials) => {
const combinedTranslations = await getMergedProjectTranslations(projectIds, credentials);
await Promise.all(
Object.keys(combinedTranslations).map(language =>
writeJsonFile(`${targetPath}/${language}.json`, combinedTranslations[language])
)
);
return combinedTranslations;
};
/**
* Update a translation file containing hierarchical messages with changes from source messages
*
* @param {string} file
* @param {object} sourceMessages
* @param {bool} includeValues
* @returns {Promise}
* @async
*/
const updateTranslationFile = async (file, sourceMessages, includeValues = <span class="branch-0 cbranch-no" title="branch not covered" >false)</span> => {
const translation = await readJsonFile(file);
const messages = flatten(translation);
const addedKeys = includeValues ? getAddedKeys(sourceMessages, messages) : <span class="branch-1 cbranch-no" title="branch not covered" >[];</span>
const changedKeys = includeValues ? getChangedKeys(sourceMessages, messages) : <span class="branch-1 cbranch-no" title="branch not covered" >[];</span>
const renamed = getRenamedKeys(sourceMessages, messages);
const deleted = getDeletedKeys(sourceMessages, messages);
const sourceMessageEntries = Object.entries(sourceMessages);
const updatedMessages = updateMessages(messages, {
added: sourceMessageEntries.filter(([k]) => addedKeys.indexOf(k) >= 0),
changed: sourceMessageEntries.filter(([k]) => changedKeys.indexOf(k) >= 0),
renamed,
deleted,
});
await writeJsonFile(file, unflatten(updatedMessages));
};
/**
* Update local translation files with changes from the source for all languages defined by the OneSky project
*
* @param {string} projectId
* @param {OneSkyCredentials} credentials
* @param {string} sourcePattern
* @param {string} targetPath
* @param {string} includeValues
* @returns {Promise}
* @async
*/
const updateTranslationFiles = <span class="fstat-no" title="function not covered" >as</span>ync (projectId, credentials, sourcePattern, targetPath, includeValues = <span class="branch-0 cbranch-no" title="branch not covered" >false)</span> => {
const projectLanguages = <span class="cstat-no" title="statement not covered" >await getProjectLanguages(projectId, credentials);</span>
const languageCodes = <span class="cstat-no" title="statement not covered" >projectLanguages.map(<span class="fstat-no" title="function not covered" >({</span> code }) => <span class="cstat-no" title="statement not covered" >code)</span>;</span>
const baseLanguage = <span class="cstat-no" title="statement not covered" >projectLanguages.filter(<span class="fstat-no" title="function not covered" >({</span> is_base_language: isBaseLanguage }) => <span class="cstat-no" title="statement not covered" >isBaseLanguage)</span>[0].code;</span>
const sourceMessages = <span class="cstat-no" title="statement not covered" >await extractDefaultMessages(`${sourcePattern}`);</span>
const errors = <span class="cstat-no" title="statement not covered" >{};</span>
<span class="cstat-no" title="statement not covered" > await Promise.all(</span>
languageCodes.map(<span class="fstat-no" title="function not covered" >la</span>nguage =>
<span class="cstat-no" title="statement not covered" > updateTranslationFile(</span>
`${targetPath}/${language}.json`,
sourceMessages,
includeValues ? true : language === baseLanguage
).catch(<span class="fstat-no" title="function not covered" >er</span>ror => {
<span class="cstat-no" title="statement not covered" > errors[language] = error;</span>
})
)
);
<span class="cstat-no" title="statement not covered" > if (Object.keys(errors).length) {</span>
<span class="cstat-no" title="statement not covered" > console.error(errors);</span>
}
};
/**
* Upload translation files for all languages of the project, not only the base language!
*
* @param {string} path path to folder containing the hierarchical `${language}.json` translation files
* @param {OneSkyTranslationOptions} translationOptions
* @param {OneSkyCredentials} credentials
* @param {OneSkySyncOptions} syncOptions
* @returns {Promise}
* @async
*/
const uploadTranslationFiles = async (path, { projectId, fileName }, credentials, { keepStrings, format } = {}) => {
const projectLanguages = await getProjectLanguages(projectId, credentials);
const languageCodes = projectLanguages.map(({ code }) => code);
const doUpload = async language => {
const translations = await readJsonFile(`${path}/${language}.json`);
await uploadProjectTranslation({ language, projectId, fileName }, flatten(translations), credentials, {
keepStrings,
format,
});
};
await Promise.all(languageCodes.map(doUpload));
};
module.exports = {
getProjectTranslations,
getMergedProjectTranslations,
updateTranslationFile,
updateTranslationFiles,
downloadMergedTranslationFiles,
uploadTranslationFiles,
};
</pre></td></tr>
</table></pre>
<div class='push'></div><!-- for sticky footer -->
</div><!-- /wrapper -->
<div class='footer quiet pad2 space-top1 center small'>
Code coverage
generated by <a href="https://istanbul.js.org/" target="_blank">istanbul</a> at Tue Jun 23 2020 12:06:26 GMT+0200 (Central European Summer Time)
</div>
</div>
<script src="../../prettify.js"></script>
<script>
window.onload = function () {
if (typeof prettyPrint === 'function') {
prettyPrint();
}
};
</script>
<script src="../../sorter.js"></script>
</body>
</html>