language.py

Go to the documentation of this file.

"""!
********************************************************************************
@file   language.py
@brief  Supported languages and widget text translation
********************************************************************************
"""
 
import logging
from typing import Any, TYPE_CHECKING
 
from Source.version import __title__
from Source.Util.app_data import read_language, write_language, ELanguages
from Source.Util.gui_toolkit import config_menu, config_btn
 
 
if TYPE_CHECKING:
    from Source.Controller.main_window import MainWindow
 
log = logging.getLogger(__title__)
 
L_MENU_PRINTS = ["Prints", "Ausdrucke"]
L_MENU_SHOW_STATUS = ["Show Status", "Zwischenstand anzeigen"]
L_MENU_OPEN_FOLDER = ["Open Folder", "Ordner öffnen"]
L_MENU_COMBINE_REPORT = ["Combine Report", "Bericht kombinieren"]
L_MENU_MANUAL_COMBINE = ["Manual Selection (CSV files)", "Manuelle Auswahl (CSV-Dateien)"]
L_MENU_AUTO_COMBINE = ["Auto Selection (Folder)", "Automatische Auswahl (Ordner)"]
L_MENU_PRINT_FILE = ["Print File", "Datei drucken"]
L_MENU_ARTICLE_PREVIEW = ["Article Print Preview", "Artikel Druckvorschau"]
L_MENU_ENABLE_PRINT_REPORT = ["Enable Print Report", "Druckbericht aktivieren"]
L_MENU_CREATE_REPORT = ["Create Report", "Bericht erstellen"]
L_MENU_CONFIG = ["Configuration", "Konfiguration"]
L_MENU_USER = ["User", "Benutzer"]
L_MENU_EDIT = ["Edit", "Bearbeiten"]
L_MENU_IMPORT = ["Import", "Importieren"]
L_MENU_EXPORT = ["Export", "Exportieren"]
L_MENU_SET_DEFAULT = ["Reset (set default)", "Zurücksetzen (Standard Werte)"]
L_MENU_ARTICLE = ["Articles", "Artikel"]
L_MENU_CHANGE_PATH = ["Change Output Path", "Ausgabeverzeichnis ändern"]
L_MENU_PRINTER_PORT = ["Printer COM-Port", "Drucker COM-Anschluss"]
L_MENU_PAPER_WIDTH = ["Paper Width", "Papierbreite"]
L_MENU_SETTINGS = ["Settings", "Einstellungen"]
L_MENU_SOUND = ["Sound", "Ton"]
L_MENU_THEME = ["Theme", "Thema"]
L_MENU_AUTO = ["Automatic", "Automatisch"]
L_MENU_LIGHT = ["Light", "Hell"]
L_MENU_DARK = ["Dark", "Dunkel"]
L_MENU_CLASSIC = ["Classic", "Klassisch"]
L_MENU_SYSTEM = ["System Default", "System Standard"]
L_MENU_LANGUAGE = ["Language", "Sprache"]
L_MENU_LANGUAGE_ENGLISH = ["English", "Englisch"]
L_MENU_LANGUAGE_GERMAN = ["German", "Deutsch"]
L_MENU_SHOW_PRICE = ["Show Price", "Preis anzeigen"]
L_MENU_LOG_VERBOSITY = ["Log Verbosity", "Log Verbosität"]
L_MENU_LOG_ERROR = ["Error", "Fehler"]
L_MENU_LOG_WARNING = ["Warning", "Warnung"]
L_MENU_LOG_INFO = ["Info", "Infos"]
L_MENU_LOG_DEBUG = ["Debug", "Debuggen"]
L_MENU_HELP = ["Help", "Hilfe"]
L_MENU_SHOW_HELP = ["Show Help", "Hilfe anzeigen"]
L_MENU_ABOUT = ["About", "Über"]
L_MENU_RESET = ["Reset", "Zurücksetzen"]
 
