ruyi 0.44.0a20251118__tar.gz → 0.45.0__tar.gz

{ruyi-0.44.0a20251118 → ruyi-0.45.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ruyi
-Version: 0.44.0a20251118
+Version: 0.45.0
 Summary: Package manager for RuyiSDK
 License: Apache License
                                     Version 2.0, January 2004
@@ -224,6 +224,7 @@ Classifier: Topic :: System :: Software Distribution
 Classifier: Typing :: Typed
 Requires-Dist: argcomplete (>=2.0.0)
 Requires-Dist: arpy
+Requires-Dist: babel (>=2.8.0)
 Requires-Dist: fastjsonschema (>=2.15.1)
 Requires-Dist: jinja2 (>=3,<4)
 Requires-Dist: pygit2 (>=1.6) ; python_version >= "3.11"
@@ -408,7 +409,8 @@ described below.
 There are 3 telemetry modes available:
 
 * `local`: data will be collected but not uploaded without user action.
-* `off`: data will not be collected nor uploaded.
+* `off`: data will neither be collected nor uploaded, except for a one-time
+  upload of `ruyi`'s version number on first run.
 * `on`: data will be collected and periodically uploaded.
 
 By default the `local` mode is active from `ruyi` 0.42.0 (inclusive) on, which

{ruyi-0.44.0a20251118 → ruyi-0.45.0}/README.md

@@ -163,7 +163,8 @@ described below.
 There are 3 telemetry modes available:
 
 * `local`: data will be collected but not uploaded without user action.
-* `off`: data will not be collected nor uploaded.
+* `off`: data will neither be collected nor uploaded, except for a one-time
+  upload of `ruyi`'s version number on first run.
 * `on`: data will be collected and periodically uploaded.
 
 By default the `local` mode is active from `ruyi` 0.42.0 (inclusive) on, which

{ruyi-0.44.0a20251118 → ruyi-0.45.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "ruyi"
-version = "0.44.0-alpha.20251118"
+version = "0.45.0"
 description = "Package manager for RuyiSDK"
 keywords = ["ruyi", "ruyisdk"]
 license = { file = "LICENSE-Apache.txt" }
@@ -32,6 +32,7 @@ requires-python = ">=3.10"
 dependencies = [
   "argcomplete>=2.0.0",
   "arpy",
+  "babel>=2.8.0",
   "fastjsonschema>=2.15.1",
   "jinja2 (>=3, <4)",
   "pygit2 (>=1.6, <1.19); python_version<'3.11'",

{ruyi-0.44.0a20251118 → ruyi-0.45.0}/ruyi/__main__.py

@@ -1,9 +1,11 @@
 #!/usr/bin/env python3
 
 import os
+import pathlib
 import sys
 
 import ruyi
+from ruyi.i18n import _, ADAPTER
 from ruyi.utils.ci import is_running_in_ci
 from ruyi.utils.global_mode import (
     EnvGlobalModeProvider,
@@ -41,6 +43,8 @@ def _is_allowed_to_run_as_root() -> bool:
 
 def entrypoint() -> None:
     gm = EnvGlobalModeProvider(os.environ, sys.argv)
+    ADAPTER.init_from_env(os.environ)
+    ADAPTER.hook()
 
     # NOTE: import of `ruyi.log` takes ~90ms on my machine, so initialization
     # of logging is deferred as late as possible
@@ -50,11 +54,16 @@ def entrypoint() -> None:
 
         logger = RuyiConsoleLogger(gm)
 
-        logger.F("refusing to run as super user outside CI without explicit consent")
+        logger.F(_("refusing to run as super user outside CI without explicit consent"))
 
         choices = ", ".join(f"'{x}'" for x in TRUTHY_ENV_VAR_VALUES)
         logger.I(
-            f"re-run with environment variable [yellow]{ENV_FORCE_ALLOW_ROOT}[/] set to one of [yellow]{choices}[/] to signify consent"
+            _(
+                "re-run with environment variable [yellow]{env_var}[/] set to one of [yellow]{choices}[/] to signify consent"
+            ).format(
+                env_var=ENV_FORCE_ALLOW_ROOT,
+                choices=choices,
+            )
         )
         sys.exit(1)
 
@@ -63,7 +72,7 @@ def entrypoint() -> None:
 
         logger = RuyiConsoleLogger(gm)
 
-        logger.F("no argv?")
+        logger.F(_("no argv?"))
         sys.exit(1)
 
     if gm.is_packaged and ruyi.__compiled__.standalone:
@@ -85,8 +94,11 @@ def entrypoint() -> None:
     #
     # we assume the one-file build if Nuitka is detected; sys.argv[0] does NOT
     # work if it's just `ruyi` so we have to check our parent process in that case
-    self_exe = get_nuitka_self_exe() if gm.is_packaged else __file__
     sys.argv[0] = get_argv0()
+    if gm.is_packaged:
+        self_exe = get_nuitka_self_exe()
+    else:
+        self_exe = str(pathlib.Path(sys.argv[0]).resolve())
     gm.record_self_exe(sys.argv[0], __file__, self_exe)
 
     from ruyi.config import GlobalConfig

{ruyi-0.44.0a20251118 → ruyi-0.45.0}/ruyi/cli/cmd.py

@@ -1,6 +1,7 @@
 import argparse
 from typing import Callable, IO, Protocol, TYPE_CHECKING
 
+from ..i18n import _
 from . import RUYI_ENTRYPOINT_NAME
 
 if TYPE_CHECKING:
@@ -114,7 +115,7 @@ class BaseCommand:
             return
 
         sp = p.add_subparsers(
-            title="subcommands",
+            title=_("subcommands"),
             required=cls.is_subcommand_required,
         )
         for subcmd_cls in cls.parsers:
@@ -158,7 +159,7 @@ class RootCommand(
     has_subcommands=True,
     has_main=True,
     prog=RUYI_ENTRYPOINT_NAME,
-    description="RuyiSDK Package Manager",
+    description=_("RuyiSDK Package Manager"),
 ):
     @classmethod
     def configure_args(cls, gc: "GlobalConfig", p: "ArgumentParser") -> None:
@@ -170,12 +171,12 @@ class RootCommand(
             action="store_const",
             dest="func",
             const=cli_version,
-            help="Print version information",
+            help=_("Print version information"),
         )
         p.add_argument(
             "--porcelain",
             action="store_true",
-            help="Give the output in a machine-friendly format if applicable",
+            help=_("Give the output in a machine-friendly format if applicable"),
         )
 
         # https://github.com/python/cpython/issues/67037 prevents the registration
@@ -219,7 +220,7 @@ class AdminCommand(
     has_subcommands=True,
     # https://github.com/python/cpython/issues/67037
     # help=argparse.SUPPRESS,
-    help="(NOT FOR REGULAR USERS) Subcommands for managing Ruyi repos",
+    help=_("(NOT FOR REGULAR USERS) Subcommands for managing Ruyi repos"),
 ):
     @classmethod
     def configure_args(cls, gc: "GlobalConfig", p: "ArgumentParser") -> None:

{ruyi-0.44.0a20251118 → ruyi-0.45.0}/ruyi/cli/config_cli.py

@@ -1,6 +1,7 @@
 import argparse
 from typing import TYPE_CHECKING
 
+from ..i18n import _
 from .cmd import RootCommand
 
 if TYPE_CHECKING:
@@ -13,7 +14,7 @@ class ConfigCommand(
     RootCommand,
     cmd="config",
     has_subcommands=True,
-    help="Manage Ruyi's config options",
+    help=_("Manage Ruyi's config options"),
 ):
     @classmethod
     def configure_args(
@@ -27,7 +28,7 @@ class ConfigCommand(
 class ConfigGetCommand(
     ConfigCommand,
     cmd="get",
-    help="Query the value of a Ruyi config option",
+    help=_("Query the value of a Ruyi config option"),
 ):
     @classmethod
     def configure_args(
@@ -38,7 +39,7 @@ class ConfigGetCommand(
         p.add_argument(
             "key",
             type=str,
-            help="The Ruyi config option to query",
+            help=_("The Ruyi config option to query"),
         )
 
     @classmethod
@@ -66,7 +67,7 @@ class ConfigGetCommand(
 class ConfigSetCommand(
     ConfigCommand,
     cmd="set",
-    help="Set the value of a Ruyi config option",
+    help=_("Set the value of a Ruyi config option"),
 ):
     @classmethod
     def configure_args(
@@ -77,12 +78,12 @@ class ConfigSetCommand(
         p.add_argument(
             "key",
             type=str,
-            help="The Ruyi config option to set",
+            help=_("The Ruyi config option to set"),
         )
         p.add_argument(
             "value",
             type=str,
-            help="The value to set the option to",
+            help=_("The value to set the option to"),
         )
 
     @classmethod
@@ -100,7 +101,9 @@ class ConfigSetCommand(
                 ed.set_value(key, pyval)
             except ProtectedGlobalConfigError:
                 cfg.logger.F(
-                    f"the config [yellow]{key}[/] is protected and not meant to be overridden by users",
+                    _(
+                        "the config [yellow]{key}[/] is protected and not meant to be overridden by users"
+                    ).format(key=key)
                 )
                 return 2
 
@@ -112,7 +115,7 @@ class ConfigSetCommand(
 class ConfigUnsetCommand(
     ConfigCommand,
     cmd="unset",
-    help="Unset a Ruyi config option",
+    help=_("Unset a Ruyi config option"),
 ):
     @classmethod
     def configure_args(
@@ -123,7 +126,7 @@ class ConfigUnsetCommand(
         p.add_argument(
             "key",
             type=str,
-            help="The Ruyi config option to unset",
+            help=_("The Ruyi config option to unset"),
         )
 
     @classmethod
@@ -142,7 +145,7 @@ class ConfigUnsetCommand(
 class ConfigRemoveSectionCommand(
     ConfigCommand,
     cmd="remove-section",
-    help="Remove a section from the Ruyi config",
+    help=_("Remove a section from the Ruyi config"),
 ):
     @classmethod
     def configure_args(
@@ -153,7 +156,7 @@ class ConfigRemoveSectionCommand(
         p.add_argument(
             "section",
             type=str,
-            help="The section to remove",
+            help=_("The section to remove"),
         )
 
     @classmethod

{ruyi-0.44.0a20251118 → ruyi-0.45.0}/ruyi/cli/main.py

@@ -4,6 +4,7 @@ import sys
 from typing import Final, TYPE_CHECKING
 
 from ..config import GlobalConfig
+from ..i18n import _
 from ..telemetry.scope import TelemetryScope
 from ..utils.global_mode import GlobalModeProvider
 from ..version import RUYI_SEMVER
@@ -39,32 +40,40 @@ def main(gm: GlobalModeProvider, gc: GlobalConfig, argv: list[str]) -> int:
     if not gm.is_cli_autocomplete:
         oobe = OOBE(gc)
 
-        if tm := gc.telemetry:
-            tm.check_first_run_status()
-            tm.init_installation(False)
-            atexit.register(tm.flush)
-            oobe.handlers.append(tm.oobe_prompt)
+        tm = gc.telemetry
+        tm.check_first_run_status()
+        tm.init_installation(False)
+        atexit.register(tm.flush)
+        oobe.handlers.append(tm.oobe_prompt)
 
         oobe.maybe_prompt()
 
     if not is_called_as_ruyi(gm.argv0):
         if should_prompt_for_renaming(gm.argv0):
             logger.F(
-                f"the {RUYI_ENTRYPOINT_NAME} executable must be named [green]'{RUYI_ENTRYPOINT_NAME}'[/] to work"
+                _(
+                    "the {ruyi_exe} executable must be named [green]'{expected_name}'[/] to work"
+                ).format(
+                    ruyi_exe=RUYI_ENTRYPOINT_NAME,
+                    expected_name=RUYI_ENTRYPOINT_NAME,
+                )
             )
-            logger.I(f"it is now [yellow]'{gm.argv0}'[/]")
-            logger.I("please rename the command file and retry")
+            logger.I(
+                _("it is now [yellow]'{current_name}'[/]").format(
+                    current_name=gm.argv0,
+                )
+            )
+            logger.I(_("please rename the command file and retry"))
             return 1
 
         from ..mux.runtime import mux_main
 
         # record an invocation and the command name being proxied to
-        if tm := gc.telemetry:
-            tm.record(
-                TelemetryScope(None),
-                "cli:mux-invocation-v1",
-                target=os.path.basename(gm.argv0),
-            )
+        gc.telemetry.record(
+            TelemetryScope(None),
+            "cli:mux-invocation-v1",
+            target=os.path.basename(gm.argv0),
+        )
 
         return mux_main(gm, gc, argv)
 
@@ -116,7 +125,7 @@ def main(gm: GlobalModeProvider, gc: GlobalConfig, argv: list[str]) -> int:
     try:
         telemetry_key: str = args.tele_key
     except AttributeError:
-        logger.F("internal error: CLI entrypoint was added without a telemetry key")
+        logger.F(_("internal error: CLI entrypoint was added without a telemetry key"))
         return 1
 
     # Special-case the `--output-completion-script` argument; treat it as if
@@ -127,8 +136,16 @@ def main(gm: GlobalModeProvider, gc: GlobalConfig, argv: list[str]) -> int:
     except AttributeError:
         pass
 
-    if tm := gc.telemetry:
-        tm.print_telemetry_notice()
+    tm = gc.telemetry
+    tm.print_telemetry_notice()
+
+    # Do not record `ruyi telemetry --cron-upload` invocations.
+    skip_recording_invocation = telemetry_key == "telemetry" and getattr(
+        args,
+        "cron_upload",
+        False,
+    )
+    if not skip_recording_invocation:
         tm.record(
             TelemetryScope(None),
             "cli:invocation-v1",

{ruyi-0.44.0a20251118 → ruyi-0.45.0}/ruyi/cli/oobe.py

@@ -2,13 +2,16 @@
 
 import os
 import sys
-from typing import Callable, TYPE_CHECKING
+from typing import Callable, Final, TYPE_CHECKING
+
+from ..i18n import _, d_
 
 if TYPE_CHECKING:
     from ..config import GlobalConfig
 
 
-SHELL_AUTO_COMPLETION_TIP = """
+SHELL_AUTO_COMPLETION_TIP: Final = d_(
+    """
 [bold green]tip[/]: you can enable shell auto-completion for [yellow]ruyi[/] by adding the
 following line to your [green]{shrc}[/], if you have not done so already:
 
@@ -18,6 +21,7 @@ You can do so by running the following command later:
 
     [green]echo 'eval "$(ruyi --output-completion-script={shell})"' >> {shrc}[/]
 """
+)
 
 
 class OOBE:
@@ -30,13 +34,9 @@ class OOBE:
         ]
 
     def is_first_run(self) -> bool:
-        if tm := self._gc.telemetry:
-            return tm.is_first_run
-        # cannot reliably determine first run status without telemetry
-        # we may revisit this later if it turns out users want OOBE tips even
-        # if they know how to disable telemetry (hence more likely to be power
-        # users)
-        return False
+        # We now always have our first-run indicator because of the minimal
+        # telemetry mode.
+        return self._gc.telemetry.is_first_run
 
     def should_prompt(self) -> bool:
         from ..utils.global_mode import is_env_var_truthy
@@ -78,7 +78,7 @@ class OOBE:
             return
 
         self._gc.logger.stdout(
-            SHELL_AUTO_COMPLETION_TIP.format(
+            _(SHELL_AUTO_COMPLETION_TIP).format(
                 shell=shell,
                 shrc=f"~/.{shell}rc",
             )

{ruyi-0.44.0a20251118 → ruyi-0.45.0}/ruyi/cli/self_cli.py

@@ -4,13 +4,16 @@ import pathlib
 import shutil
 from typing import Final, TYPE_CHECKING
 
+from ..i18n import _, d_
 from .cmd import RootCommand
 
 if TYPE_CHECKING:
     from .completion import ArgumentParser
     from .. import config
 
-UNINSTALL_NOTICE: Final = """
+
+UNINSTALL_NOTICE: Final = d_(
+    """
 [bold]Thanks for hacking with [yellow]Ruyi[/]![/]
 
 This will uninstall [yellow]Ruyi[/] from your system, and optionally remove
@@ -21,6 +24,7 @@ Note that your [yellow]Ruyi[/] virtual environments [bold]will become unusable[/
 [yellow]Ruyi[/] is uninstalled. You should take care of migrating or cleaning
 them yourselves afterwards.
 """
+)
 
 
 # Self-management commands
@@ -28,7 +32,7 @@ class SelfCommand(
     RootCommand,
     cmd="self",
     has_subcommands=True,
-    help="Manage this Ruyi installation",
+    help=_("Manage this Ruyi installation"),
 ):
     @classmethod
     def configure_args(
@@ -42,7 +46,7 @@ class SelfCommand(
 class SelfCleanCommand(
     SelfCommand,
     cmd="clean",
-    help="Remove various Ruyi-managed data to reclaim storage",
+    help=_("Remove various Ruyi-managed data to reclaim storage"),
 ):
     @classmethod
     def configure_args(
@@ -54,42 +58,42 @@ class SelfCleanCommand(
             "--quiet",
             "-q",
             action="store_true",
-            help="Do not print out the actions being performed",
+            help=_("Do not print out the actions being performed"),
         )
         p.add_argument(
             "--all",
             action="store_true",
-            help="Remove all covered data",
+            help=_("Remove all covered data"),
         )
         p.add_argument(
             "--distfiles",
             action="store_true",
-            help="Remove all downloaded distfiles if any",
+            help=_("Remove all downloaded distfiles if any"),
         )
         p.add_argument(
             "--installed-pkgs",
             action="store_true",
-            help="Remove all installed packages if any",
+            help=_("Remove all installed packages if any"),
         )
         p.add_argument(
             "--news-read-status",
             action="store_true",
-            help="Mark all news items as unread",
+            help=_("Mark all news items as unread"),
         )
         p.add_argument(
             "--progcache",
             action="store_true",
-            help="Clear the Ruyi program cache",
+            help=_("Clear the Ruyi program cache"),
         )
         p.add_argument(
             "--repo",
             action="store_true",
-            help="Remove the Ruyi repo if located in Ruyi-managed cache directory",
+            help=_("Remove the Ruyi repo if located in Ruyi-managed cache directory"),
         )
         p.add_argument(
             "--telemetry",
             action="store_true",
-            help="Remove all telemetry data recorded if any",
+            help=_("Remove all telemetry data recorded if any"),
         )
 
     @classmethod
@@ -122,9 +126,11 @@ class SelfCleanCommand(
                 telemetry,
             ]
         ):
-            logger.F("no data specified for cleaning")
+            logger.F(_("no data specified for cleaning"))
             logger.I(
-                "please check [yellow]ruyi self clean --help[/] for a list of cleanable data"
+                _(
+                    "please check [yellow]ruyi self clean --help[/] for a list of cleanable data"
+                )
             )
             return 1
 
@@ -149,7 +155,7 @@ class SelfCleanCommand(
 class SelfUninstallCommand(
     SelfCommand,
     cmd="uninstall",
-    help="Uninstall Ruyi",
+    help=_("Uninstall Ruyi"),
 ):
     @classmethod
     def configure_args(
@@ -160,13 +166,15 @@ class SelfUninstallCommand(
         p.add_argument(
             "--purge",
             action="store_true",
-            help="Remove all installed packages and Ruyi-managed remote repo data",
+            help=_("Remove all installed packages and Ruyi-managed remote repo data"),
         )
         p.add_argument(
             "-y",
             action="store_true",
             dest="consent",
-            help="Give consent for uninstallation on CLI; do not ask for confirmation",
+            help=_(
+                "Give consent for uninstallation on CLI; do not ask for confirmation"
+            ),
         )
 
     @classmethod
@@ -180,24 +188,28 @@ class SelfUninstallCommand(
 
         if cfg.is_installation_externally_managed:
             logger.F(
-                "this [yellow]ruyi[/] is externally managed, for example, by the system package manager, and cannot be uninstalled this way"
+                _(
+                    "this [yellow]ruyi[/] is externally managed, for example, by the system package manager, and cannot be uninstalled this way"
+                )
             )
-            logger.I("please uninstall via the external manager instead")
+            logger.I(_("please uninstall via the external manager instead"))
             return 1
 
         if not cfg.is_packaged:
             logger.F(
-                "this [yellow]ruyi[/] is not in standalone form, and cannot be uninstalled this way"
+                _(
+                    "this [yellow]ruyi[/] is not in standalone form, and cannot be uninstalled this way"
+                )
             )
             return 1
 
         if not consent:
-            logger.stdout(UNINSTALL_NOTICE)
-            if not user_input.ask_for_yesno_confirmation(logger, "Continue?"):
-                logger.I("aborting uninstallation")
+            logger.stdout(_(UNINSTALL_NOTICE))
+            if not user_input.ask_for_yesno_confirmation(logger, _("Continue?")):
+                logger.I(_("aborting uninstallation"))
                 return 0
         else:
-            logger.I("uninstallation consent given over CLI, proceeding")
+            logger.I(_("uninstallation consent given over CLI, proceeding"))
 
         _do_reset(
             cfg,
@@ -208,7 +220,7 @@ class SelfUninstallCommand(
             self_binary=True,
         )
 
-        logger.I("[yellow]ruyi[/] is uninstalled")
+        logger.I(_("[yellow]ruyi[/] is uninstalled"))
 
         return 0
 
@@ -235,38 +247,37 @@ def _do_reset(
         logger.I(s)
 
     if installed_pkgs:
-        status("removing installed packages")
+        status(_("removing installed packages"))
         shutil.rmtree(cfg.data_root, True)
         cfg.ruyipkg_global_state.purge_installation_info()
 
     # do not record any telemetry data if we're purging it
     if all_state or telemetry:
-        if tm := cfg.telemetry:
-            tm.discard_events(True)
+        cfg.telemetry.discard_events(True)
 
     if all_state:
-        status("removing state data")
+        status(_("removing state data"))
         shutil.rmtree(cfg.state_root, True)
     else:
         if news_read_status:
-            status("removing read status of news items")
+            status(_("removing read status of news items"))
             cfg.news_read_status.remove()
 
         if telemetry:
-            status("removing all telemetry data")
+            status(_("removing all telemetry data"))
             shutil.rmtree(cfg.telemetry_root, True)
 
     if all_cache:
-        status("removing cached data")
+        status(_("removing cached data"))
         shutil.rmtree(cfg.cache_root, True)
     else:
         if distfiles:
-            status("removing downloaded distfiles")
+            status(_("removing downloaded distfiles"))
             # TODO: deduplicate the path derivation
             shutil.rmtree(os.path.join(cfg.cache_root, "distfiles"), True)
 
         if progcache:
-            status("clearing the Ruyi program cache")
+            status(_("clearing the Ruyi program cache"))
             # TODO: deduplicate the path derivation
             shutil.rmtree(os.path.join(cfg.cache_root, "progcache"), True)
 
@@ -284,14 +295,16 @@ def _do_reset(
 
             if not repo_is_below_cache_root:
                 logger.W(
-                    "not removing the Ruyi repo: it is outside of the Ruyi cache directory"
+                    _(
+                        "not removing the Ruyi repo: it is outside of the Ruyi cache directory"
+                    )
                 )
             else:
-                status("removing the Ruyi repo")
+                status(_("removing the Ruyi repo"))
                 shutil.rmtree(repo_dir, True)
 
     if self_binary:
-        status("removing the ruyi binary")
+        status(_("removing the ruyi binary"))
         try:
             os.unlink(cfg.self_exe)
         except FileNotFoundError: