debconf-translator 0.4.1__tar.gz

debconf_translator-0.4.1/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: debconf-translator
+Version: 0.4.1
+Summary: GTK4/Adwaita tool for managing Debconf template translations
+Author-email: Daniel Nylander <daniel@danielnylander.se>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/yeager/debconf-translator
+Project-URL: Bug Tracker, https://github.com/yeager/debconf-translator/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Debconf Translation Manager
+
+A GTK4/Adwaita tool for managing Debconf template translations in Debian and Ubuntu.
+
+<img width="1206" height="754" alt="image" src="https://github.com/user-attachments/assets/801eb597-ecab-428d-a843-f3fc85bb7e00" />
+
+
+## Features
+
+- **Dashboard** — Overview of translation status per language with statistics
+- **Package Browser** — Browse untranslated packages sorted by popularity (popcon)
+- **Built-in PO Editor** — Edit translations inline with source/translation side-by-side
+- **Review Board** — Track debconf templates under review on l10n.debian.org
+- **BTS Submission** — Generate bug reports for submitting translations
+- **CLI** — Command-line interface for status checks and batch operations
+
+## Installation
+
+### PyPI / pipx (Debian/Ubuntu)
+
+Install GTK4, libadwaita and the system PyGObject bindings first; pip cannot
+install these native system libraries:
+
+```bash
+sudo apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1 pipx
+pipx install --system-site-packages debconf-translator
+```
+
+
+### From .deb package (Debian/Ubuntu)
+```bash
+# Add the repository
+echo "deb https://yeager.github.io/debian-repo/ stable main" | sudo tee /etc/apt/sources.list.d/yeager.list
+sudo apt update && sudo apt install debconf-translator
+```
+
+### From .rpm package (Fedora)
+```bash
+sudo dnf install debconf-translator
+```
+
+### From source
+```bash
+pip install .
+debconf-translator
+```
+
+## Usage
+
+### GUI
+```bash
+debconf-translator
+```
+
+### CLI
+```bash
+# Check translation status
+debconf-translator status sv
+debconf-translator status sv --json
+
+# Download untranslated templates
+debconf-translator fetch sv -o ./translations/
+
+# Show packages under review
+debconf-translator reviews
+```
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| Ctrl+1 | Dashboard |
+| Ctrl+2 | Packages |
+| Ctrl+3 | Review Board |
+| Ctrl+4 | Submit |
+| Ctrl+T | Toggle Dark Theme |
+| Ctrl+Q | Quit |
+
+## Translation
+
+Translations are managed on [Transifex](https://www.transifex.com/danielnylander/debconf-translator/).
+
+## License
+
+GPL-3.0-or-later
+
+## Author
+
+Daniel Nylander <daniel@danielnylander.se>

debconf_translator-0.4.1/README.md

@@ -0,0 +1,89 @@
+# Debconf Translation Manager
+
+A GTK4/Adwaita tool for managing Debconf template translations in Debian and Ubuntu.
+
+<img width="1206" height="754" alt="image" src="https://github.com/user-attachments/assets/801eb597-ecab-428d-a843-f3fc85bb7e00" />
+
+
+## Features
+
+- **Dashboard** — Overview of translation status per language with statistics
+- **Package Browser** — Browse untranslated packages sorted by popularity (popcon)
+- **Built-in PO Editor** — Edit translations inline with source/translation side-by-side
+- **Review Board** — Track debconf templates under review on l10n.debian.org
+- **BTS Submission** — Generate bug reports for submitting translations
+- **CLI** — Command-line interface for status checks and batch operations
+
+## Installation
+
+### PyPI / pipx (Debian/Ubuntu)
+
+Install GTK4, libadwaita and the system PyGObject bindings first; pip cannot
+install these native system libraries:
+
+```bash
+sudo apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1 pipx
+pipx install --system-site-packages debconf-translator
+```
+
+
+### From .deb package (Debian/Ubuntu)
+```bash
+# Add the repository
+echo "deb https://yeager.github.io/debian-repo/ stable main" | sudo tee /etc/apt/sources.list.d/yeager.list
+sudo apt update && sudo apt install debconf-translator
+```
+
+### From .rpm package (Fedora)
+```bash
+sudo dnf install debconf-translator
+```
+
+### From source
+```bash
+pip install .
+debconf-translator
+```
+
+## Usage
+
+### GUI
+```bash
+debconf-translator
+```
+
+### CLI
+```bash
+# Check translation status
+debconf-translator status sv
+debconf-translator status sv --json
+
+# Download untranslated templates
+debconf-translator fetch sv -o ./translations/
+
+# Show packages under review
+debconf-translator reviews
+```
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| Ctrl+1 | Dashboard |
+| Ctrl+2 | Packages |
+| Ctrl+3 | Review Board |
+| Ctrl+4 | Submit |
+| Ctrl+T | Toggle Dark Theme |
+| Ctrl+Q | Quit |
+
+## Translation
+
+Translations are managed on [Transifex](https://www.transifex.com/danielnylander/debconf-translator/).
+
+## License
+
+GPL-3.0-or-later
+
+## Author
+
+Daniel Nylander <daniel@danielnylander.se>

debconf_translator-0.4.1/debconf_translator/__init__.py

@@ -0,0 +1,20 @@
+"""Debconf Translation Manager — GTK4/Adwaita tool for managing Debconf template translations."""
+
+import gettext
+import locale
+import os
+
+__version__ = "0.4.1"
+__app_id__ = "se.danielnylander.debconf-translator"
+__author__ = "Daniel Nylander"
+__email__ = "daniel@danielnylander.se"
+
+# Centralized locale/gettext setup — all modules import _ from here
+_localedir = os.path.join(os.path.dirname(__file__), '..', 'locale')
+if not os.path.isdir(_localedir):
+    _localedir = '/usr/share/locale'
+
+gettext.bindtextdomain('debconf-translator', _localedir)
+gettext.textdomain('debconf-translator')
+
+_ = gettext.gettext

debconf_translator-0.4.1/debconf_translator/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running as python3 -m debconf_translator."""
+import sys
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

debconf_translator-0.4.1/debconf_translator/app.py

@@ -0,0 +1,178 @@
+"""GTK4/Adwaita application entry point."""
+
+import json
+import logging
+import os
+import sys
+from pathlib import Path
+
+import gi
+gi.require_version("Gtk", "4.0")
+gi.require_version("Adw", "1")
+from gi.repository import Adw, Gio, GLib, Gtk
+
+from . import __app_id__, __version__, _
+
+log = logging.getLogger(__name__)
+
+CONFIG_DIR = Path(GLib.get_user_config_dir()) / "debconf-translator"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+
+def load_config() -> dict:
+    if CONFIG_FILE.exists():
+        try:
+            return json.loads(CONFIG_FILE.read_text())
+        except (json.JSONDecodeError, OSError):
+            pass
+    return {}
+
+
+def save_config(config: dict) -> None:
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps(config, indent=2))
+
+
+class DebconfTranslatorApp(Adw.Application):
+    def __init__(self):
+        super().__init__(
+            application_id=__app_id__,
+            flags=Gio.ApplicationFlags.DEFAULT_FLAGS,
+        )
+        self._setup_actions()
+
+    def _setup_actions(self):
+        actions = [
+            ("quit", self._on_quit, ["<primary>q"]),
+            ("about", self._on_about, None),
+            ("shortcuts", self._on_shortcuts, ["<primary>question"]),
+            ("theme", self._on_toggle_theme, ["<primary>t"]),
+        ]
+        for name, callback, accels in actions:
+            action = Gio.SimpleAction.new(name, None)
+            action.connect("activate", callback)
+            self.add_action(action)
+            if accels:
+                self.set_accels_for_action(f"app.{name}", accels)
+
+        self.set_accels_for_action("win.navigate-dashboard", ["<primary>1"])
+        self.set_accels_for_action("win.navigate-packages", ["<primary>2"])
+        self.set_accels_for_action("win.navigate-reviews", ["<primary>3"])
+        self.set_accels_for_action("win.navigate-submit", ["<primary>4"])
+
+    def do_activate(self):
+        from .window import DebconfTranslatorWindow
+
+        win = self.props.active_window
+        if not win:
+            win = DebconfTranslatorWindow(application=self)
+        win.present()
+
+    def _on_quit(self, *_args):
+        self.quit()
+
+    def _on_about(self, *_args):
+        win = self.props.active_window
+        about = Adw.AboutDialog.new()
+        about.set_application_name(_("Debconf Translation Manager"))
+        about.set_application_icon(__app_id__)
+        about.set_version(__version__)
+        about.set_developer_name("Daniel Nylander")
+        about.set_license_type(Gtk.License.GPL_3_0)
+        about.set_website("https://github.com/yeager/debconf-translator")
+        about.set_issue_url("https://github.com/yeager/debconf-translator/issues")
+        about.set_developers(["Daniel Nylander <daniel@danielnylander.se>"])
+        about.set_copyright("© 2026 Daniel Nylander")
+        about.set_comments(
+            _("GTK4/Adwaita tool for managing Debconf template translations")
+        )
+        debug_lines = [
+            f"debconf-translator {__version__}",
+            f"GTK {Gtk.get_major_version()}.{Gtk.get_minor_version()}.{Gtk.get_micro_version()}",
+            f"libadwaita {Adw.get_major_version()}.{Adw.get_minor_version()}.{Adw.get_micro_version()}",
+            f"Python {sys.version}",
+            f"OS: {os.uname().sysname} {os.uname().release}",
+        ]
+        about.set_debug_info("\n".join(debug_lines))
+        about.set_debug_info_filename("debconf-translator-debug.txt")
+        about.present(win)
+
+    def _on_shortcuts(self, *_args):
+        win = self.props.active_window
+        builder = Gtk.Builder.new_from_string(SHORTCUTS_UI, -1)
+        shortcuts_win = builder.get_object("shortcuts")
+        shortcuts_win.set_transient_for(win)
+        shortcuts_win.present()
+
+    def _on_toggle_theme(self, *_args):
+        sm = Adw.StyleManager.get_default()
+        if sm.get_dark():
+            sm.set_color_scheme(Adw.ColorScheme.FORCE_LIGHT)
+        else:
+            sm.set_color_scheme(Adw.ColorScheme.FORCE_DARK)
+
+
+SHORTCUTS_UI = """\
+<?xml version="1.0" encoding="UTF-8"?>
+<interface>
+  <object class="GtkShortcutsWindow" id="shortcuts">
+    <property name="modal">1</property>
+    <child>
+      <object class="GtkShortcutsSection">
+        <property name="section-name">shortcuts</property>
+        <child>
+          <object class="GtkShortcutsGroup">
+            <property name="title" translatable="yes">General</property>
+            <child>
+              <object class="GtkShortcutsShortcut">
+                <property name="title" translatable="yes">Toggle Dark Theme</property>
+                <property name="accelerator">&lt;primary&gt;t</property>
+              </object>
+            </child>
+            <child>
+              <object class="GtkShortcutsShortcut">
+                <property name="title" translatable="yes">Quit</property>
+                <property name="accelerator">&lt;primary&gt;q</property>
+              </object>
+            </child>
+          </object>
+        </child>
+        <child>
+          <object class="GtkShortcutsGroup">
+            <property name="title" translatable="yes">Navigation</property>
+            <child>
+              <object class="GtkShortcutsShortcut">
+                <property name="title" translatable="yes">Dashboard</property>
+                <property name="accelerator">&lt;primary&gt;1</property>
+              </object>
+            </child>
+            <child>
+              <object class="GtkShortcutsShortcut">
+                <property name="title" translatable="yes">Packages</property>
+                <property name="accelerator">&lt;primary&gt;2</property>
+              </object>
+            </child>
+            <child>
+              <object class="GtkShortcutsShortcut">
+                <property name="title" translatable="yes">Review Board</property>
+                <property name="accelerator">&lt;primary&gt;3</property>
+              </object>
+            </child>
+            <child>
+              <object class="GtkShortcutsShortcut">
+                <property name="title" translatable="yes">Submit</property>
+                <property name="accelerator">&lt;primary&gt;4</property>
+              </object>
+            </child>
+          </object>
+        </child>
+      </object>
+    </child>
+  </object>
+</interface>
+"""
+
+
+def main():
+    app = DebconfTranslatorApp()
+    return app.run(sys.argv)

debconf_translator-0.4.1/debconf_translator/cli/__init__.py

@@ -0,0 +1,125 @@
+"""CLI interface for debconf-translator."""
+
+import argparse
+import sys
+
+from .. import __version__, _
+
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="debconf-translator",
+        description=_("Debconf Translation Manager — manage debconf template translations"),
+    )
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+
+    sub = parser.add_subparsers(dest="command")
+
+    # GUI
+    sub.add_parser("gui", help=_("Launch the graphical interface"))
+
+    # Status
+    status_p = sub.add_parser("status", help=_("Show translation status for a language"))
+    status_p.add_argument("lang", default="sv", nargs="?", help=_("Language code (default: sv)"))
+    status_p.add_argument("--json", "-j", action="store_true", help=_("Output as JSON"))
+    status_p.add_argument("-q", "--quiet", action="store_true", help=_("Minimal output"))
+
+    # Fetch
+    fetch_p = sub.add_parser("fetch", help=_("Download POT files for untranslated packages"))
+    fetch_p.add_argument("lang", default="sv", nargs="?")
+    fetch_p.add_argument("--output", "-o", default=".", help=_("Output directory"))
+
+    # Reviews
+    reviews_p = sub.add_parser("reviews", help=_("Show packages under review"))
+    reviews_p.add_argument("--json", "-j", action="store_true", help=_("Output as JSON"))
+
+    args = parser.parse_args()
+
+    if args.command is None or args.command == "gui":
+        from ..app import main as gui_main
+        return gui_main()
+
+    if args.command == "status":
+        return _cmd_status(args)
+    elif args.command == "fetch":
+        return _cmd_fetch(args)
+    elif args.command == "reviews":
+        return _cmd_reviews(args)
+
+
+def _cmd_status(args):
+    from ..scraper import fetch_language_status
+    stats, packages, translators = fetch_language_status(args.lang)
+
+    if args.json:
+        import json
+        print(json.dumps({
+            "language": stats.code,
+            "translated": stats.translated,
+            "total": stats.total,
+            "progress": round(stats.progress, 1),
+            "untranslated_packages": len(packages),
+            "packages": [{"name": p.name, "strings": p.strings_total} for p in packages],
+        }, indent=2))
+    elif args.quiet:
+        print(f"{stats.translated}/{stats.total} ({stats.progress:.1f}%)")
+    else:
+        print(f"Language: {args.lang}")
+        print(f"Translated: {stats.translated}/{stats.total} ({stats.progress:.1f}%)")
+        print(f"Untranslated packages: {len(packages)}")
+        if packages:
+            print()
+            packages.sort(key=lambda p: p.strings_total, reverse=True)
+            for p in packages[:20]:
+                print(f"  {p.name:40s} {p.strings_total:4d} strings")
+            if len(packages) > 20:
+                print(f"  ... and {len(packages) - 20} more")
+
+        if translators:
+            medals = ["🥇", "🥈", "🥉"]
+            print(f"\nTop translators ({args.lang}):")
+            for i, t in enumerate(translators[:10]):
+                medal = medals[i] if i < 3 else f"  #{i+1}"
+                print(f"  {medal} {t.name:35s} {t.strings:5d} strings ({t.packages} pkgs)")
+
+
+def _cmd_fetch(args):
+    from ..scraper import fetch_language_status, fetch_pot_file
+    from pathlib import Path
+
+    outdir = Path(args.output)
+    outdir.mkdir(parents=True, exist_ok=True)
+
+    _, packages, _ = fetch_language_status(args.lang)
+    print(f"Found {len(packages)} untranslated packages")
+
+    for pkg in packages:
+        pot = fetch_pot_file(pkg.name)
+        if pot:
+            (outdir / f"{pkg.name}.pot").write_text(pot)
+            print(f"  ✓ {pkg.name}")
+        else:
+            print(f"  ✗ {pkg.name} (not found)")
+
+
+def _cmd_reviews(args):
+    from ..scraper import fetch_reviews
+    reviews = fetch_reviews()
+
+    if not reviews:
+        print("No active reviews found")
+        return
+
+    if args.json:
+        import json
+        print(json.dumps([{
+            "package": r.package,
+            "status": r.status,
+            "bug": r.bug_number,
+        } for r in reviews], indent=2))
+    else:
+        print(f"{len(reviews)} packages under review:")
+        for r in reviews:
+            bug = f" (#{r.bug_number})" if r.bug_number else ""
+            print(f"  {r.package:40s} {r.status:10s}{bug}")

debconf_translator-0.4.1/debconf_translator/models.py

@@ -0,0 +1,77 @@
+from . import _
+"""Data models for debconf translation tracking."""
+
+import json
+from dataclasses import dataclass, field, asdict
+from enum import IntEnum
+from pathlib import Path
+from typing import Optional
+
+
+class TranslationStatus(IntEnum):
+    UNTRANSLATED = 0
+    IN_PROGRESS = 1
+    TRANSLATED = 2
+    SUBMITTED = 3  # Sent to BTS
+
+
+@dataclass
+class DebconfPackage:
+    """A Debian package with debconf templates."""
+    name: str
+    section: str = "main"
+    strings_total: int = 0
+    strings_translated: int = 0
+    popcon_rank: int = 0
+    status: TranslationStatus = TranslationStatus.UNTRANSLATED
+    pot_url: str = ""
+    po_path: str = ""  # Local path to .po file
+    bts_bug: str = ""  # Bug number if submitted
+    notes: str = ""
+
+    @property
+    def progress(self) -> float:
+        if self.strings_total == 0:
+            return 0.0
+        return self.strings_translated / self.strings_total * 100
+
+    @property
+    def display_status(self) -> str:
+        return {
+            TranslationStatus.UNTRANSLATED: _("Untranslated"),
+            TranslationStatus.IN_PROGRESS: _("In Progress"),
+            TranslationStatus.TRANSLATED: _("Translated"),
+            TranslationStatus.SUBMITTED: _("Submitted"),
+        }.get(self.status, "?")
+
+
+@dataclass
+class ReviewItem:
+    """A debconf template under review on l10n.debian.org."""
+    package: str
+    status: str = ""  # "bts", "review", etc.
+    bug_number: str = ""
+    reviewer: str = ""
+    date: str = ""
+    original_strings: list = field(default_factory=list)
+    new_strings: list = field(default_factory=list)
+    url: str = ""
+
+
+@dataclass
+class LanguageStats:
+    """Statistics for a language."""
+    code: str
+    name: str
+    translated: int = 0
+    total: int = 0
+    untranslated_packages: int = 0
+    in_progress_packages: int = 0
+
+    @property
+    def progress(self) -> float:
+        if self.total == 0:
+            return 0.0
+        return self.translated / self.total * 100
+
+