1
0
mirror of synced 2025-12-20 10:28:40 -05:00
Files
docs/script/reset-translated-file.js
Kevin Heis f6acb1f08a Update dependencies (#19408)
* Update dependencies 2

* Lint fixes

* Update graphql packages

* Update changelog-entry.json

* Update @octokit/rest

* Update commander with help from @rachmari

@rachmari

* Upgrade helmet

* Upgrade js-yaml

* Update server.js

* Update cheerio

* Revert "Update cheerio"

This reverts commit 8aa17c39fbf564ee554037d89e7a473027d16984.
2021-05-19 17:32:47 +00:00

69 lines
2.4 KiB
JavaScript
Executable File

#!/usr/bin/env node
// [start-readme]
//
// This is a convenience script for replacing the contents of translated
// files with the English content from their corresponding source file.
//
// It's intended to be a workaround to temporarily bypass Crowdin parser bugs
// while we wait for translators to fix them.
//
// Usage:
// script/reset-translated-file.js <filename>
//
// Examples:
//
// $ script/reset-translated-file.js translations/es-XL/content/actions/index.md
//
// [end-readme]
const program = require('commander')
const { execSync } = require('child_process')
const assert = require('assert')
const fs = require('fs')
const path = require('path')
const chalk = require('chalk')
program
.description('reset translated files')
.option('-m, --prefer-main', 'Reset file to the translated file, try using the file from `main` branch first, if not found (usually due to renaming), fall back to English source.')
.parse(process.argv)
const resetToEnglishSource = (translationFilePath) => {
assert(translationFilePath.startsWith('translations/'), 'path argument must be in the format `translations/<lang>/path/to/file`')
assert(fs.existsSync(translationFilePath), `file does not exist: ${translationFilePath}`)
const relativePath = translationFilePath.split(path.sep).slice(2).join(path.sep)
const englishFile = path.join(process.cwd(), relativePath)
assert(fs.existsSync(englishFile), `file does not exist: ${englishFile}`)
// replace file with English source
const englishContent = fs.readFileSync(englishFile, 'utf8')
fs.writeFileSync(translationFilePath, englishContent)
console.log('-> reverted to English: %s', path.relative(process.cwd(), translationFilePath))
}
const [pathArg] = program.args
assert(pathArg, 'first arg must be a target filename')
// Is the arg a fully-qualified path?
const relativePath = fs.existsSync(pathArg)
? path.relative(process.cwd(), pathArg)
: pathArg
if (program.opts().preferMain) {
try {
execSync(`git checkout main -- ${relativePath}`, { stdio: 'pipe' })
console.log('-> reverted to file from main branch: %s', relativePath)
} catch (e) {
if (e.message.includes('pathspec')) {
console.warn(chalk.red(`cannot find ${relativePath} in main branch (likely because it was renamed); falling back to English source file.`))
resetToEnglishSource(relativePath)
} else {
console.warn(e.message)
}
}
} else {
resetToEnglishSource(relativePath)
}