@esgettext/tools 1.1.0 → 1.3.0

package/LICENSE

@@ -1,4 +1,4 @@
-This software is Copyright (C) 2020 by Guido Flohr.
+This software is Copyright (C) 2020-2024 by Guido Flohr.
 
 This is free software, licensed under:
 

package/README.md

@@ -294,7 +294,7 @@ for example `['verbose']` or `['v']`, and not `['--verbose']` or `['-v']`.
 
 ## Copyright
 
-Copyright (C) 2020 Guido Flohr <guido.flohr@cantanea.com>, all
+Copyright (C) 2020-2024 Guido Flohr <guido.flohr@cantanea.com>, all
 rights reserved.
 
 This software is available under the terms and conditions of the

package/dist/command.js

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=command.js.map

package/dist/commands/add-language.js

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddLanguage = void 0;
+const path = __importStar(require("path"));
+const runtime_1 = require("@esgettext/runtime");
+const gtx = runtime_1.Textdomain.getInstance('com.cantanea.esgettext-tools');
+class AddLanguage {
+    constructor(configuration) {
+        this.options = undefined;
+        this.configuration = configuration;
+    }
+    synopsis() {
+        return '';
+    }
+    description() {
+        return gtx._('Describe process for adding languages.');
+    }
+    aliases() {
+        return [];
+    }
+    args() {
+        var _a, _b;
+        return {
+            textdomain: {
+                alias: 't',
+                type: 'string',
+                describe: gtx._('The textdomain of your package'),
+                demandOption: true,
+                default: (_a = this.configuration.package) === null || _a === void 0 ? void 0 : _a.textdomain,
+            },
+            'po-directory': {
+                type: 'string',
+                describe: gtx._('Directory where your po files are located'),
+                demandOption: true,
+                default: (_b = this.configuration.po) === null || _b === void 0 ? void 0 : _b.directory,
+            },
+        };
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    additional(_) { }
+    init(argv) {
+        const options = argv;
+        this.options = options;
+    }
+    run(argv) {
+        return new Promise(resolve => {
+            var _a;
+            this.init(argv);
+            const potFile = `${this.options.poDirectory}/${this.options.textdomain}.pot`.replace(/\//g, path.sep);
+            console.log(gtx._('Please execute this command:\n'));
+            // TRANSLATORS: Please replace 'll' with a two-letter abbreviation
+            // for the word 'language' and 'CC' with a two-letter abbreviation
+            // for the workd 'country'.
+            const llCC = gtx._('ll_CC');
+            console.log(`\tmsginit --input=${potFile} --locale=${llCC}\n`);
+            console.log(gtx._x("Replace '{placeholder}' with the two-letter" +
+                ' language code of the language, optionally' +
+                ' followed by an underscore and the two-letter' +
+                ' country code.', { placeholder: llCC }));
+            console.log(gtx._('If you prefer to separate language and country' +
+                ' by a hyphen, rename the file later.'));
+            console.log(gtx._x('When you are done, update the list of locales' +
+                " in the configuration file '{filename}'. The" +
+                " variable name is '{varname}'.", {
+                filename: (_a = this.configuration.files) === null || _a === void 0 ? void 0 : _a[0],
+                varname: 'po.locales',
+            }));
+            const redOn = '\x1b[31m';
+            const redOff = '\x1b[0m';
+            console.log(redOn, gtx._('Warning! The command will open an' +
+                ' internet connection to download the plural' +
+                ' function and some other data for that language!'), redOff);
+            resolve(0);
+        });
+    }
+}
+exports.AddLanguage = AddLanguage;

package/dist/commands/convert.js

@@ -29,8 +29,9 @@ const runtime_1 = require("@esgettext/runtime");
 const package_1 = require("../package");
 const gtx = runtime_1.Textdomain.getInstance('com.cantanea.esgettext-tools');
 class Convert {
-    constructor(configuration) {
-        this.configuration = configuration;
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    constructor(_) {
+        this.options = undefined;
     }
     synopsis() {
         return `[${gtx._('INPUTFILE')}] [${gtx._('OUTPUTFILE')}]`;
@@ -58,7 +59,7 @@ class Convert {
             'input-format': {
                 alias: 'I',
                 type: 'string',
-                describe: gtx._('Input file format (defaul: derived from filename)'),
+                describe: gtx._('Input file format (default: derived from filename)'),
                 choices: ['mo.json', 'mo', 'gmo', 'json'],
                 coerce: arg => arg.toLowerCase(),
                 group: gtx._('File formats:'),
@@ -195,6 +196,7 @@ class Convert {
             if (typeof filename !== 'undefined') {
                 return fs.readFileSync(filename);
             }
+            // Must read from standard input.
             const stdinFd = 0;
             const chunks = [];
             let bytesRead;
@@ -238,16 +240,16 @@ class Convert {
     }
     shortenAndEscapeString(input, maxLength) {
         const controlCharMap = {
-            '\0': '\\0',
-            '\b': '\\b',
-            '\t': '\\t',
-            '\n': '\\n',
-            '\v': '\\v',
-            '\f': '\\f',
-            '\r': '\\r',
-            '"': '\\"',
-            "'": "\\'",
-            '\\': '\\\\',
+            '\0': '\\0', // Null character
+            '\b': '\\b', // Backspace
+            '\t': '\\t', // Horizontal Tab
+            '\n': '\\n', // New Line
+            '\v': '\\v', // Vertical Tab
+            '\f': '\\f', // Form Feed
+            '\r': '\\r', // Carriage Return
+            '"': '\\"', // Double quote
+            "'": "\\'", // Single quote
+            '\\': '\\\\', // Backslash
         };
         const escapeControlChar = (char) => {
             if (controlCharMap[char]) {
@@ -257,8 +259,9 @@ class Convert {
             if (code < 32) {
                 return `\\x${code.toString(16).padStart(2, '0')}`;
             }
-            return char;
+            return char; // This line is technically redundant with the current regex.
         };
+        // Escape all control characters
         const escapedInput = input.replace(/[\x00-\x1F"'\\]/g, escapeControlChar);
         let truncatedString = escapedInput;
         if (escapedInput.length > maxLength) {
@@ -281,4 +284,3 @@ class Convert {
     }
 }
 exports.Convert = Convert;
-//# sourceMappingURL=convert.js.map