Skip to content

Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.

3.0 KB
Raw Blame
"""A fetched package is read from its commit's git objects, never from the clone's working tree.

The clone cache is stubbed with a local git repository (`install_method_package` in conftest). These pin what the
commit holds against what the working tree holds: a file left uncommitted is no file of the package, a committed
symbolic link is refused, named by its path in the package and the package's address, and the tree's digest rides the
provenance.
"""

import subprocess
import tempfile
from collections.abc import Callable
from pathlib import Path

import pytest
from mthds.method_tree.digest import digest_of_contents
from pipelex.methods.exceptions import MethodPackageSymlinkError

from pipelex_api.method_source import fetched_method
from tests.unit._constants import STUB_METHOD_ADDRESS, STUB_METHOD_MANIFEST, VALID_MTHDS

_METHOD_REF = f"{STUB_METHOD_ADDRESS}@v0.1.0"


def _commit_all(*, package_dir: Path) -> None:
    clone_root = package_dir.parent.parent
    git_identity = ["-c", "user.name=stub", "-c", "[email protected]", "-c", "commit.gpgsign=false"]
    for args in (["add", "--all"], [*git_identity, "commit", "--quiet", "-m", "more"]):
        subprocess.run(["git", "-C", str(clone_root), *args], check=True, capture_output=True)  # noqa: S603, S607


class TestMethodSourceGit:
    def test_the_package_is_its_commits_files_and_its_digest_rides_the_provenance(self, install_method_package: Callable[..., Path]) -> None:
        package_dir = install_method_package(files={"documents.mthds": VALID_MTHDS, "templates/invoice.html": "<h1>Invoice</h1>"})
        # Written after the commit, in the clone's working tree only.
        (package_dir / "uncommitted.txt").write_text("not in the commit", encoding="utf-8")
        (package_dir / "documents.mthds").write_text("edited after the commit", encoding="utf-8")

        fetched = fetched_method(_METHOD_REF)

        contents = fetched.request_method.tree.contents
        assert contents == {
            "METHODS.toml": STUB_METHOD_MANIFEST.encode("utf-8"),
            "documents.mthds": VALID_MTHDS.encode("utf-8"),
            "templates/invoice.html": b"<h1>Invoice</h1>",
        }
        assert fetched.request_method.dependencies == {}
        assert fetched.provenance.tree_digest == digest_of_contents(contents)
        assert fetched.label == f"'{STUB_METHOD_ADDRESS}'"

    def test_a_committed_symbolic_link_is_refused_by_tree_path_and_address(self, install_method_package: Callable[..., Path]) -> None:
        package_dir = install_method_package(files={"documents.mthds": VALID_MTHDS})
        (package_dir / "linked.mthds").symlink_to("documents.mthds")
        _commit_all(package_dir=package_dir)

        with pytest.raises(MethodPackageSymlinkError) as exc_info:
            fetched_method(_METHOD_REF)

        message = str(exc_info.value)
        assert "linked.mthds" in message
        assert STUB_METHOD_ADDRESS in message
        assert "pipelex-package-" not in message
        assert tempfile.gettempdir() not in message