fix(pygit2) migrate ls_remotes to list_heads

Author: shcheklein

pyproject.toml

@@ -26,7 +26,8 @@ dynamic = ["version"]
 dependencies = [
     "gitpython>3",
     "dulwich>=0.24.0",
-    "pygit2>=1.14.0",
+    "pygit2>=1.14.0,<1.19.0; python_version < '3.11'",
+    "pygit2>=1.19.0; python_version >= '3.11'",
     "pygtrie>=2.3.2",
     "fsspec[tqdm]>=2024.2.0",
     "pathspec>=0.9.0",

src/scmrepo/git/backend/pygit2/__init__.py

@@ -2,6 +2,7 @@
 import logging
 import os
 import stat
+import sys
 from collections.abc import Iterable, Iterator, Mapping
 from contextlib import contextmanager
 from io import BytesIO, StringIO, TextIOWrapper
@@ -731,14 +732,21 @@ def _default_status(
                 SCMError(f"Git failed to fetch ref from '{url}'"),
             ):
                 with RemoteCallbacks(progress=progress) as cb:
-                    remote_refs: dict[str, Oid] = (
-                        {
-                            head["name"]: head["oid"]
-                            for head in remote.ls_remotes(callbacks=cb, proxy=True)
-                        }
-                        if not force
-                        else {}
-                    )
+                    remote_refs: dict[str, Oid] = {}
+                    if not force:
+                        # pygit2 1.19.0 deprecated ls_remotes() in favor of list_heads()
+                        # but 1.19.0+ requires Python 3.11+
+                        if sys.version_info >= (3, 11):
+                            for head in remote.list_heads(callbacks=cb, proxy=True):
+                                assert head.name is not None
+                                remote_refs[head.name] = head.oid
+                        else:
+                            remote_refs = {
+                                head["name"]: head["oid"]
+                                for head in remote.ls_remotes(  # type: ignore[attr-defined]
+                                    callbacks=cb, proxy=True
+                                )
+                            }
                     remote.fetch(
                         refspecs=refspecs, callbacks=cb, message="fetch", proxy=True
                     )