ruyi 0.41.0b20250926__py3-none-any.whl → 0.42.0__py3-none-any.whl

ruyi/ruyipkg/unpack.py

@@ -2,7 +2,7 @@ import mmap
 import os
 import shutil
 import subprocess
-from typing import BinaryIO, NoReturn, Protocol
+from typing import Any, BinaryIO, NoReturn, Protocol
 
 from ..log import RuyiLogger
 from ..utils import ar, prereqs
@@ -20,7 +20,7 @@ class SupportsRead(Protocol):
 def do_unpack(
     logger: RuyiLogger,
     filename: str,
-    dest: str | None,
+    dest: str | os.PathLike[Any] | None,
     strip_components: int,
     unpack_method: UnpackMethod,
     stream: BinaryIO | SupportsRead | None = None,
@@ -77,7 +77,7 @@ def do_unpack(
 def do_unpack_or_symlink(
     logger: RuyiLogger,
     filename: str,
-    dest: str | None,
+    dest: str | os.PathLike[Any] | None,
     strip_components: int,
     unpack_method: UnpackMethod,
     stream: BinaryIO | SupportsRead | None = None,
@@ -100,7 +100,7 @@ def do_unpack_or_symlink(
 
 def _do_copy_raw(
     src_path: str,
-    destdir: str | None,
+    destdir: str | os.PathLike[Any] | None,
 ) -> None:
     src_filename = os.path.basename(src_path)
     if destdir is None:
@@ -114,7 +114,7 @@ def _do_copy_raw(
 
 def do_symlink(
     src_path: str,
-    destdir: str | None,
+    destdir: str | os.PathLike[Any] | None,
 ) -> None:
     src_filename = os.path.basename(src_path)
     if destdir is None:
@@ -132,7 +132,7 @@ def do_symlink(
 def _do_unpack_tar(
     logger: RuyiLogger,
     filename: str,
-    dest: str | None,
+    dest: str | os.PathLike[Any] | None,
     strip_components: int,
     unpack_method: UnpackMethod,
     stream: SupportsRead | None,
@@ -164,8 +164,6 @@ def _do_unpack_tar(
         stdin = subprocess.PIPE
 
     argv.extend(("-f", filename, f"--strip-components={strip_components}"))
-    if dest is not None:
-        argv.extend(("-C", dest))
     if prefixes_to_unpack:
         if any(p.startswith("-") for p in prefixes_to_unpack):
             raise ValueError(
@@ -200,11 +198,11 @@ def _do_unpack_tar(
 def _do_unpack_zip(
     logger: RuyiLogger,
     filename: str,
-    dest: str | None,
+    dest: str | os.PathLike[Any] | None,
 ) -> None:
     argv = ["unzip", filename]
     if dest is not None:
-        argv.extend(("-d", dest))
+        argv.extend(("-d", str(dest)))
     logger.D(f"about to call unzip: argv={argv}")
     retcode = subprocess.call(argv, cwd=dest)
     if retcode != 0:
@@ -214,7 +212,7 @@ def _do_unpack_zip(
 def _do_unpack_bare_gz(
     logger: RuyiLogger,
     filename: str,
-    destdir: str | None,
+    destdir: str | os.PathLike[Any] | None,
 ) -> None:
     # the suffix may not be ".gz" so do this generically
     dest_filename = os.path.splitext(os.path.basename(filename))[0]
@@ -235,7 +233,7 @@ def _do_unpack_bare_gz(
 def _do_unpack_bare_bzip2(
     logger: RuyiLogger,
     filename: str,
-    destdir: str | None,
+    destdir: str | os.PathLike[Any] | None,
 ) -> None:
     # the suffix may not be ".bz2" so do this generically
     dest_filename = os.path.splitext(os.path.basename(filename))[0]
@@ -256,7 +254,7 @@ def _do_unpack_bare_bzip2(
 def _do_unpack_bare_lz4(
     logger: RuyiLogger,
     filename: str,
-    destdir: str | None,
+    destdir: str | os.PathLike[Any] | None,
 ) -> None:
     # the suffix may not be ".lz4" so do this generically
     dest_filename = os.path.splitext(os.path.basename(filename))[0]
@@ -271,7 +269,7 @@ def _do_unpack_bare_lz4(
 def _do_unpack_bare_xz(
     logger: RuyiLogger,
     filename: str,
-    destdir: str | None,
+    destdir: str | os.PathLike[Any] | None,
 ) -> None:
     # the suffix may not be ".xz" so do this generically
     dest_filename = os.path.splitext(os.path.basename(filename))[0]
@@ -292,7 +290,7 @@ def _do_unpack_bare_xz(
 def _do_unpack_bare_zstd(
     logger: RuyiLogger,
     filename: str,
-    destdir: str | None,
+    destdir: str | os.PathLike[Any] | None,
 ) -> None:
     # the suffix may not be ".zst" so do this generically
     dest_filename = os.path.splitext(os.path.basename(filename))[0]
@@ -307,7 +305,7 @@ def _do_unpack_bare_zstd(
 def _do_unpack_deb(
     logger: RuyiLogger,
     filename: str,
-    destdir: str | None,
+    destdir: str | os.PathLike[Any] | None,
 ) -> None:
     with ar.ArpyArchiveWrapper(filename) as a:
         for f in a.infolist():

ruyi/telemetry/provider.py

@@ -18,19 +18,23 @@ if TYPE_CHECKING:
 
 FALLBACK_PM_TELEMETRY_ENDPOINT = "https://api.ruyisdk.cn/telemetry/pm/"
 
-TELEMETRY_INITIAL_UPLOAD_PROMPT = """
-By default, the RuyiSDK team collects anonymous usage data to help us improve
-the product. No personal information or detail about your project is ever
-collected. The data will be uploaded to RuyiSDK team-managed servers located
-in the Chinese mainland if you agree to the uploading. You can change this
-setting at any time by running [yellow]ruyi telemetry consent[/] or
-[yellow]ruyi telemetry optout[/].
-
-We would like to ask if you agree to have basic information about this [yellow]ruyi[/]
-installation uploaded, right now, for one time. This will allow the RuyiSDK team
-to have more precise knowledge about the product's adoption. Thank you for
-your support!
+TELEMETRY_CONSENT_AND_UPLOAD_DESC = """
+RuyiSDK collects anonymized usage data locally to help us improve the product.
+
+[green]By default, nothing leaves your machine[/], and you can also turn off usage data
+collection completely. Only with your explicit permission can [yellow]ruyi[/] upload
+collected telemetry, periodically to RuyiSDK team-managed servers located in
+the Chinese mainland. You can change this setting at any time by running
+[yellow]ruyi telemetry consent[/], [yellow]ruyi telemetry local[/], or [yellow]ruyi telemetry optout[/].
+
+If you enable uploads now, we'll also send a one-time report from this [yellow]ruyi[/]
+installation so the RuyiSDK team can better understand adoption. Thank you for
+helping us build a better experience!
 """
+TELEMETRY_CONSENT_AND_UPLOAD_PROMPT = (
+    "Enable telemetry uploads and send a one-time report now?"
+)
+TELEMETRY_OPTOUT_PROMPT = "\nDo you want to disable telemetry entirely?"
 
 
 def next_utc_weekday(wday: int, now: float | None = None) -> int:
@@ -66,12 +70,17 @@ def set_telemetry_mode(
 
     logger = gc.logger
 
+    if mode == "on":
+        if consent_time is None:
+            consent_time = datetime.datetime.now().astimezone()
+    else:
+        # clear any previously recorded consent time
+        consent_time = None
+
+    # First, persist the changes to user config
     with ConfigEditor.work_on_user_local_config(gc) as ed:
         ed.set_value((schema.SECTION_TELEMETRY, schema.KEY_TELEMETRY_MODE), mode)
-
-        if mode == "on":
-            if consent_time is None:
-                consent_time = datetime.datetime.now().astimezone()
+        if consent_time is not None:
             ed.set_value(
                 (schema.SECTION_TELEMETRY, schema.KEY_TELEMETRY_UPLOAD_CONSENT),
                 consent_time,
@@ -83,6 +92,18 @@ def set_telemetry_mode(
 
         ed.stage()
 
+    # Then, apply the changes to the running instance's GlobalConfig
+    # TelemetryProvider instance (if any) will pick them up automatically
+    # because the properties are backed by GlobalConfig.
+    gc.set_by_key(
+        (schema.SECTION_TELEMETRY, schema.KEY_TELEMETRY_MODE),
+        mode,
+    )
+    gc.set_by_key(
+        (schema.SECTION_TELEMETRY, schema.KEY_TELEMETRY_UPLOAD_CONSENT),
+        consent_time,
+    )
+
     if not show_cli_feedback:
         return
     match mode:
@@ -111,8 +132,6 @@ def set_telemetry_mode(
 class TelemetryProvider:
     def __init__(self, gc: "GlobalConfig") -> None:
         self.state_root = pathlib.Path(gc.telemetry_root)
-        self.local_mode = gc.telemetry_mode == "local"
-        self.upload_consent_time = gc.telemetry_upload_consent_time
 
         self._discard_events = False
         self._gc = gc
@@ -129,6 +148,14 @@ class TelemetryProvider:
     def logger(self) -> RuyiLogger:
         return self._gc.logger
 
+    @property
+    def local_mode(self) -> bool:
+        return self._gc.telemetry_mode == "local"
+
+    @property
+    def upload_consent_time(self) -> datetime.datetime | None:
+        return self._gc.telemetry_upload_consent_time
+
     def store(self, scope: TelemetryScope) -> TelemetryStore | None:
         return self._stores.get(scope)
 
@@ -386,16 +413,32 @@ class TelemetryProvider:
         return store.upload_staged_payloads()
 
     def oobe_prompt(self) -> None:
-        """Ask whether the user consents to a first-run telemetry upload."""
+        """Ask whether the user consents to a first-run telemetry upload, and
+        persist the user's exact telemetry choice."""
 
         from ..cli import user_input
 
-        self.logger.stdout(TELEMETRY_INITIAL_UPLOAD_PROMPT)
+        self.logger.stdout(TELEMETRY_CONSENT_AND_UPLOAD_DESC)
         if not user_input.ask_for_yesno_confirmation(
             self.logger,
-            "Do you agree?",
-            True,
+            TELEMETRY_CONSENT_AND_UPLOAD_PROMPT,
+            False,
         ):
+            # ask if the user wants to opt out entirely
+            if user_input.ask_for_yesno_confirmation(
+                self.logger,
+                TELEMETRY_OPTOUT_PROMPT,
+                False,
+            ):
+                set_telemetry_mode(self._gc, "off")
+                return
+
+            # user wants to stay in local mode
+            # explicitly record the preference, so we don't have to worry about
+            # us potentially changing defaults yet another time
+            set_telemetry_mode(self._gc, "local")
             return
 
+        consent_time = datetime.datetime.now().astimezone()
+        set_telemetry_mode(self._gc, "on", consent_time)
         self._upload_on_exit = True

ruyi/telemetry/store.py

@@ -165,7 +165,7 @@ class TelemetryStore:
         payload: UploadPayload = {
             "fmt": 1,
             "nonce": payload_nonce,
-            "ruyi_version": str(RUYI_SEMVER),
+            "ruyi_version": RUYI_SEMVER,
             "events": aggregate_data,
         }
         if installation_data is not None:

ruyi/utils/git.py

@@ -119,13 +119,15 @@ def pull_ff_or_die(
             logger.I(f"repository:          [yellow]{repo_path}[/]")
             logger.I(f"expected remote URL: [yellow]{remote_url}[/]")
             logger.I(f"actual remote URL:   [yellow]{remote.url}[/]")
-            logger.I("please fix the repo settings manually")
+            logger.I("please [bold red]fix the repo settings manually[/]")
             raise SystemExit(1)
 
         logger.D(
             f"updating url of remote {remote_name} from {remote.url} to {remote_url}"
         )
-        repo.remotes.set_url("origin", remote_url)
+        repo.remotes.set_url(remote_name, remote_url)
+        # this needs manual refreshing
+        remote = repo.remotes[remote_name]
 
     logger.D("fetching")
     try:

ruyi/utils/global_mode.py

@@ -128,6 +128,24 @@ def _guess_porcelain_from_argv(argv: list[str]) -> bool:
     return len(argv) > 1 and argv[1] == "--porcelain"
 
 
+def _probe_cli_autocomplete(env: Mapping[str, str], argv: list[str]) -> bool:
+    """
+    Probe if the current invocation is related to shell completion based on
+    the arguments passed, without requiring the ``argparse`` machinery to be
+    completely initialized, and the environment.
+    """
+
+    # If `--output-completion-script` is present anywhere in the arguments,
+    # then this is related to shell completion even if _ARGCOMPLETE is not yet
+    # set (which is only set for invocations after the shell finished sourcing
+    # the completion script).
+    for arg in argv:
+        if arg.startswith("--output-completion-script"):
+            return True
+
+    return "_ARGCOMPLETE" in os.environ
+
+
 class EnvGlobalModeProvider(GlobalModeProvider):
     def __init__(
         self,
@@ -150,7 +168,7 @@ class EnvGlobalModeProvider(GlobalModeProvider):
 
         # We have to lift this piece of implementation detail out of argcomplete,
         # as the argcomplete import is very costly in terms of startup time.
-        self._is_cli_autocomplete = "_ARGCOMPLETE" in os.environ
+        self._is_cli_autocomplete = _probe_cli_autocomplete(env, argv)
 
         self._venv_root = env.get(ENV_VENV_ROOT_KEY)
 

ruyi/utils/toml.py

@@ -7,6 +7,17 @@ from tomlkit.container import Container
 from tomlkit.items import Array, Comment, InlineTable, Item, Table, Trivia, Whitespace
 
 
+class NoneValue(Exception):
+    """Used to indicate that a None value is to be dumped in TOML. Because TOML
+    does not support None natively, this means special handling is needed."""
+
+    def __str__(self) -> str:
+        return "NoneValue()"
+
+    def __repr__(self) -> str:
+        return "NoneValue()"
+
+
 def with_indent(item: Item, spaces: int = 2) -> Item:
     item.indent(spaces)
     return item

ruyi/utils/xdg_basedir.py

@@ -4,7 +4,12 @@
 
 import os
 import pathlib
-from typing import Iterable
+from typing import Iterable, NamedTuple
+
+
+class XDGPathEntry(NamedTuple):
+    path: pathlib.Path
+    is_global: bool
 
 
 def _paths_from_env(env: str, default: str) -> Iterable[pathlib.Path]:
@@ -38,14 +43,16 @@ class XDGBaseDir:
         return pathlib.Path(v) if v else pathlib.Path.home() / ".local" / "state"
 
     @property
-    def config_dirs(self) -> Iterable[pathlib.Path]:
+    def config_dirs(self) -> Iterable[XDGPathEntry]:
         # from highest precedence to lowest
-        yield from _paths_from_env("XDG_CONFIG_DIRS", "/etc/xdg")
+        for p in _paths_from_env("XDG_CONFIG_DIRS", "/etc/xdg"):
+            yield XDGPathEntry(p, True)
 
     @property
-    def data_dirs(self) -> Iterable[pathlib.Path]:
+    def data_dirs(self) -> Iterable[XDGPathEntry]:
         # from highest precedence to lowest
-        yield from _paths_from_env("XDG_DATA_DIRS", "/usr/local/share/:/usr/share/")
+        for p in _paths_from_env("XDG_DATA_DIRS", "/usr/local/share/:/usr/share/"):
+            yield XDGPathEntry(p, True)
 
     # derived info
 
@@ -66,15 +73,15 @@ class XDGBaseDir:
         return self.state_home / self.app_name
 
     @property
-    def app_config_dirs(self) -> Iterable[pathlib.Path]:
+    def app_config_dirs(self) -> Iterable[XDGPathEntry]:
         # from highest precedence to lowest
-        yield self.app_config
-        for p in self.config_dirs:
-            yield p / self.app_name
+        yield XDGPathEntry(self.app_config, False)
+        for e in self.config_dirs:
+            yield XDGPathEntry(e.path / self.app_name, e.is_global)
 
     @property
-    def app_data_dirs(self) -> Iterable[pathlib.Path]:
+    def app_data_dirs(self) -> Iterable[XDGPathEntry]:
         # from highest precedence to lowest
-        yield self.app_data
-        for p in self.data_dirs:
-            yield p / self.app_name
+        yield XDGPathEntry(self.app_data, False)
+        for e in self.data_dirs:
+            yield XDGPathEntry(e.path / self.app_name, e.is_global)

ruyi/version.py

@@ -1,53 +1,6 @@
-import importlib.metadata
-from typing import Final, TYPE_CHECKING
+from typing import Final
 
-import packaging.version
-
-if TYPE_CHECKING:
-    # pyright only works with semver 3.x
-    from semver.version import Version
-else:
-    try:
-        from semver.version import Version  # type: ignore[import-untyped,unused-ignore]
-    except ModuleNotFoundError:
-        # semver 2.x
-        from semver import VersionInfo as Version  # type: ignore[import-untyped,unused-ignore]
-
-# NOTE: one cannot print logs in the version helpers, because the version info
-# is initialized so early (before argparse can look at argv because --version
-# requires version info to be ready) that the porcelain status is not yet
-# available.
-
-_PYPI_PRERELEASE_KINDS_MAP: Final = {
-    "a": "alpha",
-    "b": "beta",
-    "rc": "rc",
-}
-
-
-# based on https://python-semver.readthedocs.io/en/3.0.2/advanced/convert-pypi-to-semver.html
-def _convert2semver(ver: packaging.version.Version) -> Version:
-    if ver.epoch:
-        raise ValueError("Can't convert an epoch to semver")
-    if ver.post:
-        raise ValueError("Can't convert a post part to semver")
-
-    pre: str | None = None
-    if ver.pre:
-        kind, val = ver.pre
-        pre = f"{_PYPI_PRERELEASE_KINDS_MAP.get(kind, kind)}.{val}"
-
-    maj, min, pat = ver.release[:3]
-    return Version(maj, min, pat, prerelease=pre, build=ver.dev)
-
-
-def _init_pkg_semver() -> Version:
-    pkg_pypi_ver = packaging.version.Version(importlib.metadata.version("ruyi"))
-    # log.D(f"PyPI-style version of ruyi: {pkg_pypi_ver}")
-    return _convert2semver(pkg_pypi_ver)
-
-
-RUYI_SEMVER: Final = _init_pkg_semver()
+RUYI_SEMVER: Final = "0.42.0"
 RUYI_USER_AGENT: Final = f"ruyi/{RUYI_SEMVER}"
 
 COPYRIGHT_NOTICE: Final = """\

{ruyi-0.41.0b20250926.dist-info → ruyi-0.42.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ruyi
-Version: 0.41.0b20250926
+Version: 0.42.0
 Summary: Package manager for RuyiSDK
 License: Apache License
                                     Version 2.0, January 2004
@@ -221,7 +221,7 @@ Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Software Development :: Embedded Systems
 Classifier: Topic :: System :: Software Distribution
 Classifier: Typing :: Typed
-Requires-Dist: argcomplete (>=2.0.0,<4.0.0)
+Requires-Dist: argcomplete (>=2.0.0)
 Requires-Dist: arpy
 Requires-Dist: fastjsonschema (>=2.15.1)
 Requires-Dist: jinja2 (>=3,<4)
@@ -332,6 +332,10 @@ Various aspects of `ruyi` can be configured with files or environment variables.
 look up its config accordingly. If these are not explicitly set though, as in
 typical use cases, the default config directory is most likely `~/.config/ruyi`.
 
+GNU/Linux distribution packagers and system administrators will find that the
+directories `/usr/share/ruyi` and `/usr/local/share/ruyi` are searched for the
+config file on such systems.
+
 ### Config file
 
 Currently `ruyi` will look for an optional `config.toml` in its XDG config
@@ -361,9 +365,8 @@ branch = "main"
 # details.
 #
 # If unset or empty, this default value is used: data will be collected and
-# uploaded every week, on a random weekday determined by the installation's
-# anonymous ID alone.
-mode = "on"
+# stored locally; nothing will be uploaded automatically.
+mode = "local"
 # The time the user's consent is given to telemetry data uploading. If the
 # system time is later than the time given here, telemetry consent banner will
 # not be displayed any more each time `ruyi` is executed. The exact consent
@@ -407,12 +410,16 @@ There are 3 telemetry modes available:
 * `off`: data will not be collected nor uploaded.
 * `on`: data will be collected and periodically uploaded.
 
-By default the `on` mode is active, which means every `ruyi` invocation
-will record some non-sensitive information locally alongside various other
-states of `ruyi`, and collected data will be periodically uploaded to servers
-managed by the RuyiSDK team in the People's Republic of China, in a weekly fashion.
-The upload will happen on a random weekday which is determined by the
-installation's anonymous ID alone.
+By default the `local` mode is active from `ruyi` 0.42.0 (inclusive) on, which
+means every `ruyi` invocation will record some non-sensitive information locally
+alongside various other states of `ruyi`, but collected data will not be
+uploaded automatically unless you explicitly request so (for example by
+switching to the `on` mode, or by executing `ruyi telemetry upload`).
+
+In case the `on` mode is active, collected data will be periodically uploaded
+to servers managed by the RuyiSDK team in the People's Republic of China, in a
+weekly fashion. The upload will happen on a random weekday which is determined
+by the installation's anonymous ID alone.
 
 You can change the telemetry mode by editing `ruyi`'s config file, or simply
 disable telemetry altogether by setting the `RUYI_TELEMETRY_OPTOUT` environment

{ruyi-0.41.0b20250926.dist-info → ruyi-0.42.0.dist-info}/RECORD

@@ -5,19 +5,19 @@ ruyi/cli/builtin_commands.py,sha256=cYyPSF00DSBH1WMv6mHcMygbFRBGXObMWhbXHs5K1Mc,
 ruyi/cli/cmd.py,sha256=kR3aEiDE3AfPoP0Zr7MO-09CKoExbkLLmPvve9oKaUg,6725
 ruyi/cli/completer.py,sha256=cnOkU7veDe-jP8ROXZL2uBop2HgWfaAZl6dromnPLx8,1426
 ruyi/cli/completion.py,sha256=ffLs3Dv7pY_uinwH98wkBPohRvAjpUOGqy01OTA_Bgo,841
-ruyi/cli/config_cli.py,sha256=IMsUEs1iiFCvGLdGAVByMxwjNiP4IMZammkUMs0nFio,3497
-ruyi/cli/main.py,sha256=3_0ZPrQh5LJSe73UM4zP6FYw8NCG5ayT2sWf-6xUqL8,3382
-ruyi/cli/oobe.py,sha256=fpzNukwpT16CSqAobClC615Fii7GFDYc5g5ArZMur1A,2463
-ruyi/cli/self_cli.py,sha256=opDHVpvgg0AgZdzi7kEY73_jwV6LRjtIpdgsFkRL1hI,8668
+ruyi/cli/config_cli.py,sha256=9kq5W3Ir_lfwImhvrUmQ1KTKy1aRCv_UU1CmL5eGyJs,4038
+ruyi/cli/main.py,sha256=qWgCKbWG8sHxM7rInkoQfzZOHKo2k8JwdgJp_AMH388,4455
+ruyi/cli/oobe.py,sha256=3m7oLPBhzn5JgagwQYDPy8vhZ4v8mBiDlO5n4cR_jVA,2712
+ruyi/cli/self_cli.py,sha256=UEX3Xjy8RGGn9W2O5cM-5rLCwpsM7uSQ9vYYBYxyjyQ,8837
 ruyi/cli/user_input.py,sha256=ZJPyCAD7Aizkt37f_KDtW683aKvGZ2pL85Rg_y1LLfg,3711
 ruyi/cli/version_cli.py,sha256=L2pejZ7LIPYLUTb9NIz4t51KB8ai8igPBuE64tyqUuI,1275
-ruyi/config/__init__.py,sha256=VqHcXAt82bDJPsLnZKzzL-d-tNbe5X4SnLKlx9WdfRw,13501
-ruyi/config/editor.py,sha256=6b4VpViEPvfPHtEyrQHAjeFpJOT8-mfTla6dXbKf--g,3148
-ruyi/config/errors.py,sha256=EO-ezHgtkWoiH0jOjkkw3MgiTAHHLhppks6F9-p2i6I,2162
+ruyi/config/__init__.py,sha256=9w1dtgvNxIW65eWzhRN4gl5-460hv-GipIoRZ_oqfXc,16859
+ruyi/config/editor.py,sha256=piAJ-a68iX6IFWXy1g9OXoSs_3DardZwoaSPdStKKL0,4243
+ruyi/config/errors.py,sha256=Yrzd3hX5Gb_bCawoVrWjFrLrpO-q_IOtg4ikE0P8ia0,2561
 ruyi/config/news.py,sha256=83LjQjJHsqOPdRrytG7VBFubG6pyDwJ-Mg37gpBRU20,1061
-ruyi/config/schema.py,sha256=j-oXLl5qeoaWNONxSzAfuaBM6be9m1Xjliez2FUEpjg,5862
+ruyi/config/schema.py,sha256=u0TdpoUV6I7ZGZKlHAAGnqZbfaoTiA45UsM5c82M99M,7405
 ruyi/device/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ruyi/device/provision.py,sha256=0Lywhs9_sLMG21DRMP1DyijYFIB4k4-xYYNJikH8qcs,20902
+ruyi/device/provision.py,sha256=9rUbLtybBQ8x9qRXaMwz_yAMf51vb3wmYE0qm54P5Bk,20906
 ruyi/device/provision_cli.py,sha256=sc6AF8ohWrXA-kIAYdZcD6sl1HHbj_dH2cCi-pjjOQg,1031
 ruyi/log/__init__.py,sha256=ehgUl8iY1oRfP_nJKrln5lnvJFSPPU1J-3g-PK28YWk,6516
 ruyi/mux/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -28,7 +28,7 @@ ruyi/mux/venv/maker.py,sha256=RzipQWANOpKZxXGG_XiExyoQzHBw-j6wew7Iu6hZwZE,27234
 ruyi/mux/venv/venv_cli.py,sha256=rIKNcYKu1j7ahHXNgv_ytYVR7qJOoly-TaHPvb21FGA,2974
 ruyi/mux/venv_cfg.py,sha256=m75JCVLFWE1gE8OzcNDOHqwUc2c6ikJhZ-GhjsXv94U,6840
 ruyi/pluginhost/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ruyi/pluginhost/api.py,sha256=yu8zsvjGTFINwdwTQ6vGJPKQvb_9QHkbu8jpfoglNr4,5716
+ruyi/pluginhost/api.py,sha256=Zh69xJfR7PEbM6fjoFZRNqeqTneWAmC71NjA76HodSY,5711
 ruyi/pluginhost/ctx.py,sha256=MsP1L7nchnbSrauId3GaQzv0YJLnWE0u_H3ZFEmjUX8,6590
 ruyi/pluginhost/paths.py,sha256=3EVY3_i3LLff4Lk9py-E317C7_ysiRatfCiuxvCsVWw,4227
 ruyi/pluginhost/plugin_cli.py,sha256=rLdXG4_OJ2nlaSjFBmTaclx_N2f0s_Wi-9qcSeq7h9I,968
@@ -45,14 +45,14 @@ ruyi/ruyipkg/augmented_pkg.py,sha256=QbzYNHCRanFx9xwYRosN_dAEzOSxmOBxyBVli8SC9FE
 ruyi/ruyipkg/canonical_dump.py,sha256=Qu25YXwJpjWUBte0C3bmmaJxe7zyqfN-2-__u2_dJDM,9363
 ruyi/ruyipkg/checksum.py,sha256=ChYFPXl7-Y8p_bDerkXOGroRz4k6ejjWY9ViaVWuEgk,1274
 ruyi/ruyipkg/cli_completion.py,sha256=kJf7vN5rXi5zAwTI3dr4J8HdUzR3-ZXnsdaNQV6kqzo,1151
-ruyi/ruyipkg/distfile.py,sha256=mgEZAS8jv9zP_7SSk59B8QCZfcouUf4qZGBnL44B5zg,6895
+ruyi/ruyipkg/distfile.py,sha256=wkyYVcSM2b3vD462TtoltdLcUZElCwWvcZBiPG3lTZ0,7002
 ruyi/ruyipkg/entity.py,sha256=s8h5kNaR2vsP6v_QUFIO6SZiUrt0jrb8GU11bNT6fn4,14498
 ruyi/ruyipkg/entity_cli.py,sha256=hF66i3sJX8XVLIWq376GA9vzgegfQy-6s0x0L831Irk,3802
 ruyi/ruyipkg/entity_provider.py,sha256=jDfS2Jh01PVHo0kb1XyI5WkZgL4fv21AooXLLwqK-1I,8741
-ruyi/ruyipkg/fetch.py,sha256=_btz2hkTz0uEUCCSAhOK7tlhAuvzCu42ZTUCP-RpU7U,9047
+ruyi/ruyipkg/fetcher.py,sha256=_btz2hkTz0uEUCCSAhOK7tlhAuvzCu42ZTUCP-RpU7U,9047
 ruyi/ruyipkg/host.py,sha256=pmqgggi7koDCWgzFexwHpycv4SZ07VF6xUbi4s8FSKA,1399
-ruyi/ruyipkg/install.py,sha256=1RpDVEGkni8Z9z-3GVJepDYpF9ADdkh2vXTyG7BZms4,16299
-ruyi/ruyipkg/install_cli.py,sha256=BuhGJcrKsJqr63-8AamouY1mXAvjEe2nkxHYuAQ3U0Y,4269
+ruyi/ruyipkg/install.py,sha256=RhJwIqGxMveWrGmpP-2uWpZBRnqkA75HwyHwrNTdqow,18176
+ruyi/ruyipkg/install_cli.py,sha256=joIV5iY4iblDinoH2pgbHNYkMVWqMxtVNj89T0IpJuk,5267
 ruyi/ruyipkg/list.py,sha256=iO7666xFEWKTDNtJqVLaaQKsp0BfLTzgXBwFFHrqCGc,4172
 ruyi/ruyipkg/list_cli.py,sha256=9tRWWRcJv3yJqzup6Oc89E3xahGp5jIfybfEvwwd55I,2243
 ruyi/ruyipkg/list_filter.py,sha256=F64_UhwUEiaUR73EkLu91qoUBA-Yz9mEVWj8XY46MXQ,5467
@@ -61,28 +61,28 @@ ruyi/ruyipkg/news.py,sha256=5uN4UYqvEW5MU_10W9MzwFo3lH25oZCvMMjfAjLed7U,3857
 ruyi/ruyipkg/news_cli.py,sha256=s5mirEBmO2lZITfjcpzDakP7rNYPqopdM9odbwmAPpg,2378
 ruyi/ruyipkg/news_store.py,sha256=ocTO4YDpL_HrKaIRFvJ_Gxvpmr7V7-R8b1B8f5Eue9c,5276
 ruyi/ruyipkg/pkg_manifest.py,sha256=FmksKjQyBnU4zA3MFXiHdB2EjNmhs-J9km9vE-zBQlk,18836
-ruyi/ruyipkg/profile.py,sha256=FVppmA6x12m3JfeAWd3Vl9osk4aBprZL4ff7akO018Q,6467
+ruyi/ruyipkg/profile.py,sha256=6xwL24crALShqD8bazGOIAFTYCpM_91mD8d6YMxM2FU,10762
 ruyi/ruyipkg/profile_cli.py,sha256=ud9MS9JQLOtec_1tFRu669I-imVfi1DHU3AuBJym9mw,848
 ruyi/ruyipkg/protocols.py,sha256=lPKRaAcK3DY3wmkyO2tKpFvPQ_4QA4aSNNsNLvi78O8,1833
-ruyi/ruyipkg/repo.py,sha256=K0kKj333T6vDwhxWneiPm_CVZdwKP-gpOJdfD5rXnnY,25142
-ruyi/ruyipkg/state.py,sha256=3DRYyHvm_GOvKFVWZUV0iFVnXdK2vn6_RKBXKxFzK64,11235
-ruyi/ruyipkg/unpack.py,sha256=X_MKcxU1bcgIM-th1--CUfmnjQOFp-EqWWpvk27YttA,11028
+ruyi/ruyipkg/repo.py,sha256=l5d4XPZS-ofbwlAOk5GZMM7AFGay1n1xDVzge935oA4,25231
+ruyi/ruyipkg/state.py,sha256=Ie4vrt79Wp9P0L36tMj36tOtDlFnIb6uwVGDQCQyg8s,11544
+ruyi/ruyipkg/unpack.py,sha256=hPd-lOnDXp1lEb4mdbLUEckT4QXblSFxz-dGAdwaAjc,11207
 ruyi/ruyipkg/unpack_method.py,sha256=MonFFvcDb7MVsi2w4yitnCeZkmWmS7nRMMY-wSt9AMs,2106
 ruyi/ruyipkg/update_cli.py,sha256=ywsAAUPctJ3_2qPDvFL2__ql9m8tGZ6ZfrwbSk30Xh4,1425
 ruyi/telemetry/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ruyi/telemetry/aggregate.py,sha256=Ybt25xrg0n62A9Ipslv18EBC-kLkyYsPeEzgguTtChg,1981
 ruyi/telemetry/event.py,sha256=GZnFj6E59Q7mjp-2VRApAZH3rT_bu4_cWb5QMCPm-Zc,982
 ruyi/telemetry/node_info.py,sha256=ix-udhoKQI-HV7qVeEbd-jy3ZyhXL62sVA9uX4fowEg,5178
-ruyi/telemetry/provider.py,sha256=KKYoic29hWq4u2Bk_usORkT9yQCpREinOLYZXj3eN9k,14832
+ruyi/telemetry/provider.py,sha256=U88ydGga3dwYAi7mfNKmEEyfhAZ4xelF2L-jNAk29IY,16486
 ruyi/telemetry/scope.py,sha256=e45VPAvRAqSxrL0ESorN9SCnR_I6Bwi2CMPJDDshJEE,1133
-ruyi/telemetry/store.py,sha256=7ThCzKF2txT_xU3qgjotOcwRqwNhozIkIyYQ0GSUxBg,8015
+ruyi/telemetry/store.py,sha256=jodRQ7aRye9qYfvc0uaPQ5DLYGmYYuJtb8dnUN9KVs8,8010
 ruyi/telemetry/telemetry_cli.py,sha256=PBVMUSE3P6IBKQVMji_bueVenCdbchbOlowySXy0468,3364
 ruyi/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ruyi/utils/ar.py,sha256=w9wiYYdbInLewr5IRTcP0TiOw2ibVDQEmnV0hHm9WlA,2271
 ruyi/utils/ci.py,sha256=66DBm4ooA7yozDtXCJFd1n2jJXTsEnxPSpkNzLfE28M,2970
 ruyi/utils/frontmatter.py,sha256=4EOohEYCZ_q6ncpDv7ktJYf9PN4WEdgFfdE9hZBV3Zg,1052
-ruyi/utils/git.py,sha256=SlOaS9sR4_0mhNgTXMvrmI8Q7-eh2z8pyhGq_9HuqSU,5893
-ruyi/utils/global_mode.py,sha256=A9ehY4z1ckUSMHqiDDlXmJpjPzTajCgsDvDqyTwZZj4,4979
+ruyi/utils/git.py,sha256=YspRRkfxLXluCv4LNx6q_mjkPdoX7WSM9aR7EfudqlM,5991
+ruyi/utils/global_mode.py,sha256=9Y17rVDm157EKvU6GJ8K1rnVTXnYyLN5e_7psObne00,5691
 ruyi/utils/l10n.py,sha256=l003oQ5M8fWIKQHbYTVSc6oHzFFGU2sbKac7Hh6FNFU,2530
 ruyi/utils/markdown.py,sha256=Mpq--ClM4j9lm_-5zO53ptYePUTLI4rg0V1YshOwsf8,2654
 ruyi/utils/mounts.py,sha256=31BGsVOpD2bO7PYpm8I1ogDHzP3MvrMWznKonS3Ajos,1210
@@ -91,12 +91,12 @@ ruyi/utils/porcelain.py,sha256=pF6ieSE2xlnC0HBADFY0m-uuwVNNME3wlbHo2jWdLFA,1403
 ruyi/utils/prereqs.py,sha256=oWAaH-smpTMQxpHt782YBxqHxrTaheataslN988-a78,2076
 ruyi/utils/ssl_patch.py,sha256=a5gf4br6nC39wTHsqiFtcJ-mGzqB-YzK6DHSeERLaHQ,5661
 ruyi/utils/templating.py,sha256=94xBJTkIfDqmUBTc9hnLO54zQoC7hwGWONGF3YbaqHk,966
-ruyi/utils/toml.py,sha256=ri97Ki0xhBwoDtrjngCc6hlPXuEsma1ShPFFuFMYqpA,3192
+ruyi/utils/toml.py,sha256=aniIF3SGfR69_s3GWWwlnoKxW4B5IDVY2CM0eUI55_c,3501
 ruyi/utils/url.py,sha256=Wyct6syS4GmZC6mY7SK-YgBWxKl3cOOBXtp9UtvGkto,186
-ruyi/utils/xdg_basedir.py,sha256=vd9p-JZru2DkXvt_W3gCS1_Wj4QkuftErI1MLPaBiz4,2478
-ruyi/version.py,sha256=KLJkvKexU07mu-GVDbYKsQvReRvwlVFYkRmcvnyfQNY,2142
-ruyi-0.41.0b20250926.dist-info/METADATA,sha256=--zkfVJ7C1CjBf4XAd6gZ2Ke3TB-7Zn5rNlP0D7OME4,23892
-ruyi-0.41.0b20250926.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-ruyi-0.41.0b20250926.dist-info/entry_points.txt,sha256=GXSNSy7OgFrnlU5xm5dE3l3PGO92Qf6VDIUCdvQNm8E,49
-ruyi-0.41.0b20250926.dist-info/licenses/LICENSE-Apache.txt,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-ruyi-0.41.0b20250926.dist-info/RECORD,,
+ruyi/utils/xdg_basedir.py,sha256=RwVH199jPcLVsg5ngR62RaNS5hqnMpkdt31LqkCfa1g,2751
+ruyi/version.py,sha256=womuPV6RmxG2TAe5KhRnuQctXR6qLV3be8xJN3QqUdI,595
+ruyi-0.42.0.dist-info/METADATA,sha256=Te5Fou6OsjO0de6Yk3V9Ei6o3jz_2izFKuSgAchaznM,24266
+ruyi-0.42.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+ruyi-0.42.0.dist-info/entry_points.txt,sha256=GXSNSy7OgFrnlU5xm5dE3l3PGO92Qf6VDIUCdvQNm8E,49
+ruyi-0.42.0.dist-info/licenses/LICENSE-Apache.txt,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+ruyi-0.42.0.dist-info/RECORD,,