Added --only-stable option

Author: adamlui

translate-messages/.translate-msgs.config.json5

@@ -4,6 +4,7 @@
   "keys": "",                // keys to translate (e.g. "app_DESC,err_NOT_FOUND") (default: all missing src keys)
   "exclude_langs": "",       // languages to exclude (e.g. "en,es")
   "exclude_keys": "",        // keys to ignore (e.g. "app_NAME,author")
+  "only_stable": false,      // only use stable locales (skip auto-discovery)
   "force": false,            // force overwrite existing config file when using init
   "no_wizard": false         // skip interactive prompts during start-up
 }

translate-messages/docs/README.md

@@ -42,33 +42,34 @@ Options can be set by using command-line arguments:
 | Option                 | Description                                                                                               | Example
 | ---------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------
 | `-d`, `--locales-dir`  | Name of the folder containing locale files (default: `_locales`)                                          | `--locales-dir=_messages`
-| `-t`, `--target-langs` | Comma-separated list of languages to translate to (default: all [`supported_locales`][supported-locales]) | `--target-langs=en,es,fr`
+| `-t`, `--target-langs` | Comma-separated list of languages to translate to (default: all [`stable_locales`][stable-locales])       | `--target-langs=es,fr`
 | `-k`, `--keys`         | Comma-separated list of keys to translate (default: all found src keys missing in target files)           | `--keys=app_DESC,err_NOT_FOUND`
-| `--exclude-langs`      | Comma-separated list of languages to exclude                                                              | `--exclude-langs=en,es`
+| `--exclude-langs`      | Comma-separated list of languages to exclude                                                              | `--exclude-langs=es,zh`
 | `--exclude-keys`       | Comma-separated list of keys to ignore                                                                    | `--exclude-keys=app_NAME,author`
+| `--only-stable`        | Only use stable locales (skip auto-discovery)                                                             |
 | `init`, `-i`, `--init` | Create `.translate-msgs.config.json5` in project root to store default options                            |
 | `-f`, `--force`        | Force overwrite of existing config file when using `init`                                                 |
 | `-n`, `--no-wizard`    | Skip interactive prompts during start-up                                                                  |
 | `-h`, `--help`         | Show help screen                                                                                          |
 
 ## Examples
 
-Translate all keys except `app_NAME` from `_locales/en/messages.json` to all [`supported_locales`][supported-locales]:
+Translate all keys except `app_NAME` from `_locales/en/messages.json` to all [`stable_locales`][stable-locales]:
 
 ```bash
-translate-messages --ignore-keys=app_NAME # prompts for more keys to ignore
+translate-messages --ignore-keys=app_NAME  # prompts for more keys to ignore
 ```
 
 Translate `app_DESC` key from `messges/en/messages.json` to French:
 
 ```bash
-translate-messages --keys=app_DESC --locales-dir=messages --target-langs=fr -n # no prompts
+translate-messages --keys=app_DESC --locales-dir=messages --target-langs=fr -n  # no prompts
 ```
 
 Translate `app_DESC` + `err_NOT_FOUND` keys from `_msgs/en/messages.json` to Spanish and Hindi:
 
 ```bash
-translate-msgs -k app_DESC,err_NOT_FOUND -d _msgs -t es,hi -n # no prompts
+translate-msgs -k app_DESC,err_NOT_FOUND -d _msgs -t es,hi -n  # no prompts
 ```
 
 ## Config file
@@ -105,4 +106,4 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 <a href="#top">Back to top ↑</a>
 
-[supported-locales]: https://github.com/adamlui/python-utils/blob/translate-messages-1.2.2/translate-messages/src/translate_messages/package_data.json#L21-L26
+[stable-locales]: https://github.com/adamlui/python-utils/blob/translate-messages-1.2.2/translate-messages/src/translate_messages/package_data.json#L22-L27

translate-messages/src/translate_messages/assets/data/package_data.json

@@ -18,7 +18,7 @@
     "pypistats": "https://pypistats.org/packages/translate-messages",
     "support": "https://github.com/adamlui/python-utils/issues"
   },
-  "supported_locales": [
+  "stable_locales": [
     "af", "am", "ar", "az", "be", "bem", "bg", "bn", "bo", "bs", "ca", "ceb", "cs", "cy", "da", "de", "dv", "dz", "el",
     "en", "en-GB", "eo", "es", "et", "eu", "fa", "fi", "fo", "fr", "gd", "gl", "gu", "haw", "he", "hi", "hr", "ht",
     "hu", "hy", "id", "is", "it", "ja", "ka", "kab", "kk", "km", "kn", "ko", "ku", "ky", "la", "lb", "lo", "lt", "lv",

translate-messages/src/translate_messages/lib/init.py

@@ -48,9 +48,10 @@ def src_msgs(cli):
 
 def target_langs(cli):
     cli.config.target_langs = list(set(cli.config.target_langs)) # remove dupes
-    if not cli.config.target_langs:
-        cli.config.target_langs = cli.supported_locales
-        for lang_path in cli.locales_path.rglob(f'*/{cli.msgs_filename}'): # merge discovered locales
+    if not cli.config.target_langs: # init to stable ones
+        cli.config.target_langs = cli.stable_locales
+    if not cli.config.only_stable: # merge discovered locales
+        for lang_path in cli.locales_path.rglob(f'*/{cli.msgs_filename}'):
             discovered_lang = lang_path.parent.name.replace('_', '-')
             if discovered_lang not in cli.config.target_langs:
                 cli.config.target_langs.append(discovered_lang)

translate-messages/src/translate_messages/lib/settings.py

@@ -11,20 +11,24 @@
     ),
     target_langs=sn(
         args=['-t', '--target-langs', '--include-langs'],
-        type=str, parser='csv', help='Languages to translate to (e.g. "en,es,fr") (default: all 100+ supported locales)'
+        type=str, parser='csv', help='Languages to translate to (e.g. "es,fr") (default: all 100+ supported locales)'
     ),
     keys=sn(
         args=['-k', '--keys', '--include-keys', '--translate-keys'],
         type=str, parser='csv', help='Keys to translate (e.g. "app_DESC,err_NOT_FOUND") (default: all found src keys missing in target files)'
     ),
     exclude_langs=sn(
         args=['--exclude-langs', '--ignore-langs'],
-        type=str, parser='csv', help='Languages to exclude (e.g. "en,es")'
+        type=str, parser='csv', help='Languages to exclude (e.g. "es,zh")'
     ),
     exclude_keys=sn(
         args=['--exclude-keys', '--ignore-keys'],
         type=str, parser='csv', help='Keys to ignore (e.g. "app_NAME,author")'
     ),
+    only_stable=sn(
+        args=['-s', '--only-stable', '--no-discovery'],
+        action='store_true', help='Only use stable locales (skip auto-discovery)'
+    ),
     init=sn(
         args=['-i', '--init'],
         action='store_true', subcmd='true', help='Create .translate-msgs.config.json5 file to store default options'