env-module-manager 0.7.0__tar.gz → 0.8.0__tar.gz

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: env-module-manager
-Version: 0.7.0
+Version: 0.8.0
 Summary: Deploy Python, Rust, shell, and collective CLI environments behind GNU environment modulefiles
 Project-URL: Homepage, https://github.com/ejb90/module-manager
 Project-URL: Documentation, https://module-manager.readthedocs.io/
@@ -73,6 +73,7 @@ Deploy a Python CLI with `uv tool install`:
 ```sh
 module-manager deploy-python ruff 0.8.0 \
   --package 'ruff==0.8.0' \
+  --default-index https://packages.example/simple \
   --constraints /prod/constraints/runtime.txt \
   --prefix /prod/tools \
   --module-root /prod/modulefiles \
@@ -94,6 +95,16 @@ Generate a constraints file for a Python CLI:
 module-manager auto-constraints ruff==0.8.0 --output constraints.txt
 ```
 
+Deploy from a direct wheel or Git URL:
+
+```sh
+module-manager deploy-python my-tool 1.0.0 \
+  --package 'my-tool @ file:///prod/wheels/my_tool-1.0.0-py3-none-any.whl' \
+  --prefix /prod/tools \
+  --module-root /prod/modulefiles \
+  --execute-install
+```
+
 Deploy a shell script:
 
 ```sh

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/README.md

@@ -41,6 +41,7 @@ Deploy a Python CLI with `uv tool install`:
 ```sh
 module-manager deploy-python ruff 0.8.0 \
   --package 'ruff==0.8.0' \
+  --default-index https://packages.example/simple \
   --constraints /prod/constraints/runtime.txt \
   --prefix /prod/tools \
   --module-root /prod/modulefiles \
@@ -62,6 +63,16 @@ Generate a constraints file for a Python CLI:
 module-manager auto-constraints ruff==0.8.0 --output constraints.txt
 ```
 
+Deploy from a direct wheel or Git URL:
+
+```sh
+module-manager deploy-python my-tool 1.0.0 \
+  --package 'my-tool @ file:///prod/wheels/my_tool-1.0.0-py3-none-any.whl' \
+  --prefix /prod/tools \
+  --module-root /prod/modulefiles \
+  --execute-install
+```
+
 Deploy a shell script:
 
 ```sh

env_module_manager-0.8.0/docs/collective-environments.md

