ruyi 0.44.0b20251219__py3-none-any.whl → 0.45.0__py3-none-any.whl

ruyi/ruyipkg/list.py

@@ -1,6 +1,7 @@
 from itertools import chain
 
 from ..config import GlobalConfig
+from ..i18n import _
 from ..log import RuyiLogger
 from ..utils.porcelain import PorcelainOutput
 from .augmented_pkg import AugmentedPkg
@@ -22,9 +23,11 @@ def do_list(
             # all packages either
             return 1
 
-        logger.F("no filter specified for list operation")
+        logger.F(_("no filter specified for list operation"))
         logger.I(
-            "for the old behavior of listing all packages, try [yellow]ruyi list --name-contains ''[/]"
+            _(
+                "for the old behavior of listing all packages, try [yellow]ruyi list --name-contains ''[/]"
+            )
         )
         return 1
 
@@ -49,7 +52,7 @@ def _do_list_non_verbose(
     logger: RuyiLogger,
     augmented_pkgs: list[AugmentedPkg],
 ) -> int:
-    logger.stdout("List of available packages:\n")
+    logger.stdout(_("List of available packages:\n"))
 
     for ap in augmented_pkgs:
         logger.stdout(f"* [bold green]{ap.category}/{ap.name}[/]")
@@ -82,45 +85,49 @@ def _print_pkg_detail(
     logger.stdout(f"[bold]## [green]{pm.category}/{pm.name}[/] [blue]{pm.ver}[/][/]\n")
 
     if pm.slug is not None:
-        logger.stdout(f"* Slug: [yellow]{pm.slug}[/]")
+        logger.stdout(_("* Slug: [yellow]{slug}[/]").format(slug=pm.slug))
     else:
-        logger.stdout("* Slug: (none)")
-    logger.stdout(f"* Package kind: {sorted(pm.kind)}")
-    logger.stdout(f"* Vendor: {pm.vendor_name}")
+        logger.stdout(_("* Slug: (none)"))
+    logger.stdout(_("* Package kind: {kind}").format(kind=sorted(pm.kind)))
+    logger.stdout(_("* Vendor: {vendor}").format(vendor=pm.vendor_name))
     if upstream_ver := pm.upstream_version:
-        logger.stdout(f"* Upstream version number: {upstream_ver}")
+        logger.stdout(
+            _("* Upstream version number: {version}").format(version=upstream_ver)
+        )
     else:
-        logger.stdout("* Upstream version number: (undeclared)")
+        logger.stdout(_("* Upstream version number: (undeclared)"))
     logger.stdout("")
 
     sv = pm.service_level
     if sv.has_known_issues:
-        logger.stdout("\nPackage has known issue(s):\n")
+        logger.stdout(_("\nPackage has known issue(s):\n"))
         for x in sv.render_known_issues(pm.repo.messages, lang_code):
             logger.stdout(x, end="\n\n")
 
     df = pm.distfiles
-    logger.stdout(f"Package declares {len(df)} distfile(s):\n")
+    logger.stdout(_("Package declares {count} distfile(s):\n").format(count=len(df)))
     for dd in df.values():
         logger.stdout(f"* [green]{dd.name}[/]")
-        logger.stdout(f"    - Size: [yellow]{dd.size}[/] bytes")
+        logger.stdout(_("    - Size: [yellow]{size}[/] bytes").format(size=dd.size))
         for kind, csum in dd.checksums.items():
             logger.stdout(f"    - {kind.upper()}: [yellow]{csum}[/]")
 
     if bm := pm.binary_metadata:
-        logger.stdout("\n### Binary artifacts\n")
+        logger.stdout(_("\n### Binary artifacts\n"))
         for host, data in bm.data.items():
-            logger.stdout(f"* Host [green]{host}[/]:")
-            logger.stdout(f"    - Distfiles: {data['distfiles']}")
+            logger.stdout(_("* Host [green]{host}[/]:").format(host=host))
+            logger.stdout(
+                _("    - Distfiles: {distfiles}").format(distfiles=data["distfiles"])
+            )
             if cmds := data.get("commands"):
-                logger.stdout("    - Available command(s):")
+                logger.stdout(_("    - Available command(s):"))
                 for k in sorted(cmds.keys()):
                     logger.stdout(f"        - [green]{k}[/]")
 
     if tm := pm.toolchain_metadata:
-        logger.stdout("\n### Toolchain metadata\n")
-        logger.stdout(f"* Target: [bold green]{tm.target}[/]")
-        logger.stdout(f"* Quirks: {tm.quirks}")
-        logger.stdout("* Components:")
+        logger.stdout(_("\n### Toolchain metadata\n"))
+        logger.stdout(_("* Target: [bold green]{target}[/]").format(target=tm.target))
+        logger.stdout(_("* Quirks: {quirks}").format(quirks=tm.quirks))
+        logger.stdout(_("* Components:"))
         for tc in tm.components:
             logger.stdout(f'    - {tc["name"]} [bold green]{tc["version"]}[/]')

ruyi/ruyipkg/list_cli.py

@@ -2,6 +2,7 @@ import argparse
 from typing import TYPE_CHECKING
 
 from ..cli.cmd import RootCommand
+from ..i18n import _
 from .list_filter import ListFilter, ListFilterAction
 
 if TYPE_CHECKING:
@@ -15,7 +16,7 @@ class ListCommand(
     has_subcommands=True,
     is_subcommand_required=False,
     has_main=True,
-    help="List available packages in configured repository",
+    help=_("List available packages in configured repository"),
 ):
     @classmethod
     def configure_args(cls, gc: "GlobalConfig", p: "ArgumentParser") -> None:
@@ -23,7 +24,7 @@ class ListCommand(
             "--verbose",
             "-v",
             action="store_true",
-            help="Also show details for every package",
+            help=_("Also show details for every package"),
         )
 
         # filter expressions
@@ -32,28 +33,32 @@ class ListCommand(
             action=ListFilterAction,
             nargs=1,
             dest="filters",
-            help="Match packages that are installed (y/true/1) or not installed (n/false/0)",
+            help=_(
+                "Match packages that are installed (y/true/1) or not installed (n/false/0)"
+            ),
         )
         p.add_argument(
             "--category-contains",
             action=ListFilterAction,
             nargs=1,
             dest="filters",
-            help="Match packages from categories whose names contain the given string",
+            help=_(
+                "Match packages from categories whose names contain the given string"
+            ),
         )
         p.add_argument(
             "--category-is",
             action=ListFilterAction,
             nargs=1,
             dest="filters",
-            help="Match packages from the given category",
+            help=_("Match packages from the given category"),
         )
         p.add_argument(
             "--name-contains",
             action=ListFilterAction,
             nargs=1,
             dest="filters",
-            help="Match packages whose names contain the given string",
+            help=_("Match packages whose names contain the given string"),
         )
 
         if gc.is_experimental:
@@ -62,7 +67,7 @@ class ListCommand(
                 action=ListFilterAction,
                 nargs=1,
                 dest="filters",
-                help="Match packages related to the given entity",
+                help=_("Match packages related to the given entity"),
             )
 
     @classmethod

ruyi/ruyipkg/news.py

@@ -2,6 +2,7 @@ from rich import box
 from rich.table import Table
 
 from ..config import GlobalConfig
+from ..i18n import _
 from ..log import RuyiLogger
 from ..utils.markdown import RuyiStyledMarkdown
 from ..utils.porcelain import PorcelainOutput
@@ -14,9 +15,12 @@ def print_news_item_titles(
     lang: str,
 ) -> None:
     tbl = Table(box=box.SIMPLE, show_edge=False)
-    tbl.add_column("No.")
-    tbl.add_column("ID")
-    tbl.add_column("Title")
+    # i18n NOTE: used as news item table title
+    tbl.add_column(_("No."))
+    # i18n NOTE: used as news item table title
+    tbl.add_column(_("ID"))
+    # i18n NOTE: used as news item table title
+    tbl.add_column(_("Title"))
 
     for ni in newsitems:
         unread = not ni.is_read
@@ -40,14 +44,20 @@ def maybe_notify_unread_news(
 
     unread_newsitems = gc.repo.news_store().list(True)
     if unread_newsitems:
-        gc.logger.stdout(f"\nThere are {len(unread_newsitems)} new news item(s):\n")
+        gc.logger.stdout(
+            _("\nThere are {count} new news item(s):\n").format(
+                count=len(unread_newsitems),
+            )
+        )
         print_news_item_titles(gc.logger, unread_newsitems, gc.lang_code)
-        gc.logger.stdout("\nYou can read them with [yellow]ruyi news read[/].")
+        gc.logger.stdout(_("\nYou can read them with [yellow]ruyi news read[/]."))
         return
 
     if prompt_no_unread:
         gc.logger.stdout(
-            "\nAll news items have been read. To see a list of them, run [yellow]ruyi news list[/].\n"
+            _(
+                "\nAll news items have been read. To see a list of them, run [yellow]ruyi news list[/].\n"
+            )
         )
 
 
@@ -65,9 +75,9 @@ def do_news_list(
                 po.emit(ni.to_porcelain())
         return 0
 
-    logger.stdout("[bold green]News items:[/]\n")
+    logger.stdout(_("[bold green]News items:[/]\n"))
     if not newsitems:
-        logger.stdout("  (no unread item)" if only_unread else "  (no item)")
+        logger.stdout(_("  (no unread item)") if only_unread else _("  (no item)"))
         return 0
 
     print_news_item_titles(logger, newsitems, cfg.lang_code)
@@ -98,7 +108,7 @@ def do_news_read(
             for ni in items:
                 print_news(logger, ni.get_content_for_lang(cfg.lang_code))
         else:
-            logger.stdout("No news to display.")
+            logger.stdout(_("No news to display."))
 
     # record read statuses
     store.mark_as_read(*(ni.id for ni in items))
@@ -123,13 +133,15 @@ def filter_news_items_by_specs(
         try:
             ni_ord = int(i)
             if ni_ord not in ni_by_ord:
-                logger.F(f"there is no news item with ordinal {ni_ord}")
+                logger.F(
+                    _("there is no news item with ordinal {ord}").format(ord=ni_ord)
+                )
                 return None
             items.append(ni_by_ord[ni_ord])
         except ValueError:
             # treat i as id
             if i not in ni_by_id:
-                logger.F(f"there is no news item with ID '{i}'")
+                logger.F(_("there is no news item with ID '{id}'").format(id=i))
                 return None
             items.append(ni_by_id[i])
 

ruyi/ruyipkg/news_cli.py

@@ -2,6 +2,7 @@ import argparse
 from typing import TYPE_CHECKING
 
 from ..cli.cmd import RootCommand
+from ..i18n import _
 
 if TYPE_CHECKING:
     from ..cli.completion import ArgumentParser
@@ -14,7 +15,7 @@ class NewsCommand(
     has_subcommands=True,
     is_subcommand_required=False,
     has_main=True,
-    help="List and read news items from configured repository",
+    help=_("List and read news items from configured repository"),
 ):
     _my_parser: "ArgumentParser | None" = None
 
@@ -36,14 +37,14 @@ class NewsCommand(
 class NewsListCommand(
     NewsCommand,
     cmd="list",
-    help="List news items",
+    help=_("List news items"),
 ):
     @classmethod
     def configure_args(cls, gc: "GlobalConfig", p: "ArgumentParser") -> None:
         p.add_argument(
             "--new",
             action="store_true",
-            help="List unread news items only",
+            help=_("List unread news items only"),
         )
 
     @classmethod
@@ -60,8 +61,10 @@ class NewsListCommand(
 class NewsReadCommand(
     NewsCommand,
     cmd="read",
-    help="Read news items",
-    description="Outputs news item(s) to the console and mark as already read. Defaults to reading all unread items if no item is specified.",
+    help=_("Read news items"),
+    description=_(
+        "Outputs news item(s) to the console and mark as already read. Defaults to reading all unread items if no item is specified."
+    ),
 ):
     @classmethod
     def configure_args(cls, gc: "GlobalConfig", p: "ArgumentParser") -> None:
@@ -69,13 +72,13 @@ class NewsReadCommand(
             "--quiet",
             "-q",
             action="store_true",
-            help="Do not output anything and only mark as read",
+            help=_("Do not output anything and only mark as read"),
         )
         p.add_argument(
             "item",
             type=str,
             nargs="*",
-            help="Ordinal or ID of the news item(s) to read",
+            help=_("Ordinal or ID of the news item(s) to read"),
         )
 
     @classmethod

ruyi/ruyipkg/profile_cli.py

@@ -1,6 +1,7 @@
 import argparse
 from typing import TYPE_CHECKING
 
+from ..i18n import _
 from .list_cli import ListCommand
 
 if TYPE_CHECKING:
@@ -11,7 +12,7 @@ if TYPE_CHECKING:
 class ListProfilesCommand(
     ListCommand,
     cmd="profiles",
-    help="List all available profiles",
+    help=_("List all available profiles"),
 ):
     @classmethod
     def configure_args(cls, gc: "GlobalConfig", p: "ArgumentParser") -> None:
@@ -28,6 +29,11 @@ class ListProfilesCommand(
                     logger.stdout(p.id)
                     continue
 
-                logger.stdout(f"{p.id} (needs quirks: {p.need_quirks})")
+                logger.stdout(
+                    _("{profile_id} (needs quirks: {need_quirks})").format(
+                        profile_id=p.id,
+                        need_quirks=p.need_quirks,
+                    )
+                )
 
         return 0

ruyi/ruyipkg/repo.py

@@ -19,6 +19,7 @@ from urllib import parse
 from pygit2 import clone_repository
 from pygit2.repository import Repository
 
+from ..i18n import _
 from ..log import RuyiLogger
 from ..pluginhost.ctx import PluginHostContext
 from ..telemetry.scope import TelemetryScopeConfig
@@ -167,7 +168,9 @@ class RepoConfig:
                 return [url]
             case _:
                 # deny others
-                logger.W(f"unrecognized dist URL scheme: {u.scheme}")
+                logger.W(
+                    _("unrecognized dist URL scheme: {scheme}").format(scheme=u.scheme)
+                )
                 return []
 
     def get_mirror_urls_for_file(self, mirror_id: str, path: str) -> list[str]:
@@ -286,9 +289,13 @@ class MetadataRepo(ProvidesPackageManifests):
             return self.repo
 
         self.logger.I(
-            f"the package repository does not exist at [yellow]{self.root}[/]"
+            _("the package repository does not exist at [yellow]{root}[/]").format(
+                root=self.root
+            )
+        )
+        self.logger.I(
+            _("cloning from [cyan link={remote}]{remote}[/]").format(remote=self.remote)
         )
-        self.logger.I(f"cloning from [cyan link={self.remote}]{self.remote}[/]")
 
         with RemoteGitProgressIndicator() as pr:
             repo = clone_repository(
@@ -310,7 +317,7 @@ class MetadataRepo(ProvidesPackageManifests):
         return self.repo
 
     def sync(self) -> None:
-        self._gc.logger.I("updating the package repository")
+        self._gc.logger.I(_("updating the package repository"))
 
         repo = self.ensure_git_repo()
 
@@ -327,7 +334,7 @@ class MetadataRepo(ProvidesPackageManifests):
             allow_auto_management=allow_auto_management,
         )
 
-        self._gc.logger.I("package repository is updated")
+        self._gc.logger.I(_("package repository is updated"))
 
     @property
     def global_config(self) -> "GlobalConfig":
@@ -605,7 +612,9 @@ class MetadataRepo(ProvidesPackageManifests):
                         contents = fp.read()
                     except UnicodeDecodeError:
                         self.logger.W(
-                            f"UnicodeDecodeError: {os.path.join(news_dir, f)}"
+                            _("UnicodeDecodeError: {path}").format(
+                                path=os.path.join(news_dir, f)
+                            )
                         )
                         continue
                     cache.add(f, contents)  # may fail but failures are harmless
@@ -638,9 +647,14 @@ class MetadataRepo(ProvidesPackageManifests):
         ret = self.eval_plugin_fn(plugin_entrypoint, args)
         if not isinstance(ret, int):
             self.logger.W(
-                f"unexpected return type of cmd plugin '{plugin_id}': {type(ret)} is not int."
+                _(
+                    "unexpected return type of cmd plugin '{plugin_id}': {type} is not int."
+                ).format(
+                    plugin_id=plugin_id,
+                    type=type(ret),
+                )
             )
-            self.logger.I("forcing return code to 1; the plugin should be fixed")
+            self.logger.I(_("forcing return code to 1; the plugin should be fixed"))
             ret = 1
         return ret
 

ruyi/ruyipkg/unpack.py

@@ -4,6 +4,7 @@ import shutil
 import subprocess
 from typing import Any, BinaryIO, NoReturn, Protocol
 
+from ..i18n import _
 from ..log import RuyiLogger
 from ..utils import ar, prereqs
 from .unpack_method import (
@@ -192,7 +193,12 @@ def _do_unpack_tar(
         retcode = p.wait()
 
     if retcode != 0:
-        raise RuntimeError(f"untar failed: command {' '.join(argv)} returned {retcode}")
+        raise RuntimeError(
+            _("untar failed: command {cmd} returned {retcode}").format(
+                cmd=" ".join(argv),
+                retcode=retcode,
+            )
+        )
 
 
 def _do_unpack_zip(
@@ -206,7 +212,12 @@ def _do_unpack_zip(
     logger.D(f"about to call unzip: argv={argv}")
     retcode = subprocess.call(argv, cwd=dest)
     if retcode != 0:
-        raise RuntimeError(f"unzip failed: command {' '.join(argv)} returned {retcode}")
+        raise RuntimeError(
+            _("unzip failed: command {cmd} returned {retcode}").format(
+                cmd=" ".join(argv),
+                retcode=retcode,
+            )
+        )
 
 
 def _do_unpack_bare_gz(
@@ -226,7 +237,10 @@ def _do_unpack_bare_gz(
         retcode = subprocess.call(argv, stdout=out)
         if retcode != 0:
             raise RuntimeError(
-                f"gunzip failed: command {' '.join(argv)} returned {retcode}"
+                _("gunzip failed: command {cmd} returned {retcode}").format(
+                    cmd=" ".join(argv),
+                    retcode=retcode,
+                )
             )
 
 
@@ -247,7 +261,10 @@ def _do_unpack_bare_bzip2(
         retcode = subprocess.call(argv, stdout=out)
         if retcode != 0:
             raise RuntimeError(
-                f"bzip2 failed: command {' '.join(argv)} returned {retcode}"
+                _("bzip2 failed: command {cmd} returned {retcode}").format(
+                    cmd=" ".join(argv),
+                    retcode=retcode,
+                )
             )
 
 
@@ -263,7 +280,12 @@ def _do_unpack_bare_lz4(
     logger.D(f"about to call lz4: argv={argv}")
     retcode = subprocess.call(argv, cwd=destdir)
     if retcode != 0:
-        raise RuntimeError(f"lz4 failed: command {' '.join(argv)} returned {retcode}")
+        raise RuntimeError(
+            _("lz4 failed: command {cmd} returned {retcode}").format(
+                cmd=" ".join(argv),
+                retcode=retcode,
+            )
+        )
 
 
 def _do_unpack_bare_xz(
@@ -283,7 +305,10 @@ def _do_unpack_bare_xz(
         retcode = subprocess.call(argv, stdout=out)
         if retcode != 0:
             raise RuntimeError(
-                f"xz failed: command {' '.join(argv)} returned {retcode}"
+                _("xz failed: command {cmd} returned {retcode}").format(
+                    cmd=" ".join(argv),
+                    retcode=retcode,
+                )
             )
 
 
@@ -299,7 +324,12 @@ def _do_unpack_bare_zstd(
     logger.D(f"about to call zstd: argv={argv}")
     retcode = subprocess.call(argv, cwd=destdir)
     if retcode != 0:
-        raise RuntimeError(f"zstd failed: command {' '.join(argv)} returned {retcode}")
+        raise RuntimeError(
+            _("zstd failed: command {cmd} returned {retcode}").format(
+                cmd=" ".join(argv),
+                retcode=retcode,
+            )
+        )
 
 
 def _do_unpack_deb(
@@ -321,7 +351,11 @@ def _do_unpack_deb(
                     a.open(f),
                 )
 
-    raise RuntimeError(f"file '{filename}' does not appear to be a deb")
+    raise RuntimeError(
+        _("file '{filename}' does not appear to be a deb").format(
+            filename=filename,
+        )
+    )
 
 
 def _get_unpack_cmds_for_method(m: UnpackMethod) -> list[str]:

ruyi/ruyipkg/unpack_method.py

@@ -3,6 +3,8 @@ import re
 import sys
 from typing import Final
 
+from ..i18n import _
+
 RE_TARBALL: Final = re.compile(r"\.tar(?:\.gz|\.bz2|\.lz4|\.xz|\.zst)?$")
 
 
@@ -60,7 +62,9 @@ class UnrecognizedPackFormatError(Exception):
         self.filename = filename
 
     def __str__(self) -> str:
-        return f"don't know how to unpack file {self.filename}"
+        return _("don't know how to unpack file {filename}").format(
+            filename=self.filename,
+        )
 
 
 def determine_unpack_method(

ruyi/ruyipkg/update_cli.py

@@ -2,6 +2,7 @@ import argparse
 from typing import TYPE_CHECKING
 
 from ..cli.cmd import RootCommand
+from ..i18n import _
 
 if TYPE_CHECKING:
     from ..cli.completion import ArgumentParser
@@ -11,7 +12,7 @@ if TYPE_CHECKING:
 class UpdateCommand(
     RootCommand,
     cmd="update",
-    help="Update RuyiSDK repo and packages",
+    help=_("Update RuyiSDK repo and packages"),
 ):
     @classmethod
     def configure_args(cls, gc: "GlobalConfig", p: "ArgumentParser") -> None:
@@ -32,16 +33,20 @@ class UpdateCommand(
 
         if upgradable:
             logger.stdout(
-                "\nNewer versions are available for some of your installed packages:\n"
+                _(
+                    "\nNewer versions are available for some of your installed packages:\n"
+                )
             )
             for pm, new_ver in upgradable:
                 logger.stdout(
                     f"  - [bold]{pm.category}/{pm.name}[/]: [yellow]{pm.ver}[/] -> [green]{new_ver}[/]"
                 )
             logger.stdout(
-                """
+                _(
+                    """
 Re-run [yellow]ruyi install[/] to upgrade, and don't forget to re-create any affected
 virtual environments."""
+                )
             )
 
         news.maybe_notify_unread_news(cfg, False)