env-module-manager 0.5.0__tar.gz → 0.6.0__tar.gz

{env_module_manager-0.5.0 → env_module_manager-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: env-module-manager
-Version: 0.5.0
+Version: 0.6.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' \
+  --constraints /prod/constraints/runtime.txt \
   --prefix /prod/tools \
   --module-root /prod/modulefiles \
   --execute-install

{env_module_manager-0.5.0 → env_module_manager-0.6.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' \
+  --constraints /prod/constraints/runtime.txt \
   --prefix /prod/tools \
   --module-root /prod/modulefiles \
   --execute-install

{env_module_manager-0.5.0 → env_module_manager-0.6.0}/docs/collective-environments.md

@@ -22,6 +22,7 @@ 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]]
@@ -59,6 +60,7 @@ 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
 

{env_module_manager-0.5.0 → env_module_manager-0.6.0}/docs/python-tools.md

@@ -55,6 +55,21 @@ module-manager deploy-python gitconductor 0.1.0 \
 
 `--find-links` may be used more than once.
 
+## Use Constraint Files
+
+Pass requirement constraint files to `uv tool install`:
+
+```sh
+module-manager deploy-python gitconductor 0.1.0 \
+  --package gitconductor==0.1.0 \
+  --constraints /prod/constraints/runtime.txt \
+  --prefix /prod/tools \
+  --module-root /prod/modulefiles \
+  --execute-install
+```
+
+`--constraints` may be used more than once.
+
 ## Use a uv Config File
 
 Pass a specific uv configuration file to `uv tool install`:

{env_module_manager-0.5.0 → env_module_manager-0.6.0}/docs/reference.md

@@ -44,6 +44,7 @@ module-manager deploy-python NAME VERSION \
   [--python PYTHON] \
   [--index URL] \
   [--find-links PATH_OR_URL] \
+  [--constraints PATH] \
   [--uv-config-file PATH] \
   [--prefix PATH] \
   [--module-root PATH] \

{env_module_manager-0.5.0 → env_module_manager-0.6.0}/module_manager/__init__.py

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

{env_module_manager-0.5.0 → env_module_manager-0.6.0}/module_manager/cli.py

@@ -199,6 +199,12 @@ def main(ctx: click.Context, config: Path | None) -> None:
     multiple=True,
     help="Directory or HTML page of packages passed to uv. May be used more than once.",
 )
