Fix dry_run bypass in install/update/uninstall and correct README

README.md

@@ -952,7 +952,7 @@ PATH = ""                            # prepends cargo_root/bin and cargo_home/bi
 cargo_root = None                    # set this for hermetic installs
 ```
 
-- Install root: set `install_root=Path(...)` or `install_root=Path(...)` for isolated installs under `<cargo_root>/bin`; otherwise installs go through `cargo_home`.
+- Install root: set `install_root=Path(...)` (or the alias `cargo_root=Path(...)`) for isolated installs under `<install_root>/bin`; otherwise installs go through `cargo_home`.
 - Auto-switching: none.
 - `dry_run`: shared behavior.
 - Security: `min_release_age` and `postinstall_scripts=False` are unsupported and are ignored with a warning if explicitly requested.
@@ -1116,8 +1116,8 @@ Source: [`abxpkg/binprovider_pyinfra.py`](./abxpkg/binprovider_pyinfra.py) • T
 ```python
 INSTALLER_BIN = "pyinfra"
 PATH = os.environ.get("PATH", DEFAULT_PATH)
-pyinfra_installer_module = "auto"
-pyinfra_installer_kwargs = {}
+# installer_module defaults to "auto" (operations.brew.packages on macOS, operations.server.packages on Linux)
+# installer_kwargs defaults to {}
 ```
 
 - Install root: **no hermetic prefix support**. It delegates to host package managers through pyinfra operations.
@@ -1137,8 +1137,8 @@ Source: [`abxpkg/binprovider_ansible.py`](./abxpkg/binprovider_ansible.py) • T
 ```python
 INSTALLER_BIN = "ansible"
 PATH = os.environ.get("PATH", DEFAULT_PATH)
-ansible_installer_module = "auto"
-ansible_playbook_template = ANSIBLE_INSTALL_PLAYBOOK_TEMPLATE
+# installer_module defaults to "auto" (community.general.homebrew on macOS, ansible.builtin.package on Linux)
+# playbook_template defaults to ANSIBLE_INSTALL_PLAYBOOK_TEMPLATE
 ```
 
 - Install root: **no hermetic prefix support**. It delegates to the host via `ansible-runner`.

abxpkg/binprovider.py

@@ -2126,8 +2126,6 @@ def install(
             ACTIVE_EXEC_LOG_PREFIX.reset(exec_log_prefix_token)
 
         if self.dry_run:
-            # return fake ShallowBinary if we're just doing a dry run
-            # no point trying to get real abspath or version if nothing was actually installed
             return ShallowBinary.model_construct(
                 name=bin_name,
                 description=bin_name,

abxpkg/binprovider_ansible.py

@@ -373,6 +373,14 @@ def default_install_handler(
         ansible_playbook = self.INSTALLER_BINARY(no_cache=no_cache).loaded_abspath
         assert ansible_playbook
 
+        if self.dry_run:
+            logger.info(
+                "DRY RUN (%s): ansible-playbook install %s",
+                self.__class__.__name__,
+                " ".join(install_args),
+            )
+            return f"DRY RUN: would install {install_args} via ansible"
+
         module_extra_kwargs = self.get_ansible_module_extra_kwargs()
 
         return ansible_package_install(
@@ -401,6 +409,14 @@ def default_update_handler(
         ansible_playbook = self.INSTALLER_BINARY(no_cache=no_cache).loaded_abspath
         assert ansible_playbook
 
+        if self.dry_run:
+            logger.info(
+                "DRY RUN (%s): ansible-playbook update %s",
+                self.__class__.__name__,
+                " ".join(install_args),
+            )
+            return f"DRY RUN: would update {install_args} via ansible"
+
         module_extra_kwargs = self.get_ansible_module_extra_kwargs()
         if module_extra_kwargs:
             return ansible_package_install(
@@ -439,6 +455,14 @@ def default_uninstall_handler(
         ansible_playbook = self.INSTALLER_BINARY(no_cache=no_cache).loaded_abspath
         assert ansible_playbook
 
+        if self.dry_run:
+            logger.info(
+                "DRY RUN (%s): ansible-playbook uninstall %s",
+                self.__class__.__name__,
+                " ".join(install_args),
+            )
+            return True
+
         module_extra_kwargs = self.get_ansible_module_extra_kwargs()
         if module_extra_kwargs:
             ansible_package_install(

abxpkg/binprovider_pyinfra.py

@@ -294,6 +294,14 @@ def default_install_handler(
         pyinfra_abspath = self.INSTALLER_BINARY(no_cache=no_cache).loaded_abspath
         assert pyinfra_abspath
 
+        if self.dry_run:
+            logger.info(
+                "DRY RUN (%s): pyinfra install %s",
+                self.__class__.__name__,
+                " ".join(install_args),
+            )
+            return f"DRY RUN: would install {install_args} via pyinfra"
+
         return pyinfra_package_install(
             pkg_names=install_args,
             pyinfra_abspath=str(pyinfra_abspath),
@@ -317,6 +325,14 @@ def default_update_handler(
         pyinfra_abspath = self.INSTALLER_BINARY(no_cache=no_cache).loaded_abspath
         assert pyinfra_abspath
 
+        if self.dry_run:
+            logger.info(
+                "DRY RUN (%s): pyinfra update %s",
+                self.__class__.__name__,
+                " ".join(install_args),
+            )
+            return f"DRY RUN: would update {install_args} via pyinfra"
+
         return pyinfra_package_install(
             pkg_names=install_args,
             pyinfra_abspath=str(pyinfra_abspath),
@@ -342,6 +358,14 @@ def default_uninstall_handler(
         pyinfra_abspath = self.INSTALLER_BINARY(no_cache=no_cache).loaded_abspath
         assert pyinfra_abspath
 
+        if self.dry_run:
+            logger.info(
+                "DRY RUN (%s): pyinfra uninstall %s",
+                self.__class__.__name__,
+                " ".join(install_args),
+            )
+            return True
+
         pyinfra_package_install(
             pkg_names=install_args,
             pyinfra_abspath=str(pyinfra_abspath),