@@ -0,0 +1,186 @@
+# Collective Environments
+
+Collective environments package several tools behind one modulefile. Use them
+when a shared workflow needs Python CLIs, Rust binaries, and shell scripts to
+appear together from one `module load`.
+
+Create a TOML manifest:
+
+```toml
+name = "dev-tools"
+version = "2026.05"
+description = "Shared developer command-line tools"
+prefix = "/prod/tools"
+module_root = "/prod/modulefiles"
+default = true
+
+[[tools]]
+type = "python"
+name = "ruff"
+version = "0.8.0"
+package = "ruff==0.8.0"
+python = "3.12"
+indexes = ["https://packages.example/simple"]
+default_index = "https://packages.example/simple"
+find_links = ["/prod/wheels"]
+no_index = false
+index_strategy = "first-index"
+constraints = ["/prod/constraints/runtime.txt"]
+no_cache = false
+refresh = false
+refresh_packages = ["ruff"]
+force = false
+reinstall = false
+uv_config_file = "/prod/config/uv.toml"
+
+[[tools]]
+type = "rust"
+name = "ripgrep"
+version = "14.1.1"
+binary = "./target/release/rg"
+
+[[tools]]
+type = "script"
+name = "lab-helper"
+version = "1.0.0"
+script = "./scripts/lab-helper"
+```
+
+Deploy the environment:
+
+```sh
+module-manager deploy-env --file dev-tools.toml
+```
+
+This writes one shared environment:
+
+```text
+/prod/tools/dev-tools/2026.05/bin
+/prod/modulefiles/dev-tools/2026.05
+```
+
+The generated modulefile prepends the shared `bin` directory to `PATH`, so all
+tools in the manifest are available after:
+
+```sh
+module use /prod/modulefiles
+module load dev-tools
+```
+
+Relative `binary` and `script` paths are resolved relative to the manifest file.
+Relative Python `constraints` paths are resolved the same way.
+
+## Multiple Python Tools
+
+A collective environment can install several Python CLIs into the same shared
+`bin` directory. Each Python tool can use its own package spec and uv resolver
+options:
+
+```toml
+name = "python-dev-tools"
+version = "2026.05"
+prefix = "/prod/tools"
+module_root = "/prod/modulefiles"
+
+[[tools]]
+type = "python"
+name = "ruff"
+version = "0.8.0"
+package = "ruff==0.8.0"
+python = "3.12"
+constraints = ["constraints.txt"]
+
+[[tools]]
+type = "python"
+name = "gitconductor"
+version = "0.7.0"
+package = "gitconductor==0.7.0"
+default_index = "https://packages.example/simple"
+constraints = ["constraints.txt"]
+refresh_packages = ["gitconductor"]
+
+[[tools]]
+type = "python"
+name = "internal-review"
+version = "1.4.2"
+package = "internal-review @ file:///prod/wheels/internal_review-1.4.2-py3-none-any.whl"
+find_links = ["/prod/wheels"]
+no_index = true
+```
+
+Deploy it with:
+
+```sh
+module-manager deploy-env --file python-dev-tools.toml
+```
+
+After `module load python-dev-tools`, the `ruff`, `gitconductor`, and
+`internal-review` executables are available from one module.
+
+## Python Tools and Bash Scripts
+
+Use script entries for Bash helpers that should live alongside Python CLIs:
+
+```toml
+name = "release-tools"
+version = "2026.05"
+description = "Release automation helpers"
+prefix = "/prod/tools"
+module_root = "/prod/modulefiles"
+
+[[tools]]
+type = "python"
+name = "gitconductor"
+version = "0.7.0"
+package = "gitconductor==0.7.0"
+constraints = ["constraints.txt"]
+
+[[tools]]
+type = "python"
+name = "changelog-builder"
+version = "2.1.0"
+package = "changelog-builder @ git+https://github.com/org/changelog-builder.git@v2.1.0"
+
+[[tools]]
+type = "script"
+name = "release-check"
+version = "1.0.0"
+script = "./scripts/release-check.sh"
+
+[[tools]]
+type = "script"
+name = "publish-docs"
+version = "1.0.0"
+script = "./scripts/publish-docs.sh"
+```
+
+Deploy it with:
+
+```sh
+module-manager deploy-env --file release-tools.toml
+```
+
+The script files are copied into the shared environment `bin` directory and
+marked executable, so they appear on `PATH` next to the Python entry points.
+
+## Preview
+
+Use `--dry-run` to preview the install, copy, and modulefile actions without
+creating files:
+
+```sh
+module-manager deploy-env --file dev-tools.toml --dry-run
+```
+
+## Overrides
+
+The manifest can define `prefix`, `module_root`, and `default`, but CLI options
+can override them:
+
+```sh
+module-manager deploy-env \
+  --file dev-tools.toml \
+  --prefix /scratch/tools \
+  --module-root /scratch/modulefiles \
+  --no-default
+```

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/docs/python-tools.md

@@ -34,20 +34,37 @@ unchanged.
 ```sh
 module-manager deploy-python gitconductor 0.1.0 \
   --package gitconductor==0.1.0 \
+  --default-index https://packages.example/simple \
   --index https://packages.example/simple \
   --prefix /prod/tools \
   --module-root /prod/modulefiles \
   --execute-install
 ```
 
-`--index` may be used more than once.
+`--index` may be used more than once. Use `--default-index` to replace uv's
+default package index, or `--no-index` when resolution should use only direct
+URLs and `--find-links` locations.
 
 ## Deploy from a Wheelhouse
 
