Fix uv lock check header comparison (#2317)

Co-authored-by: cyphercodes <cyphercodes@users.noreply.github.com>

Author: cyphercodes

src/hatch/env/lockers/uv.py

@@ -12,6 +12,22 @@
     from hatch.env.virtual import VirtualEnvironment
 
 
+_UV_GENERATED_HEADER = "# This file was autogenerated by uv via the following command:"
+_UV_COMMAND_PREFIX = "#    "
+
+
+def _strip_uv_generated_header(contents: str) -> str:
+    lines = contents.splitlines(keepends=True)
+    if not lines or lines[0].rstrip("\r\n") != _UV_GENERATED_HEADER:
+        return contents
+
+    index = 1
+    while index < len(lines) and lines[index].startswith(_UV_COMMAND_PREFIX):
+        index += 1
+
+    return "".join(lines[index:])
+
+
 class UvLocker(LockerInterface):
     PLUGIN_NAME = "uv"
 
@@ -140,7 +156,7 @@ def in_sync(
             existing = output_path.read_text(encoding="utf-8")
             fresh = temp_path.read_text(encoding="utf-8")
 
-        return existing == fresh
+        return _strip_uv_generated_header(existing) == _strip_uv_generated_header(fresh)
 
     @classmethod
     def apply_lock(cls, environment: EnvironmentInterface, lock_path: Path) -> None:

tests/cli/env/test_lock.py

@@ -4,6 +4,7 @@
 import tomli_w
 
 from hatch.config.constants import ConfigEnvVars
+from hatch.env.lockers.uv import UvLocker
 from hatch.project.core import Project
 from hatch.utils.toml import load_toml_file
 
@@ -372,6 +373,46 @@ def test_check_exists(hatch, helpers, temp_dir, config_file):
     assert "Lockfile is up to date" in result.output
 
 
+def test_uv_in_sync_ignores_autogenerated_command_header(helpers, monkeypatch, temp_dir):
+    lock_path = temp_dir / "pylock.toml"
+    lock_body = helpers.dedent(
+        """
+        lock-version = "1.0"
+        created-by = "uv"
+
+        [[packages]]
+        name = "click"
+        version = "8.4.1"
+        """
+    )
+    lock_path.write_text(
+        helpers.dedent(
+            """
+            # This file was autogenerated by uv via the following command:
+            #    uv pip compile /tmp/requirements.txt --output-file /project/pylock.toml
+            """
+        )
+        + lock_body,
+        encoding="utf-8",
+    )
+
+    def generate(_cls, _environment, _dependencies, output_path, **_kwargs):
+        output_path.write_text(
+            helpers.dedent(
+                """
+                # This file was autogenerated by uv via the following command:
+                #    uv pip compile /tmp/tmpabc/requirements.txt --output-file /tmp/tmpabc/pylock.toml
+                """
+            )
+            + lock_body,
+            encoding="utf-8",
+        )
+
+    monkeypatch.setattr(UvLocker, "generate", classmethod(generate))
+
+    assert UvLocker.in_sync(object(), [], lock_path)
+
+
 @pytest.mark.usefixtures("mock_locker")
 def test_check_lockfile_stale(hatch, helpers, temp_dir, config_file):
     config_file.model.template.plugins["default"]["tests"] = False