L_COMBINED_TITLE = ["Combined Report of printouts", "Kombinierter Bericht der Ausdrucke"]
L_REPORT_TITLE = ["Report of printouts", "Bericht der Ausdrucke"]
L_REPORT_STATUS_TITLE = ["Status of printouts", "Zwischenstand der Ausdrucke"]
L_USER_STATUS_TITLE = ["User Status of printouts", "Benutzerstand der Ausdrucke"]
 
L_PRICE = ["Price", "Preis"]
L_SAVE = ["FINISH", "FERTIG"]
L_PRINT = ["PRINT", "DRUCKEN"]
L_OPEN = ["OPEN", "ÖFFNEN"]
L_CLEAR = ["CLR", "ENTF"]
L_CALC = ["CALC", "RCH"]
 
L_YES = ["Yes", "Ja"]
L_NO = ["No", "Nein"]
L_CLOSE = ["Close", "Schließen"]
L_CANCEL = ["Cancel", "Abbrechen"]
L_COPY_URL = ["Copy URL", "URL kopieren"]
L_REPAIR = ["Repair", "Reparieren"]
L_YOU_SURE = ["You sure?", "Sind Sie sicher?"]
L_UNEXP_ERROR = ["Unexpected error occurred", "Ein unerwarteter Fehler ist aufgetreten"]
L_TOTAL = ["Total", "Gesamt"]
L_SUM = ["Sum", "Summe"]
 
 
class Language:
    """!
    @brief Class to set language.
    @param ui : main window object
    """
 
    def __init__(self, ui: "MainWindow") -> None:
        self.ui = ui
        self.e_language = read_language()
        log.debug("Select Language: %s", self.e_language)
        self.update_widgets(b_update_screen=False)
 
    def update_language(self, e_language: ELanguages) -> None:
        """!
        @brief Update dark mode status.
        @param e_language : select language mode
        """
        self.e_language = e_language
        write_language(self.e_language)
        self.update_widgets()
        match self.e_language:
            case ELanguages.ENGLISH:
                language = self.get_language_text(L_MENU_LANGUAGE_ENGLISH)
            case ELanguages.GERMAN:
                language = self.get_language_text(L_MENU_LANGUAGE_GERMAN)
            case _:
                language = "Unknown"
        self.ui.set_status([f"Language set to {language}",
                            f"Sprache geändert zu {language}"])
 
    def get_language_text(self, l_text: list[Any]) -> Any:
        """!
        @brief Get language text
        @param l_text : list with possible language text
        @return text of active language
        """
        index = list(ELanguages).index(self.e_language)
        if len(l_text) > index:
            text = l_text[index]
            if not text:
                text = l_text[0]  # get default language if translate
        else:
            text = l_text[0]
            log.debug("Not all Languages supported: %s", l_text)
        return text
 
    def update_widgets(self, b_update_screen: bool = True) -> None:
        """!
        @brief Update widgets to actual language
        @param b_update_screen : status if screen should updated
        """
        config_menu(self.ui.menu_prints, text=self.get_language_text(L_MENU_PRINTS))
        config_menu(self.ui.action_show_interim, text=self.get_language_text(L_MENU_SHOW_STATUS))
        config_menu(self.ui.action_open_folder, text=self.get_language_text(L_MENU_OPEN_FOLDER))
        config_menu(self.ui.menu_combine_report, text=self.get_language_text(L_MENU_COMBINE_REPORT))
        config_menu(self.ui.action_combine_manual, text=self.get_language_text(L_MENU_MANUAL_COMBINE))
        config_menu(self.ui.action_combine_auto, text=self.get_language_text(L_MENU_AUTO_COMBINE))
        config_menu(self.ui.action_print_file, text=self.get_language_text(L_MENU_PRINT_FILE))
        config_menu(self.ui.action_article_preview, text=self.get_language_text(L_MENU_ARTICLE_PREVIEW))
        config_menu(self.ui.action_enable_report, text=self.get_language_text(L_MENU_ENABLE_PRINT_REPORT))
        config_menu(self.ui.action_create_billing, text=self.get_language_text(L_MENU_CREATE_REPORT))
 
        config_menu(self.ui.menu_configuration, text=self.get_language_text(L_MENU_CONFIG))
        config_menu(self.ui.menu_user, text=self.get_language_text(L_MENU_USER))
        config_menu(self.ui.action_user_edit, text=self.get_language_text(L_MENU_EDIT))
        config_menu(self.ui.action_user_import, text=self.get_language_text(L_MENU_IMPORT))
        config_menu(self.ui.action_user_export, text=self.get_language_text(L_MENU_EXPORT))
        config_menu(self.ui.action_user_new, text=self.get_language_text(L_MENU_SET_DEFAULT))
        config_menu(self.ui.menu_articles, text=self.get_language_text(L_MENU_ARTICLE))
        config_menu(self.ui.action_articles_edit, text=self.get_language_text(L_MENU_EDIT))
        config_menu(self.ui.action_articles_import, text=self.get_language_text(L_MENU_IMPORT))
        config_menu(self.ui.action_articles_export, text=self.get_language_text(L_MENU_EXPORT))
        config_menu(self.ui.action_articles_new, text=self.get_language_text(L_MENU_SET_DEFAULT))
        config_menu(self.ui.action_change_path, text=self.get_language_text(L_MENU_CHANGE_PATH))
        config_menu(self.ui.menu_com_port, text=self.get_language_text(L_MENU_PRINTER_PORT))
        config_menu(self.ui.menu_paper_width, text=self.get_language_text(L_MENU_PAPER_WIDTH))
 
        config_menu(self.ui.menu_settings, text=self.get_language_text(L_MENU_SETTINGS))
        config_menu(self.ui.action_sound, text=self.get_language_text(L_MENU_SOUND))
        config_menu(self.ui.menu_style, text=self.get_language_text(L_MENU_THEME))
        config_menu(self.ui.action_auto, text=self.get_language_text(L_MENU_AUTO))
        config_menu(self.ui.action_light, text=self.get_language_text(L_MENU_LIGHT))
        config_menu(self.ui.action_dark, text=self.get_language_text(L_MENU_DARK))
        config_menu(self.ui.action_normal, text=self.get_language_text(L_MENU_CLASSIC))
        config_menu(self.ui.action_system, text=self.get_language_text(L_MENU_SYSTEM))
        config_menu(self.ui.menu_language, text=self.get_language_text(L_MENU_LANGUAGE))
        config_menu(self.ui.action_english, text=self.get_language_text(L_MENU_LANGUAGE_ENGLISH))
        config_menu(self.ui.action_german, text=self.get_language_text(L_MENU_LANGUAGE_GERMAN))
        config_menu(self.ui.action_show_price, text=self.get_language_text(L_MENU_SHOW_PRICE))
        config_menu(self.ui.menu_log_verbosity, text=self.get_language_text(L_MENU_LOG_VERBOSITY))
        config_menu(self.ui.action_log_error, text=f"(0) {self.get_language_text(L_MENU_LOG_ERROR)}")
        config_menu(self.ui.action_log_warning, text=f"(1) {self.get_language_text(L_MENU_LOG_WARNING)}")
        config_menu(self.ui.action_log_info, text=f"(2) {self.get_language_text(L_MENU_LOG_INFO)}")
        config_menu(self.ui.action_log_debug, text=f"(3) {self.get_language_text(L_MENU_LOG_DEBUG)}")
 
        config_menu(self.ui.menu_help, text=self.get_language_text(L_MENU_HELP))
        config_menu(self.ui.action_help, text=self.get_language_text(L_MENU_SHOW_HELP))
        config_menu(self.ui.action_about_app, text=f"{self.get_language_text(L_MENU_ABOUT)} {__title__}")
        config_menu(self.ui.action_reset, text=self.get_language_text(L_MENU_RESET))
 
        config_btn(self.ui.btn_calc, text=self.get_language_text(L_CALC))
 
        if b_update_screen:
            self.ui.update_screen()
 
    def get_table_row_description(self) -> list[str]:
        """!
        @brief Get table row description
        @return list with table description
        """
        l_table_row_description = ["n", self.get_language_text(L_MENU_ARTICLE), self.get_language_text(L_PRICE)]
        return l_table_row_description