+Use `--find-links` when wheels are staged in a directory or simple HTML page:
+
+```sh
+module-manager deploy-python gitconductor 0.1.0 \
+  --package gitconductor==0.1.0 \
+  --find-links /prod/wheels \
+  --prefix /prod/tools \
+  --module-root /prod/modulefiles \
+  --execute-install
+```
+
+Add `--no-index` to make the install fully wheelhouse-only:
+
 ```sh
 module-manager deploy-python gitconductor 0.1.0 \
   --package gitconductor==0.1.0 \
   --find-links /prod/wheels \
+  --no-index \
   --prefix /prod/tools \
   --module-root /prod/modulefiles \
   --execute-install
@@ -55,6 +72,28 @@ module-manager deploy-python gitconductor 0.1.0 \
 
 `--find-links` may be used more than once.
 
+## Deploy from a Wheel URL
+
+Pass a direct wheel URL or file URL as the package spec:
+
+```sh
+module-manager deploy-python gitconductor 0.1.0 \
+  --package 'gitconductor @ https://packages.example/files/gitconductor-0.1.0-py3-none-any.whl' \
+  --prefix /prod/tools \
+  --module-root /prod/modulefiles \
+  --execute-install
+```
+
+For a local wheel file:
+
+```sh
+module-manager deploy-python gitconductor 0.1.0 \
+  --package 'gitconductor @ file:///prod/wheels/gitconductor-0.1.0-py3-none-any.whl' \
+  --prefix /prod/tools \
+  --module-root /prod/modulefiles \
+  --execute-install
+```
+
 ## Use Constraint Files
 
 Pass requirement constraint files to `uv tool install`:
@@ -70,6 +109,24 @@ module-manager deploy-python gitconductor 0.1.0 \
 
 `--constraints` may be used more than once.
 
+## Cache and Refresh Controls
+
+Pass uv cache controls through when you need fresh index or package metadata:
+
+```sh
+module-manager deploy-python gitconductor 0.1.0 \
+  --package gitconductor==0.1.0 \
+  --refresh \
+  --refresh-package gitconductor \
+  --no-cache \
+  --prefix /prod/tools \
+  --module-root /prod/modulefiles \
+  --execute-install
+```
+
+Use `--force` or `--reinstall` when re-running an install into an existing
+versioned tool environment.
+
 ## Generate Constraint Files
 
 Use `auto-constraints` to compile a package and its dependencies into a
@@ -111,8 +168,8 @@ through the environment.
 
 ## Deploy from VCS
 
-`--package` is passed directly to `uv tool install`, so VCS package specs are
-supported.
+`--package` is passed directly to `uv tool install`, so Git package specs are
+supported. Pin a tag, branch, or commit to keep deployments reproducible.
 
 ```sh
 module-manager deploy-python mytool 1.0.0 \
@@ -122,6 +179,16 @@ module-manager deploy-python mytool 1.0.0 \
   --execute-install
 ```
 
+For an SSH Git URL:
+
+```sh
+module-manager deploy-python mytool 1.0.0 \
+  --package 'git+ssh://git@github.com/org/repo.git@v1.0.0' \
+  --prefix /prod/tools \
+  --module-root /prod/modulefiles \
+  --execute-install
+```
+
 For a package in a repository subdirectory:
 
 ```sh

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/docs/reference.md

@@ -49,8 +49,17 @@ module-manager deploy-python NAME VERSION \
   --package PACKAGE \
   [--python PYTHON] \
   [--index URL] \
+  [--default-index URL] \
   [--find-links PATH_OR_URL] \
+  [--no-index] \
+  [--index-strategy STRATEGY] \
+  [--keyring-provider PROVIDER] \
   [--constraints PATH] \
+  [--no-cache] \
+  [--refresh] \
+  [--refresh-package PACKAGE] \
+  [--force] \
+  [--reinstall] \
   [--uv-config-file PATH] \
   [--prefix PATH] \
   [--module-root PATH] \

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/module_manager/__init__.py

@@ -1,3 +1,3 @@
 """Deployment helpers for HPC environment module files."""
 
-__version__ = "0.7.0"
+__version__ = "0.8.0"

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/module_manager/cli.py

@@ -203,18 +203,40 @@ def main(ctx: click.Context, config: Path | None) -> None:
     multiple=True,
     help="Additional package index URL passed to uv. May be used more than once.",
 )
+@click.option("--default-index", help="Default package index URL passed to uv.")
 @click.option(
     "--find-links",
     "find_links",
     multiple=True,
     help="Directory or HTML page of packages passed to uv. May be used more than once.",
 )
+@click.option("--no-index", is_flag=True, help="Ignore registry indexes and use direct URLs or find-links.")
+@click.option(
+    "--index-strategy",
+    type=click.Choice(["first-index", "unsafe-first-match", "unsafe-best-match"]),
+    help="Package index strategy passed to uv.",
+)
+@click.option(
+    "--keyring-provider",
+    type=click.Choice(["disabled", "subprocess"]),
+    help="Keyring provider passed to uv.",
+)
 @click.option(
     "--constraints",
     "constraints",
     multiple=True,
     help="Requirements constraint file passed to uv. May be used more than once.",
 )
