rename abx_pkg to abxpkg

Author: pirate

AGENTS.md

@@ -1,4 +1,4 @@
-# abx-pkg Guide
+# abxpkg Guide
 
 This is a python package and CLI tool to help install and run binary package dependencies from a variety 
 of providers (etc apt, brew, pip, npm, docker, env, bash script, etc.).
@@ -8,7 +8,7 @@ It provides nice safe pydantic type interfaces for `Binary`, `BinProvider`, `Sem
 ### Python API
 
 ```python
-from abx_pkg import Binary, apt, brew, env, BinProvider
+from abxpkg import Binary, apt, brew, env, BinProvider
 
 wget = env.load('wget') or apt.install('wget') or brew.install('wget')
 
@@ -29,27 +29,27 @@ wget.uninstall()
 ### CLI
 
 ```
-abx-pkg --version
-abx-pkg install --binproviders=env,apt,brew wget
-abx-pkg load|install|update|uninstall|run [--flags...] [binary] [args...]
+abxpkg --version
+abxpkg install --binproviders=env,apt,brew wget
+abxpkg load|install|update|uninstall|run [--flags...] [binary] [args...]
 
 # abx alias cli:
-abx wget --version    # just a thin wrapper around `abx-pkg run --install [--flags...] [binary] [args...]`
+abx wget --version    # just a thin wrapper around `abxpkg run --install [--flags...] [binary] [args...]`
 ```
 
 also usable as a shebang in scripts similar to uv run -S, auto installs dependencies before running the script:
 ```javascript
-#!/usr/bin/env abx-pkg run --script node --abort-on-uncaught-exception
+#!/usr/bin/env abxpkg run --script node --abort-on-uncaught-exception
 // /// script
 // dependencies = [
 //    {name = "node", binproviders = ["env", "apt", "brew"], min_version: "22.0.0"},
 //    {name = "playwright", binproviders = ["playwright", "pnpm", "npm", "yarn"]},
 //    {name = "chromium", binproviders = ["env", "playwright", "puppeteer", "apt"], min_version: "146.0.0"},
 // ]
-// [tool.abx-pkg]
-// ABX_PKG_LIB_DIR=/tmp/abxlib
-// ABX_PKG_MIN_RELEASE_AGE=14
-// ABX_PKG_POSTINSTALL_SCRIPTS=False
+// [tool.abxpkg]
+// ABXPKG_LIB_DIR=/tmp/abxlib
+// ABXPKG_MIN_RELEASE_AGE=14
+// ABXPKG_POSTINSTALL_SCRIPTS=False
 // ///
 
 import {playwright} from 'playwright';

README.md

@@ -1,4 +1,4 @@
-__package__ = "abx_pkg"
+__package__ = "abxpkg"
 
 from .base_types import (
     BinName,
@@ -70,25 +70,25 @@
 
 ALL_PROVIDERS = [
     EnvProvider,
-    AptProvider,
+    UvProvider,
+    PipProvider,
+    PnpmProvider,
+    NpmProvider,
+    YarnProvider,
+    BunProvider,
     BrewProvider,
-    CargoProvider,
     GemProvider,
     GoGetProvider,
+    CargoProvider,
+    PlaywrightProvider,
+    PuppeteerProvider,
+    AptProvider,
     NixProvider,
     DockerProvider,
-    PipProvider,
-    UvProvider,
-    NpmProvider,
-    PnpmProvider,
-    YarnProvider,
-    BunProvider,
     DenoProvider,
     AnsibleProvider,
     PyinfraProvider,
     ChromeWebstoreProvider,
-    PuppeteerProvider,
-    PlaywrightProvider,
     BashProvider,
 ]
 
@@ -189,7 +189,7 @@ def __getattr__(name: str):
     "PlaywrightProvider",
     "BashProvider",
     # Note: provider singleton names (apt, pip, brew, etc.) are intentionally
-    # excluded from __all__ so that `from abx_pkg import *` does not eagerly
+    # excluded from __all__ so that `from abxpkg import *` does not eagerly
     # instantiate every provider. Use explicit imports instead:
-    #   from abx_pkg import apt, pip, brew, npm, pnpm, yarn, bun, deno
+    #   from abxpkg import apt, pip, brew, npm, pnpm, yarn, bun, deno
 ]

abx_pkg/settings.py

@@ -3,4 +3,4 @@
 
 class AbxPkgConfig(AppConfig):
     default_auto_field = "django.db.models.BigAutoField"
-    name = "abx_pkg"
+    name = "abxpkg"

abx_pkg/__init__.py abxpkg/__init__.pyabx_pkg/__init__.py renamed to abxpkg/__init__.py

@@ -1,4 +1,4 @@
-__package__ = "abx_pkg"
+__package__ = "abxpkg"
 
 import inspect
 import os
@@ -14,32 +14,32 @@
 
 
 # Read once at import time. When set, providers that opt into
-# ``abx_pkg_install_root_default("<provider>")`` default their
-# ``install_root`` to ``ABX_PKG_LIB_DIR / <provider name>`` (e.g.
+# ``abxpkg_install_root_default("<provider>")`` default their
+# ``install_root`` to ``ABXPKG_LIB_DIR / <provider name>`` (e.g.
 # ``<lib>/npm``, ``<lib>/pip``, ``<lib>/gem``). Per-provider
-# ``ABX_PKG_<NAME>_ROOT`` env vars override this for their own
+# ``ABXPKG_<NAME>_ROOT`` env vars override this for their own
 # provider; explicit constructor kwargs override both.
 DEFAULT_LIB_DIR: Path = user_config_path("abx") / "lib"
 
 
-def abx_pkg_install_root_default(provider_name: str) -> Path | None:
+def abxpkg_install_root_default(provider_name: str) -> Path | None:
     """Resolve a provider's default install root from env vars.
 
     Precedence (most specific wins):
-    1. ``ABX_PKG_<PROVIDER>_ROOT`` (e.g. ``ABX_PKG_NPM_ROOT``)
-    2. ``ABX_PKG_LIB_DIR / <provider_name>``
+    1. ``ABXPKG_<PROVIDER>_ROOT`` (e.g. ``ABXPKG_NPM_ROOT``)
+    2. ``ABXPKG_LIB_DIR / <provider_name>``
     3. ``None`` — caller's built-in default applies.
 
     Explicit constructor kwargs (``install_root=`` or the
     provider-specific alias) always override whatever this function
     returns.
     """
-    specific = os.environ.get(f"ABX_PKG_{provider_name.upper()}_ROOT", "").strip()
+    specific = os.environ.get(f"ABXPKG_{provider_name.upper()}_ROOT", "").strip()
     if specific:
         return Path(specific).expanduser().resolve()
     # Read from os.environ directly (not the cached module-level
-    # ABX_PKG_LIB_DIR) because the CLI sets it at runtime via --lib.
-    lib_dir = os.environ.get("ABX_PKG_LIB_DIR", "").strip()
+    # ABXPKG_LIB_DIR) because the CLI sets it at runtime via --lib.
+    lib_dir = os.environ.get("ABXPKG_LIB_DIR", "").strip()
     if lib_dir:
         return Path(lib_dir).expanduser().resolve() / provider_name
     return None

abx_pkg/admin.py abxpkg/admin.pyabx_pkg/admin.py renamed to abxpkg/admin.py

@@ -1,4 +1,4 @@
-__package__ = "abx_pkg"
+__package__ = "abxpkg"
 
 from typing import Any
 from typing import Self
@@ -346,7 +346,7 @@ def load(
         assert self.name, f"No binary name was provided! {self}"
 
         # if we're already loaded, skip loading
-        if self.is_valid:
+        if self.is_valid and not no_cache:
             logger.debug("Skipping load for %s because it is already valid", self.name)
             return self