+@click.option(
+    "--constraints",
+    "constraints",
+    multiple=True,
+    help="Requirements constraint file passed to uv. May be used more than once.",
+)
 @click.option(
     "--uv-config-file",
     type=PATH,
@@ -223,6 +229,7 @@ def deploy_python(
     python: str | None,
     indexes: tuple[str, ...],
     find_links: tuple[str, ...],
+    constraints: tuple[str, ...],
     uv_config_file: Path | None,
     execute_install: bool,
 ) -> None:
@@ -241,6 +248,7 @@ def deploy_python(
         python: Optional Python interpreter or version passed to uv.
         indexes: Additional package index URLs passed to uv.
         find_links: Wheelhouse directories or HTML package pages passed to uv.
+        constraints: Requirements constraint files passed to uv.
         uv_config_file: Optional uv configuration file passed to `uv tool`.
         execute_install: Whether to run `uv tool install` immediately.
 
@@ -265,6 +273,7 @@ def deploy_python(
         python=python,
         indexes=indexes or config.indexes,
         find_links=find_links or config.find_links,
+        constraints=constraints,
         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.5.0 → env_module_manager-0.6.0}/module_manager/deploy.py

@@ -68,6 +68,7 @@ class EnvironmentToolSpec:
         python: Optional Python interpreter or version passed to uv.
         indexes: Additional package index URLs passed to uv.
         find_links: Wheelhouse directories or HTML package pages passed to uv.
+        constraints: Constraint requirement files passed to uv.
         description: Optional tool description.
         homepage: Optional upstream homepage.
     """
@@ -82,6 +83,7 @@ class EnvironmentToolSpec:
     python: str | None = None
     indexes: tuple[str, ...] = ()
     find_links: tuple[str, ...] = ()
+    constraints: tuple[str, ...] = ()
     description: str | None = None
     homepage: str | None = None
 
@@ -150,6 +152,7 @@ def uv_install_command(
     python: str | None = None,
     indexes: tuple[str, ...] = (),
     find_links: tuple[str, ...] = (),
+    constraints: tuple[str, ...] = (),
     uv_config_file: Path | None = None,
 ) -> list[str]:
     """Build the uv command used to install a Python CLI tool.
@@ -159,6 +162,7 @@ def uv_install_command(
         python: Optional Python interpreter or version passed to uv.
         indexes: Additional package index URLs.
         find_links: Wheelhouse directories or HTML package pages.
+        constraints: Constraint requirement files.
         uv_config_file: Optional uv configuration file passed to `uv tool`.
 
     Returns:
@@ -174,6 +178,8 @@ def uv_install_command(
         command.extend(["--index", index])
     for link in find_links:
         command.extend(["--find-links", link])
+    for constraint in constraints:
+        command.extend(["--constraints", constraint])
     command.append(package)
     return command
 
@@ -400,6 +406,29 @@ def optional_manifest_path(data: dict[str, Any], key: str, base_dir: Path | None
     return path
 
 
+def optional_manifest_paths(data: dict[str, Any], key: str, base_dir: Path | None = None) -> tuple[Path, ...]:
+    """Read optional paths from manifest data.
+
+    Args:
+        data: Manifest table.
+        key: Optional path-list key.
+        base_dir: Directory used to resolve relative paths.
+
+    Returns:
+        Expanded path values, or an empty tuple.
+
+    Raises:
+        TypeError: If the value is not a list of strings.
+    """
+    paths = []
+    for value in optional_string_tuple(data, key):
+        path = Path(value).expanduser()
+        if base_dir and not path.is_absolute():
+            path = base_dir / path
+        paths.append(path)
+    return tuple(paths)
+
+
 def optional_string_tuple(data: dict[str, Any], key: str) -> tuple[str, ...]:
     """Read an optional list of strings from manifest data.
 
@@ -512,6 +541,7 @@ def parse_environment_tool(data: object, base_dir: Path, index: int) -> Environm
         python=optional_string(data, "python"),
         indexes=optional_string_tuple(data, "indexes"),
         find_links=optional_string_tuple(data, "find_links"),
+        constraints=tuple(str(path) for path in optional_manifest_paths(data, "constraints", base_dir)),
         description=optional_string(data, "description"),
         homepage=optional_string(data, "homepage"),
     )
@@ -570,6 +600,7 @@ def environment_actions(spec: EnvironmentSpec, paths: DeploymentPaths) -> tuple[
                 tool.python,
                 tool.indexes,
                 tool.find_links,
+                tool.constraints,
                 tool.uv_config_file,
             )
             actions.append(
@@ -628,6 +659,7 @@ def deploy_environment(
                     tool.python,
                     tool.indexes,
                     tool.find_links,
+                    tool.constraints,
                     tool.uv_config_file,
                 ),
                 check=True,
@@ -668,6 +700,7 @@ def deploy_python_tool(
     python: str | None = None,
     indexes: tuple[str, ...] = (),
     find_links: tuple[str, ...] = (),
+    constraints: tuple[str, ...] = (),
     uv_config_file: Path | None = None,
     execute_install: bool = False,
     make_default: bool = True,
@@ -685,6 +718,7 @@ def deploy_python_tool(
         python: Optional Python interpreter or version passed to uv.
         indexes: Additional package index URLs passed to uv.
         find_links: Wheelhouse directories or HTML package pages passed to uv.
+        constraints: Constraint requirement files passed to uv.
         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.
@@ -700,7 +734,7 @@ 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, uv_config_file)
+    command = uv_install_command(package, python, indexes, find_links, constraints, uv_config_file)
 
     if execute_install:
         require_executable("uv")

{env_module_manager-0.5.0 → env_module_manager-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "env-module-manager"
-version = "0.5.0"
+version = "0.6.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.5.0 → env_module_manager-0.6.0}/tests/test_cli.py

@@ -56,6 +56,8 @@ def test_deploy_python_command_writes_modulefile() -> None:
                 "https://packages.example/simple",
                 "--find-links",
                 "/prod/wheels",
+                "--constraints",
+                "/prod/constraints.txt",
                 "--uv-config-file",
                 "/prod/uv.toml",
             ],
@@ -66,6 +68,7 @@ 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 "--constraints /prod/constraints.txt" in modulefile
 
 
 def test_deploy_python_command_uses_config_defaults() -> None:
@@ -408,6 +411,7 @@ name = "ruff"
 version = "0.8.0"
 package = "ruff==0.8.0"
 indexes = ["https://packages.example/simple"]
+constraints = ["constraints.txt"]
 """.strip(),
             encoding="utf-8",
         )
@@ -418,6 +422,7 @@ indexes = ["https://packages.example/simple"]
     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 "--constraints constraints.txt" in result.output
     assert not install_root_exists
 
 

env_module_manager-0.6.0/tests/test_integration.py

@@ -0,0 +1,138 @@
+"""Integration tests that execute external deployment tools."""
+
+import subprocess
+from pathlib import Path
+
+import pytest
+from click.testing import CliRunner
+
+from module_manager.cli import main
+
+
+@pytest.mark.integration
+def test_deploy_python_real_uv_install_uses_cli_roots(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    """A real uv install should use the CLI prefix and module root.
+
+    Args:
+        tmp_path: Temporary deployment root.
+        monkeypatch: Pytest helper used to control inherited uv destinations.
+    """
+    project_root = Path(__file__).parent.parent
+    prefix = tmp_path / "tools"
+    module_root = tmp_path / "modules"
+    inherited_tool_dir = tmp_path / "inherited-tools"
+    inherited_bin_dir = tmp_path / "inherited-bin"
+    monkeypatch.setenv("UV_TOOL_DIR", str(inherited_tool_dir))
+    monkeypatch.setenv("UV_TOOL_BIN_DIR", str(inherited_bin_dir))
+
+    result = CliRunner().invoke(
+        main,
+        [
+            "deploy-python",
+            "module-manager",
+            "0.6.0",
+            "--package",
+            str(project_root),
+            "--prefix",
+            str(prefix),
+            "--module-root",
+            str(module_root),
+            "--execute-install",
+        ],
+    )
+
+    install_root = prefix / "module-manager" / "0.6.0"
+    assert result.exit_code == 0, result.output
+    assert (install_root / "bin" / "module-manager").exists()
+    assert (install_root / "uv-tools" / "env-module-manager" / "uv-receipt.toml").exists()
+    assert (module_root / "module-manager" / "0.6.0").is_file()
+    assert not inherited_tool_dir.exists()
+    assert not inherited_bin_dir.exists()
+
+
+@pytest.mark.integration
+def test_deploy_python_real_uv_install_handles_url_dependency(tmp_path: Path) -> None:
+    """A real uv install should resolve and run direct URL dependencies.
+
+    Args:
+        tmp_path: Temporary deployment root.
+    """
+    dependency = tmp_path / "url-dependency"
+    dependency.mkdir()
+    (dependency / "pyproject.toml").write_text(
+        """
+[project]
+name = "url-dependency"
+version = "1.0.0"
+requires-python = ">=3.11"
+""".strip(),
+        encoding="utf-8",
+    )
+    dependency_package = dependency / "url_dependency"
+    dependency_package.mkdir()
+    (dependency_package / "__init__.py").write_text(
+        """
+def message() -> str:
+    return "url dependency works"
+""".strip(),
+        encoding="utf-8",
+    )
+
+    tool = tmp_path / "url-tool"
+    tool.mkdir()
+    (tool / "pyproject.toml").write_text(
+        f"""
+[project]
+name = "url-tool"
+version = "1.0.0"
+requires-python = ">=3.11"
+dependencies = [
+    "url-dependency @ {dependency.as_uri()}",
+]
+
+[project.scripts]
+url-tool = "url_tool:main"
+""".strip(),
+        encoding="utf-8",
+    )
+    tool_package = tool / "url_tool"
+    tool_package.mkdir()
+    (tool_package / "__init__.py").write_text(
+        """
+from url_dependency import message
+
+
+def main() -> None:
+    print(message())
+""".strip(),
+        encoding="utf-8",
+    )
+
+    prefix = tmp_path / "tools"
+    module_root = tmp_path / "modules"
+    result = CliRunner().invoke(
+        main,
+        [
+            "deploy-python",
+            "url-tool",
+            "1.0.0",
+            "--package",
+            str(tool),
+            "--prefix",
+            str(prefix),
+            "--module-root",
+            str(module_root),
+            "--execute-install",
+        ],
+    )
+
+    executable = prefix / "url-tool" / "1.0.0" / "bin" / "url-tool"
+    assert result.exit_code == 0, result.output
+    assert executable.exists()
+    completed = subprocess.run(
+        [str(executable)],
+        check=True,
+        capture_output=True,
+        text=True,
+    )
+    assert completed.stdout.strip() == "url dependency works"

{env_module_manager-0.5.0 → env_module_manager-0.6.0}/tests/test_modulefile.py

@@ -1,6 +1,7 @@
 """Modulefile rendering and deployment helper tests."""
 
 from pathlib import Path
+from shlex import quote as shlex_quote
 
 import pytest
 
@@ -84,6 +85,7 @@ def test_python_tool_install_command_accepts_indexes() -> None:
         "internal-tool==1.2.3",
         indexes=("https://packages.example/simple", "https://mirror.example/simple"),
         find_links=("/prod/wheels",),
+        constraints=("/prod/constraints.txt",),
     ) == [
         "uv",
         "tool",
@@ -94,6 +96,8 @@ def test_python_tool_install_command_accepts_indexes() -> None:
         "https://mirror.example/simple",
         "--find-links",
         "/prod/wheels",
+        "--constraints",
+        "/prod/constraints.txt",
         "internal-tool==1.2.3",
     ]
 
@@ -122,6 +126,20 @@ def test_python_tool_install_command_accepts_uv_config_file() -> None:
     ]
 
 
+def test_python_tool_install_command_accepts_url_dependency() -> None:
+    """Uv install commands should pass direct URL dependencies unchanged."""
+    package = "mytool @ https://packages.example/files/mytool-1.0.0-py3-none-any.whl"
+
+    assert uv_install_command(package, constraints=("/prod/constraints.txt",)) == [
+        "uv",
+        "tool",
+        "install",
+        "--constraints",
+        "/prod/constraints.txt",
+        package,
+    ]
+
+
 def test_uv_install_environment_ignores_inherited_uv_tool_settings(
     tmp_path: Path, monkeypatch: pytest.MonkeyPatch
 ) -> None:
@@ -158,6 +176,7 @@ def test_deploy_python_tool_writes_package_sources_to_install_hint(tmp_path: Pat
         prefix=tmp_path / "tools",
         indexes=("https://packages.example/simple",),
         find_links=("/prod/wheels",),
+        constraints=("/prod/constraints.txt",),
         uv_config_file=Path("/prod/uv.toml"),
     )
 
@@ -165,6 +184,28 @@ def test_deploy_python_tool_writes_package_sources_to_install_hint(tmp_path: Pat
     assert "--config-file /prod/uv.toml" in modulefile
     assert "--index https://packages.example/simple" in modulefile
     assert "--find-links /prod/wheels" in modulefile
+    assert "--constraints /prod/constraints.txt" in modulefile
+
+
+def test_deploy_python_tool_writes_url_dependency_to_install_hint(tmp_path: Path) -> None:
+    """Generated module help should preserve direct URL package specs.
+
+    Args:
+        tmp_path: Temporary deployment root.
+    """
+    package = "mytool @ https://packages.example/files/mytool-1.0.0-py3-none-any.whl"
+    paths = deploy_python_tool(
+        name="mytool",
+        version="1.0.0",
+        package=package,
+        module_root=tmp_path / "modules",
+        prefix=tmp_path / "tools",
+        constraints=("/prod/constraints.txt",),
+    )
+
+    modulefile = paths.modulefile.read_text(encoding="utf-8")
+    assert shlex_quote(package) in modulefile
+    assert "--constraints /prod/constraints.txt" in modulefile
 
 
 def test_require_executable_reports_missing_command(monkeypatch: pytest.MonkeyPatch) -> None:
@@ -403,6 +444,7 @@ package = "ruff==0.8.0"
 python = "3.12"
 indexes = ["https://packages.example/simple"]
 find_links = ["/prod/wheels"]
+constraints = ["constraints.txt", "/prod/global-constraints.txt"]
 uv_config_file = "uv.toml"
 
 [[tools]]
@@ -422,6 +464,7 @@ 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].constraints == (str(tmp_path / "constraints.txt"), "/prod/global-constraints.txt")
     assert spec.tools[0].uv_config_file == tmp_path / "uv.toml"
     assert spec.tools[1].script == tmp_path / "scripts/helper"
 
@@ -530,6 +573,7 @@ type = "python"
 name = "ruff"
 package = "ruff==0.8.0"
 python = "3.12"
+constraints = ["constraints.txt"]
 uv_config_file = "uv.toml"
 """.strip(),
         encoding="utf-8",
@@ -550,6 +594,8 @@ uv_config_file = "uv.toml"
         "install",
         "--python",
         "3.12",
+        "--constraints",
+        str(tmp_path / "constraints.txt"),
         "ruff==0.8.0",
     ]
     assert calls[0][1]["UV_TOOL_DIR"] == str(result.paths.install_root / "uv-tools")

{env_module_manager-0.5.0 → env_module_manager-0.6.0}/uv.lock

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

env_module_manager-0.5.0/tests/test_integration.py

@@ -1,49 +0,0 @@
-"""Integration tests that execute external deployment tools."""
-
-from pathlib import Path
-
-import pytest
-from click.testing import CliRunner
-
-from module_manager.cli import main
-
-
-@pytest.mark.integration
-def test_deploy_python_real_uv_install_uses_cli_roots(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
-    """A real uv install should use the CLI prefix and module root.
-
-    Args:
-        tmp_path: Temporary deployment root.
-        monkeypatch: Pytest helper used to control inherited uv destinations.
-    """
-    project_root = Path(__file__).parent.parent
-    prefix = tmp_path / "tools"
-    module_root = tmp_path / "modules"
-    inherited_tool_dir = tmp_path / "inherited-tools"
-    inherited_bin_dir = tmp_path / "inherited-bin"
-    monkeypatch.setenv("UV_TOOL_DIR", str(inherited_tool_dir))
-    monkeypatch.setenv("UV_TOOL_BIN_DIR", str(inherited_bin_dir))
-
-    result = CliRunner().invoke(
-        main,
-        [
-            "deploy-python",
-            "module-manager",
-            "0.5.0",
-            "--package",
-            str(project_root),
-            "--prefix",
-            str(prefix),
-            "--module-root",
-            str(module_root),
-            "--execute-install",
-        ],
-    )
-
-    install_root = prefix / "module-manager" / "0.5.0"
-    assert result.exit_code == 0, result.output
-    assert (install_root / "bin" / "module-manager").exists()
-    assert (install_root / "uv-tools" / "env-module-manager" / "uv-receipt.toml").exists()
-    assert (module_root / "module-manager" / "0.5.0").is_file()
-    assert not inherited_tool_dir.exists()
-    assert not inherited_bin_dir.exists()