+@click.option("--no-cache", is_flag=True, help="Avoid reading from or writing to the uv cache.")
+@click.option("--refresh", is_flag=True, help="Refresh all uv cached data.")
+@click.option(
+    "--refresh-package",
+    "refresh_packages",
+    multiple=True,
+    help="Refresh cached data for a package. May be used more than once.",
+)
+@click.option("--force", is_flag=True, help="Replace existing executable entries.")
+@click.option("--reinstall", is_flag=True, help="Reinstall all packages in the tool environment.")
 @click.option(
     "--uv-config-file",
     type=PATH,
@@ -238,8 +260,17 @@ def deploy_python(
     package: str,
     python: str | None,
     indexes: tuple[str, ...],
+    default_index: str | None,
     find_links: tuple[str, ...],
+    no_index: bool,
+    index_strategy: str | None,
+    keyring_provider: str | None,
     constraints: tuple[str, ...],
+    no_cache: bool,
+    refresh: bool,
+    refresh_packages: tuple[str, ...],
+    force: bool,
+    reinstall: bool,
     uv_config_file: Path | None,
     execute_install: bool,
 ) -> None:
@@ -257,8 +288,17 @@ def deploy_python(
         package: Package spec passed to `uv tool install`.
         python: Optional Python interpreter or version passed to uv.
         indexes: Additional package index URLs passed to uv.
+        default_index: Default package index URL passed to uv.
         find_links: Wheelhouse directories or HTML package pages passed to uv.
+        no_index: Whether uv should ignore registry indexes.
+        index_strategy: Package index strategy passed to uv.
+        keyring_provider: Keyring provider passed to uv.
         constraints: Requirements constraint files passed to uv.
+        no_cache: Whether uv should avoid reading from or writing to cache.
+        refresh: Whether uv should refresh cached data.
+        refresh_packages: Packages whose cached data uv should refresh.
+        force: Whether uv should replace existing executable entries.
+        reinstall: Whether uv should reinstall all packages.
         uv_config_file: Optional uv configuration file passed to `uv tool`.
         execute_install: Whether to run `uv tool install` immediately.
 
@@ -282,8 +322,17 @@ def deploy_python(
         homepage=homepage,
         python=python,
         indexes=indexes or config.indexes,
+        default_index=default_index,
         find_links=find_links or config.find_links,
+        no_index=no_index,
+        index_strategy=index_strategy,
+        keyring_provider=keyring_provider,
         constraints=constraints,
+        no_cache=no_cache,
+        refresh=refresh,
+        refresh_packages=refresh_packages,
+        force=force,
+        reinstall=reinstall,
         uv_config_file=(uv_config_file.expanduser() if uv_config_file else config.uv_config_file),
         execute_install=execute_install,
         make_default=make_default,

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/module_manager/deploy.py

@@ -72,8 +72,17 @@ class EnvironmentToolSpec:
         script: Shell script path to copy into the shared `bin` directory.
         python: Optional Python interpreter or version passed to uv.
         indexes: Additional package index URLs passed to uv.
+        default_index: Default package index URL passed to uv.
         find_links: Wheelhouse directories or HTML package pages passed to uv.
+        no_index: Whether uv should ignore registry indexes.
+        index_strategy: Package index strategy passed to uv.
+        keyring_provider: Keyring provider passed to uv.
         constraints: Constraint requirement files passed to uv.
+        no_cache: Whether uv should avoid reading from or writing to cache.
+        refresh: Whether uv should refresh cached data.
+        refresh_packages: Packages whose cached data uv should refresh.
+        force: Whether uv should replace existing executable entries.
+        reinstall: Whether uv should reinstall all packages.
         description: Optional tool description.
         homepage: Optional upstream homepage.
     """
@@ -87,8 +96,17 @@ class EnvironmentToolSpec:
     script: Path | None = None
     python: str | None = None
     indexes: tuple[str, ...] = ()
+    default_index: str | None = None
     find_links: tuple[str, ...] = ()
+    no_index: bool = False
+    index_strategy: str | None = None
+    keyring_provider: str | None = None
     constraints: tuple[str, ...] = ()
+    no_cache: bool = False
+    refresh: bool = False
+    refresh_packages: tuple[str, ...] = ()
+    force: bool = False
+    reinstall: bool = False
     description: str | None = None
     homepage: str | None = None
 
@@ -176,8 +194,17 @@ def uv_install_command(
     package: str,
     python: str | None = None,
     indexes: tuple[str, ...] = (),
+    default_index: str | None = None,
     find_links: tuple[str, ...] = (),
+    no_index: bool = False,
+    index_strategy: str | None = None,
+    keyring_provider: str | None = None,
     constraints: tuple[str, ...] = (),
+    no_cache: bool = False,
+    refresh: bool = False,
+    refresh_packages: tuple[str, ...] = (),
+    force: bool = False,
+    reinstall: bool = False,
     uv_config_file: Path | None = None,
 ) -> list[str]:
     """Build the uv command used to install a Python CLI tool.
@@ -186,8 +213,17 @@ def uv_install_command(
         package: Package spec passed to `uv tool install`.
         python: Optional Python interpreter or version passed to uv.
         indexes: Additional package index URLs.
+        default_index: Default package index URL.
         find_links: Wheelhouse directories or HTML package pages.
+        no_index: Whether to ignore registry indexes.
+        index_strategy: Package index strategy.
+        keyring_provider: Keyring provider.
         constraints: Constraint requirement files.
+        no_cache: Whether to avoid reading from or writing to cache.
+        refresh: Whether to refresh cached data.
+        refresh_packages: Packages whose cached data uv should refresh.
+        force: Whether to replace existing executable entries.
+        reinstall: Whether to reinstall all packages.
         uv_config_file: Optional uv configuration file passed to `uv tool`.
 
     Returns:
@@ -201,10 +237,28 @@ def uv_install_command(
         command.extend(["--python", python])
     for index in indexes:
         command.extend(["--index", index])
+    if default_index:
+        command.extend(["--default-index", default_index])
     for link in find_links:
         command.extend(["--find-links", link])
+    if no_index:
+        command.append("--no-index")
+    if index_strategy:
+        command.extend(["--index-strategy", index_strategy])
+    if keyring_provider:
+        command.extend(["--keyring-provider", keyring_provider])
     for constraint in constraints:
         command.extend(["--constraints", constraint])
+    if no_cache:
+        command.append("--no-cache")
+    if refresh:
+        command.append("--refresh")
+    for package_name in refresh_packages:
+        command.extend(["--refresh-package", package_name])
+    if force:
+        command.append("--force")
+    if reinstall:
+        command.append("--reinstall")
     command.append(package)
     return command
 
@@ -688,8 +742,17 @@ def parse_environment_tool(data: object, base_dir: Path, index: int) -> Environm
         script=optional_manifest_path(data, "script", base_dir),
         python=optional_string(data, "python"),
         indexes=optional_string_tuple(data, "indexes"),
+        default_index=optional_string(data, "default_index"),
         find_links=optional_string_tuple(data, "find_links"),
+        no_index=optional_bool(data, "no_index", False),
+        index_strategy=optional_string(data, "index_strategy"),
+        keyring_provider=optional_string(data, "keyring_provider"),
         constraints=tuple(str(path) for path in optional_manifest_paths(data, "constraints", base_dir)),
+        no_cache=optional_bool(data, "no_cache", False),
+        refresh=optional_bool(data, "refresh", False),
+        refresh_packages=optional_string_tuple(data, "refresh_packages"),
+        force=optional_bool(data, "force", False),
+        reinstall=optional_bool(data, "reinstall", False),
         description=optional_string(data, "description"),
         homepage=optional_string(data, "homepage"),
     )
@@ -747,8 +810,17 @@ def environment_actions(spec: EnvironmentSpec, paths: DeploymentPaths) -> tuple[
                 tool.package,
                 tool.python,
                 tool.indexes,
+                tool.default_index,
                 tool.find_links,
+                tool.no_index,
+                tool.index_strategy,
+                tool.keyring_provider,
                 tool.constraints,
+                tool.no_cache,
+                tool.refresh,
+                tool.refresh_packages,
+                tool.force,
+                tool.reinstall,
                 tool.uv_config_file,
             )
             actions.append(
@@ -806,8 +878,17 @@ def deploy_environment(
                     tool.package,
                     tool.python,
                     tool.indexes,
+                    tool.default_index,
                     tool.find_links,
+                    tool.no_index,
+                    tool.index_strategy,
+                    tool.keyring_provider,
                     tool.constraints,
+                    tool.no_cache,
+                    tool.refresh,
+                    tool.refresh_packages,
+                    tool.force,
+                    tool.reinstall,
                     tool.uv_config_file,
                 ),
                 check=True,
@@ -847,8 +928,17 @@ def deploy_python_tool(
     homepage: str | None = None,
     python: str | None = None,
     indexes: tuple[str, ...] = (),
+    default_index: str | None = None,
     find_links: tuple[str, ...] = (),
+    no_index: bool = False,
+    index_strategy: str | None = None,
+    keyring_provider: str | None = None,
     constraints: tuple[str, ...] = (),
+    no_cache: bool = False,
+    refresh: bool = False,
+    refresh_packages: tuple[str, ...] = (),
+    force: bool = False,
+    reinstall: bool = False,
     uv_config_file: Path | None = None,
     execute_install: bool = False,
     make_default: bool = True,
@@ -865,8 +955,17 @@ def deploy_python_tool(
         homepage: Optional upstream homepage shown in module help.
         python: Optional Python interpreter or version passed to uv.
         indexes: Additional package index URLs passed to uv.
+        default_index: Default package index URL passed to uv.
         find_links: Wheelhouse directories or HTML package pages passed to uv.
+        no_index: Whether uv should ignore registry indexes.
+        index_strategy: Package index strategy passed to uv.
+        keyring_provider: Keyring provider passed to uv.
         constraints: Constraint requirement files passed to uv.
+        no_cache: Whether uv should avoid reading from or writing to cache.
+        refresh: Whether uv should refresh cached data.
+        refresh_packages: Packages whose cached data uv should refresh.
+        force: Whether uv should replace existing executable entries.
+        reinstall: Whether uv should reinstall all packages.
         uv_config_file: Optional uv configuration file passed to `uv tool`.
         execute_install: Whether to run `uv tool install` immediately.
         make_default: Whether to make this version the module default.
@@ -882,7 +981,23 @@ def deploy_python_tool(
     paths = deployment_paths(module_root, prefix, name, version)
     paths.bin_dir.mkdir(parents=True, exist_ok=True)
     tool_dir = paths.install_root / "uv-tools"
-    command = uv_install_command(package, python, indexes, find_links, constraints, uv_config_file)
+    command = uv_install_command(
+        package,
+        python,
+        indexes,
+        default_index,
+        find_links,
+        no_index,
+        index_strategy,
+        keyring_provider,
+        constraints,
+        no_cache,
+        refresh,
+        refresh_packages,
+        force,
+        reinstall,
+        uv_config_file,
+    )
 
     if execute_install:
         require_executable("uv")

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "env-module-manager"
-version = "0.7.0"
+version = "0.8.0"
 description = "Deploy Python, Rust, shell, and collective CLI environments behind GNU environment modulefiles"
 readme = "README.md"
 requires-python = ">=3.11"

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/tests/test_cli.py

@@ -56,10 +56,23 @@ def test_deploy_python_command_writes_modulefile() -> None:
                 "modules",
                 "--index",
                 "https://packages.example/simple",
+                "--default-index",
+                "https://default.example/simple",
                 "--find-links",
                 "/prod/wheels",
+                "--no-index",
+                "--index-strategy",
+                "unsafe-first-match",
+                "--keyring-provider",
+                "subprocess",
                 "--constraints",
                 "/prod/constraints.txt",
+                "--no-cache",
+                "--refresh",
+                "--refresh-package",
+                "ruff",
+                "--force",
+                "--reinstall",
                 "--uv-config-file",
                 "/prod/uv.toml",
             ],
@@ -70,7 +83,16 @@ def test_deploy_python_command_writes_modulefile() -> None:
     assert "modulefile: modules/ruff/0.8.0" in result.output
     assert "default version: modules/ruff/.version" in result.output
     assert "--config-file /prod/uv.toml" in modulefile
+    assert "--default-index https://default.example/simple" in modulefile
+    assert "--no-index" in modulefile
+    assert "--index-strategy unsafe-first-match" in modulefile
+    assert "--keyring-provider subprocess" in modulefile
     assert "--constraints /prod/constraints.txt" in modulefile
+    assert "--no-cache" in modulefile
+    assert "--refresh" in modulefile
+    assert "--refresh-package ruff" in modulefile
+    assert "--force" in modulefile
+    assert "--reinstall" in modulefile
 
 
 def test_deploy_python_command_uses_config_defaults() -> None:
@@ -463,7 +485,13 @@ name = "ruff"
 version = "0.8.0"
 package = "ruff==0.8.0"
 indexes = ["https://packages.example/simple"]
+default_index = "https://default.example/simple"
+no_index = true
 constraints = ["constraints.txt"]
+no_cache = true
+refresh = true
+refresh_packages = ["ruff"]
+force = true
 """.strip(),
             encoding="utf-8",
         )
@@ -474,7 +502,13 @@ constraints = ["constraints.txt"]
     assert "would create install root: tools/dev-tools/2026.05" in result.output
     assert "would install python ruff:" in result.output
     assert "--index https://packages.example/simple" in result.output
+    assert "--default-index https://default.example/simple" in result.output
+    assert "--no-index" in result.output
     assert "--constraints constraints.txt" in result.output
+    assert "--no-cache" in result.output
+    assert "--refresh" in result.output
+    assert "--refresh-package ruff" in result.output
+    assert "--force" in result.output
     assert not install_root_exists
 
 

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/tests/test_modulefile.py

@@ -88,8 +88,17 @@ def test_python_tool_install_command_accepts_indexes() -> None:
     assert uv_install_command(
         "internal-tool==1.2.3",
         indexes=("https://packages.example/simple", "https://mirror.example/simple"),
+        default_index="https://default.example/simple",
         find_links=("/prod/wheels",),
+        no_index=True,
+        index_strategy="unsafe-best-match",
+        keyring_provider="subprocess",
         constraints=("/prod/constraints.txt",),
+        no_cache=True,
+        refresh=True,
+        refresh_packages=("internal-tool",),
+        force=True,
+        reinstall=True,
     ) == [
         "uv",
         "tool",
@@ -98,10 +107,23 @@ def test_python_tool_install_command_accepts_indexes() -> None:
         "https://packages.example/simple",
         "--index",
         "https://mirror.example/simple",
+        "--default-index",
+        "https://default.example/simple",
         "--find-links",
         "/prod/wheels",
+        "--no-index",
+        "--index-strategy",
+        "unsafe-best-match",
+        "--keyring-provider",
+        "subprocess",
         "--constraints",
         "/prod/constraints.txt",
+        "--no-cache",
+        "--refresh",
+        "--refresh-package",
+        "internal-tool",
+        "--force",
+        "--reinstall",
         "internal-tool==1.2.3",
     ]
 
@@ -268,16 +290,26 @@ def test_deploy_python_tool_writes_package_sources_to_install_hint(tmp_path: Pat
         module_root=tmp_path / "modules",
         prefix=tmp_path / "tools",
         indexes=("https://packages.example/simple",),
+        default_index="https://default.example/simple",
         find_links=("/prod/wheels",),
+        index_strategy="first-index",
+        keyring_provider="disabled",
         constraints=("/prod/constraints.txt",),
+        refresh_packages=("internal-tool",),
+        force=True,
         uv_config_file=Path("/prod/uv.toml"),
     )
 
     modulefile = paths.modulefile.read_text(encoding="utf-8")
     assert "--config-file /prod/uv.toml" in modulefile
     assert "--index https://packages.example/simple" in modulefile
+    assert "--default-index https://default.example/simple" in modulefile
     assert "--find-links /prod/wheels" in modulefile
+    assert "--index-strategy first-index" in modulefile
+    assert "--keyring-provider disabled" in modulefile
     assert "--constraints /prod/constraints.txt" in modulefile
+    assert "--refresh-package internal-tool" in modulefile
+    assert "--force" in modulefile
 
 
 def test_deploy_python_tool_writes_url_dependency_to_install_hint(tmp_path: Path) -> None:
@@ -536,8 +568,17 @@ version = "0.8.0"
 package = "ruff==0.8.0"
 python = "3.12"
 indexes = ["https://packages.example/simple"]
+default_index = "https://default.example/simple"
 find_links = ["/prod/wheels"]
+no_index = true
+index_strategy = "unsafe-best-match"
+keyring_provider = "subprocess"
 constraints = ["constraints.txt", "/prod/global-constraints.txt"]
+no_cache = true
+refresh = true
+refresh_packages = ["ruff"]
+force = true
+reinstall = true
 uv_config_file = "uv.toml"
 
 [[tools]]
@@ -557,7 +598,16 @@ script = "scripts/helper"
     assert not spec.make_default
     assert spec.tools[0].package == "ruff==0.8.0"
     assert spec.tools[0].indexes == ("https://packages.example/simple",)
+    assert spec.tools[0].default_index == "https://default.example/simple"
+    assert spec.tools[0].no_index
+    assert spec.tools[0].index_strategy == "unsafe-best-match"
+    assert spec.tools[0].keyring_provider == "subprocess"
     assert spec.tools[0].constraints == (str(tmp_path / "constraints.txt"), "/prod/global-constraints.txt")
+    assert spec.tools[0].no_cache
+    assert spec.tools[0].refresh
+    assert spec.tools[0].refresh_packages == ("ruff",)
+    assert spec.tools[0].force
+    assert spec.tools[0].reinstall
     assert spec.tools[0].uv_config_file == tmp_path / "uv.toml"
     assert spec.tools[1].script == tmp_path / "scripts/helper"
 
@@ -666,7 +716,13 @@ type = "python"
 name = "ruff"
 package = "ruff==0.8.0"
 python = "3.12"
+default_index = "https://default.example/simple"
+no_index = true
 constraints = ["constraints.txt"]
+no_cache = true
+refresh = true
+refresh_packages = ["ruff"]
+force = true
 uv_config_file = "uv.toml"
 """.strip(),
         encoding="utf-8",
@@ -687,8 +743,16 @@ uv_config_file = "uv.toml"
         "install",
         "--python",
         "3.12",
+        "--default-index",
+        "https://default.example/simple",
+        "--no-index",
         "--constraints",
         str(tmp_path / "constraints.txt"),
+        "--no-cache",
+        "--refresh",
+        "--refresh-package",
+        "ruff",
+        "--force",
         "ruff==0.8.0",
     ]
     assert calls[0][1]["UV_TOOL_DIR"] == str(result.paths.install_root / "uv-tools")

{env_module_manager-0.7.0 → env_module_manager-0.8.0}/uv.lock

@@ -344,7 +344,7 @@ wheels = [
 
 [[package]]
 name = "env-module-manager"
-version = "0.7.0"
+version = "0.8.0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

env_module_manager-0.7.0/docs/collective-environments.md

@@ -1,85 +0,0 @@
-# Collective Environments
-
-Collective environments package several tools behind one modulefile. Use them
-when a shared workflow needs Python CLIs, Rust binaries, and shell scripts to
-appear together from one `module load`.
-
-Create a TOML manifest:
-
-```toml
-name = "dev-tools"
-version = "2026.05"
-description = "Shared developer command-line tools"
-prefix = "/prod/tools"
-module_root = "/prod/modulefiles"
-default = true
-
-[[tools]]
-type = "python"
-name = "ruff"
-version = "0.8.0"
-package = "ruff==0.8.0"
-python = "3.12"
-indexes = ["https://packages.example/simple"]
-find_links = ["/prod/wheels"]
-constraints = ["/prod/constraints/runtime.txt"]
-uv_config_file = "/prod/config/uv.toml"
-
-[[tools]]
-type = "rust"
-name = "ripgrep"
-version = "14.1.1"
-binary = "./target/release/rg"
-
-[[tools]]
-type = "script"
-name = "lab-helper"
-version = "1.0.0"
-script = "./scripts/lab-helper"
-```
-
-Deploy the environment:
-
-```sh
-module-manager deploy-env --file dev-tools.toml
-```
-
-This writes one shared environment:
-
-```text
-/prod/tools/dev-tools/2026.05/bin
-/prod/modulefiles/dev-tools/2026.05
-```
-
-The generated modulefile prepends the shared `bin` directory to `PATH`, so all
-tools in the manifest are available after:
-
-```sh
-module use /prod/modulefiles
-module load dev-tools
-```
-
-Relative `binary` and `script` paths are resolved relative to the manifest file.
-Relative Python `constraints` paths are resolved the same way.
-
-## Preview
-
-Use `--dry-run` to preview the install, copy, and modulefile actions without
-creating files:
-
-```sh
-module-manager deploy-env --file dev-tools.toml --dry-run
-```
-
-## Overrides
-
-The manifest can define `prefix`, `module_root`, and `default`, but CLI options
-can override them:
-
-```sh
-module-manager deploy-env \
-  --file dev-tools.toml \
-  --prefix /scratch/tools \
-  --module-root /scratch/modulefiles \
-  --no-default
-```