#!/usr/bin/python3
# SPDX-FileCopyrightText: 2020-2025 Univention GmbH
# SPDX-License-Identifier: AGPL-3.0-only
"""
Univention Corporate Server localization tool to extract, update, and compile
GNU gettext Portable Objects (PO files) to Message Objects (MO files).
"""
import argparse
import os
import sys
from . import l10n as tlh
[docs]
def main() -> None:
cmd = os.path.basename(sys.argv[0])
parse_args(cmd)
[docs]
def main_build() -> None:
parse_args("univention-l10n-build")
[docs]
def main_install() -> None:
parse_args("univention-l10n-install")
[docs]
def parse_args(cmd: str) -> None:
parser_common = argparse.ArgumentParser(add_help=False)
group = parser_common.add_argument_group("debhelper", "Common debhelper options")
# group.add_argument("--verbose", "-v", action="store_true", help="Verbose mode: show all commands that modify the package build directory.")
# group.add_argument("--no-act", action="store_true", help="Do not really do anything.")
group.add_argument("--arch", "-a", action="store_true", help="Act on all architecture dependent packages.")
group.add_argument("--indep", "-i", action="store_true", help="Act on all architecture independent packages.")
# group.add_argument("--package", "-p", metavar="package", action="append", help="Act on the package named 'package'.")
# group.add_argument("--same-arch", "-s", acction="store_true", help="Act on all architecture dependent packages having the same architecture.")
# group.add_argument("--no-package", "-N", metavar="package", action="append", help="Do not act on the specified package.")
# group.add_argument("--ignore", metavar="file", action="append", help="Ignore the specified file.")
# group.add_argument("--tmpdir", "-P", metavar="tmpdir", help="Use 'tmpdir' for package build directory.")
# group.add_argument("--mainpackage", metavar="package", help="Changes the package which debhelper considers the 'main package',")
# group.add_argument("--mainpackage", metavar="package", help="Changes the package which debhelper considers the 'main package',")
group.add_argument("--option", "-O", action="append", help="Additional debhelper options.")
parser = argparse.ArgumentParser(description=__doc__, prog="univention-l10n", formatter_class=argparse.RawDescriptionHelpFormatter)
subparsers = parser.add_subparsers(help="sub-command help", dest="subcmd") # required=True
parser_build = subparsers.add_parser("build", description=build.__doc__, prog="univention-l10n-build", parents=[parser_common], formatter_class=argparse.RawDescriptionHelpFormatter)
parser_build.add_argument("--pot", "-t", action="store_true", help="Keep template file")
parser_build.add_argument("language_code", default="de", nargs="?", help="ISO language code.")
parser_build.set_defaults(func=build)
parser_install = subparsers.add_parser("install", description=install.__doc__, prog="univention-l10n-install", parents=[parser_common], formatter_class=argparse.RawDescriptionHelpFormatter)
parser_install.add_argument("language_code", default="de", nargs="?", help="ISO language code.")
parser_install.set_defaults(func=install)
parsers = {
"univention-l10n-build": parser_build,
"univention-l10n-install": parser_install,
"univention-l10n": parser,
}
parser = parsers.get(cmd, parser)
args = parser.parse_args()
args.func(args)
[docs]
def build(args: argparse.Namespace) -> None:
"""
Generate GNU gettext Portable Objects (PO files) from debian/\\*.univention-l10n files
This script reads :file:`debian/*.univention-l10n` files inside the current working
directory and creates gettext Portable Objects defined within. It intends to
facilitate and homogenize the translation build process.
Add it to the build target inside :file:`debian/rules` to build the POs for a certain
language or use it manually inside source packages to update the translation
catalog.
Example :file:`debian/rules` override::
%:
dh --with univention-l10n
or alternatively::
override_dh_auto_build:
univention-l10n-build fr
dh_auto_build
"""
cwd = os.getcwd()
for scase in tlh.get_special_cases_from_srcpkg(cwd, args.language_code):
pot_path = scase.create_po_template()
if os.path.isfile(scase.new_po_path):
tlh.message_catalogs.merge_po(pot_path, scase.new_po_path)
else:
os.link(pot_path, scase.new_po_path)
if not args.pot:
os.unlink(pot_path)
tlh.message_catalogs.univention_location_lines(scase.new_po_path, scase.package_dir)
for module_attrs in tlh.find_base_translation_modules(cwd):
module = tlh.UMCModuleTranslation.from_source_package(module_attrs, args.language_code)
tlh.update_package_translation_files(module, cwd, args.pot)
[docs]
def install(args: argparse.Namespace) -> None:
"""
Generate and install GNU gettext Message Objects (MO files) from debian/\\*.univention-l10n files.
This script reads :file:`debian/*univention-l10n` files inside the current working
directory. It builds the message catalogs and installs them to the path defined
within.
The intended usage is to add it to the install target inside :file:`debian/rules` to
automate in-package translations.
Example file: `debian/rules` override::
%:
dh --with univention-l10n
or alternatively::
override_dh_auto_install:
univention-l10n-install fr
dh_auto_install
"""
for scase in tlh.get_special_cases_from_srcpkg(os.getcwd(), args.language_code):
for source_file_set in scase.get_source_file_sets():
source_file_set.process_target(scase.new_po_path, scase.destination)
if __name__ == "__main__":
main()
