Release 2.0.19 (#380)

Author: jacalata

.github/workflows/check-coverage.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ${{ matrix.os }}
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
 
     - name: Set up Python ${{ matrix.python-version }} on ${{ matrix.os }}
       uses: actions/setup-python@v6

.github/workflows/codeql-analysis.yml

@@ -38,7 +38,7 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL

.github/workflows/generate-metadata.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
 
     - name: Set up Python
       uses: actions/setup-python@v6

.github/workflows/package.yml

@@ -60,7 +60,7 @@ jobs:
             UPLOAD_FILE_NAME: tabcmd
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
 
     - uses: actions/setup-python@v6
       with:

.github/workflows/publish-pypi.yml

@@ -15,7 +15,7 @@ jobs:
     name: Build dist files for PyPi
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - uses: actions/setup-python@v6

.github/workflows/run-e2-tests.yml

@@ -23,7 +23,7 @@ jobs:
     runs-on: ${{ matrix.os }}
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
 
     - name: Set up Python ${{ matrix.python-version }} on ${{ matrix.os }}
       uses: actions/setup-python@v6

.github/workflows/run-tests.yml

@@ -20,7 +20,7 @@ jobs:
     runs-on: ${{ matrix.os }}
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
 
     - name: Set up Python ${{ matrix.python-version }} on ${{ matrix.os }}
       uses: actions/setup-python@v6

WorldIndicators.tdsx

@@ -0,0 +1,21 @@
+
+### Strings and localization
+
+New text should not be hardcoded into the python, but added to tabcmd/locales/en/extra.properties. This file can be given to the translation team and they will return a copy for each other language. Until then, the english string will be used as a fallback.
+
+To handle localizing text we used the python standard library tool [gettext](https://docs.python.org/3/library/gettext.html). This expects .mo files. I couldn't find a tool that transformed .properties -> .mo directly so we go through .po format. 
+(FYI: to read mo files for debugging use https://poedit.net/download)
+
+
+These steps are separated for easier troubleshooting: each step is idempotent and will overwrite the existing output. More details about implementation are in the script code at dodo.py
+
+1. convert strings from .properties files to .mo for bundling
+This step combines the .properties files into a single file, discarding any strings that are not present in code and normalizing curly quotes and unrecognized characters in the strings it keeps. (These files are separate because they are pulled from separate translation sources internally.)
+> python -m doit properties
+
+2. Convert the combined .properties file into a .po file (these are human readable)
+> python -m doit po
+
+3. Convert the .po files into .mo files (these are not human readable)
+This also checks the .mo files for validity by loading them with gettext
+> python -m doit mo

bin/i18n/README.md

@@ -0,0 +1,25 @@
+"""
+i18n utilities for tabcmd localization.
+
+This package contains tools for checking and processing localization strings.
+"""
+
+from .check_strings import (
+    find_python_files,
+    extract_string_keys_from_file,
+    load_properties_files,
+    load_properties_file,
+    find_missing_strings,
+    check_build_mode,
+    check_dev_mode
+)
+
+__all__ = [
+    'find_python_files',
+    'extract_string_keys_from_file', 
+    'load_properties_files',
+    'load_properties_file',
+    'find_missing_strings',
+    'check_build_mode',
+    'check_dev_mode'
+]