scmrepo 2.0.4__tar.gz → 3.3.1__tar.gz

{scmrepo-2.0.4 → scmrepo-3.3.1}/.github/workflows/release.yaml

@@ -17,12 +17,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - name: Check out the repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         fetch-depth: 0
 
     - name: Set up Python 3.10
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: '3.10'
 

{scmrepo-2.0.4 → scmrepo-3.3.1}/.github/workflows/tests.yaml

@@ -21,16 +21,16 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-20.04, windows-latest, macos-latest]
-        pyv: ['3.8', '3.9', '3.10', '3.11']
+        pyv: ['3.9', '3.10', '3.11', '3.12']
 
     steps:
     - name: Check out the repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         fetch-depth: 0
 
     - name: Set up Python ${{ matrix.pyv }}
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.pyv }}
 

{scmrepo-2.0.4 → scmrepo-3.3.1}/.pre-commit-config.yaml

@@ -20,7 +20,7 @@ repos:
       - id: sort-simple-yaml
       - id: trailing-whitespace
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 'v0.1.13'
+    rev: 'v0.3.3'
     hooks:
       - id: ruff
         args: [--fix, --exit-non-zero-on-fix]

{scmrepo-2.0.4 → scmrepo-3.3.1}/CONTRIBUTING.rst

@@ -41,7 +41,7 @@ Request features on the `Issue Tracker`_.
 How to set up your development environment
 ------------------------------------------
 
-You need Python 3.8+ and the following tools:
+You need Python 3.9+ and the following tools:
 
 - Nox_
 

{scmrepo-2.0.4/src/scmrepo.egg-info → scmrepo-3.3.1}/PKG-INFO

@@ -1,47 +1,47 @@
 Metadata-Version: 2.1
 Name: scmrepo
-Version: 2.0.4
+Version: 3.3.1
 Summary: scmrepo
 Author-email: Iterative <support@dvc.org>
 License: Apache-2.0
 Project-URL: Issues, https://github.com/iterative/scmrepo/issues
 Project-URL: Source, https://github.com/iterative/scmrepo
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Development Status :: 4 - Beta
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: gitpython>3
 Requires-Dist: dulwich>=0.21.6
-Requires-Dist: pygit2>=1.13.3
+Requires-Dist: pygit2>=1.14.0
 Requires-Dist: pygtrie>=2.3.2
-Requires-Dist: fsspec>=2021.7.0
+Requires-Dist: fsspec[tqdm]>=2024.2.0
 Requires-Dist: pathspec>=0.9.0
 Requires-Dist: asyncssh<3,>=2.13.1
 Requires-Dist: funcy>=1.14
-Requires-Dist: shortuuid>=0.5.0
-Requires-Dist: dvc-objects<4,>=3
-Requires-Dist: dvc-http>=2.29.0
+Requires-Dist: aiohttp-retry>=2.5.0
+Requires-Dist: tqdm
 Provides-Extra: tests
-Requires-Dist: pytest==7.2.0; extra == "tests"
-Requires-Dist: pytest-sugar==0.9.5; extra == "tests"
-Requires-Dist: pytest-cov==3.0.0; extra == "tests"
-Requires-Dist: pytest-mock==3.8.2; extra == "tests"
-Requires-Dist: mypy==0.971; extra == "tests"
-Requires-Dist: pytest-test-utils==0.0.8; extra == "tests"
-Requires-Dist: pytest-asyncio==0.18.3; extra == "tests"
-Requires-Dist: pytest-docker==0.12.0; (python_version < "3.10" and implementation_name != "pypy") and extra == "tests"
-Requires-Dist: mock==5.1.0; extra == "tests"
-Requires-Dist: paramiko==3.3.1; extra == "tests"
-Requires-Dist: types-certifi==2021.10.8.3; extra == "tests"
-Requires-Dist: types-mock==5.1.0.2; extra == "tests"
-Requires-Dist: types-paramiko==3.4.0.20240120; extra == "tests"
+Requires-Dist: aioresponses<0.8,>=0.7; extra == "tests"
+Requires-Dist: paramiko<4,>=3.4.0; extra == "tests"
+Requires-Dist: pytest<9,>=7; extra == "tests"
+Requires-Dist: pytest-asyncio<1,>=0.23.2; extra == "tests"
+Requires-Dist: pytest-cov>=4.1.0; extra == "tests"
+Requires-Dist: pytest-docker<4,>=1; extra == "tests"
+Requires-Dist: pytest-mock; extra == "tests"
+Requires-Dist: pytest-sugar; extra == "tests"
+Requires-Dist: pytest-test-utils<0.2,>=0.1.0; extra == "tests"
 Provides-Extra: dev
+Requires-Dist: mypy==1.9.0; extra == "dev"
 Requires-Dist: scmrepo[tests]; extra == "dev"
+Requires-Dist: types-certifi; extra == "dev"
+Requires-Dist: types-mock; extra == "dev"
+Requires-Dist: types-paramiko; extra == "dev"
+Requires-Dist: types-tqdm; extra == "dev"
 
 scmrepo
 =======

{scmrepo-2.0.4 → scmrepo-3.3.1}/noxfile.py

@@ -1,4 +1,5 @@
 """Automation using nox."""
+
 import glob
 import os
 
@@ -9,7 +10,7 @@ nox.options.sessions = "lint", "tests"
 locations = "src", "tests"
 
 
-@nox.session(python=["3.8", "3.9", "3.10", "3.11"])
+@nox.session(python=["3.9", "3.10", "3.11", "3.12"])
 def tests(session: nox.Session) -> None:
     session.install(".[tests]")
     session.run(

{scmrepo-2.0.4 → scmrepo-3.3.1}/pyproject.toml

@@ -12,26 +12,25 @@ license = {text = "Apache-2.0"}
 authors = [{ name = "Iterative", email = "support@dvc.org" }]
 classifiers = [
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Development Status :: 4 - Beta",
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 dynamic = ["version"]
 dependencies = [
     "gitpython>3",
     "dulwich>=0.21.6",
-    "pygit2>=1.13.3",
+    "pygit2>=1.14.0",
     "pygtrie>=2.3.2",
-    "fsspec>=2021.7.0",
+    "fsspec[tqdm]>=2024.2.0",
     "pathspec>=0.9.0",
     "asyncssh>=2.13.1,<3",
     "funcy>=1.14",
-    "shortuuid>=0.5.0",
-    "dvc-objects>=3,<4",
-    "dvc-http>=2.29.0",
+    "aiohttp-retry>=2.5.0",
+    "tqdm",
 ]
 
 [project.urls]
@@ -40,27 +39,27 @@ Source = "https://github.com/iterative/scmrepo"
 
 [project.optional-dependencies]
 tests = [
-    "pytest==7.2.0",
-    "pytest-sugar==0.9.5",
-    "pytest-cov==3.0.0",
-    "pytest-mock==3.8.2",
-    "mypy==0.971",
-    "pytest-test-utils==0.0.8",
-    "pytest-asyncio==0.18.3",
-    # https://github.com/docker/docker-py/issues/2902
-    "pytest-docker==0.12.0; python_version < '3.10' and implementation_name != 'pypy'",
-    "mock==5.1.0",
-    "paramiko==3.3.1",
-    "types-certifi==2021.10.8.3",
-    "types-mock==5.1.0.2",
-    "types-paramiko==3.4.0.20240120",
+    "aioresponses>=0.7,<0.8",
+    "paramiko>=3.4.0,<4",
+    "pytest>=7,<9",
+    "pytest-asyncio>=0.23.2,<1",
+    "pytest-cov>=4.1.0",
+    "pytest-docker>=1,<4",
+    "pytest-mock",
+    "pytest-sugar",
+    "pytest-test-utils>=0.1.0,<0.2",
 ]
 dev = [
+    "mypy==1.9.0",
     "scmrepo[tests]",
+    "types-certifi",
+    "types-mock",
+    "types-paramiko",
+    "types-tqdm",
 ]
 
 [tool.setuptools.package-data]
-dvc_objects = ["py.typed"]
+scmrepo = ["py.typed"]
 
 [tool.setuptools.packages.find]
 where = ["src"]
@@ -72,6 +71,7 @@ markers = [
     "skip_git_backend: skip tests for given backend",
     "slow: mark test as slow to run",
 ]
+asyncio_mode = "auto"
 
 [tool.coverage.run]
 branch = true
@@ -109,7 +109,6 @@ files = ["src", "tests"]
 [[tool.mypy.overrides]]
 module = [
     "pygtrie",
-    "dvc_http.*",
     "funcy",
     "git",
     "gitdb.*",

{scmrepo-2.0.4 → scmrepo-3.3.1}/src/scmrepo/asyn.py

@@ -1,8 +1,9 @@
 """DVC re-implementation of fsspec's dedicated async event loop."""
+
 import asyncio
 import os
 import threading
-from typing import Any, List, Optional
+from typing import Any, Optional
 
 from fsspec.asyn import (  # noqa: F401, pylint:disable=unused-import
     _selector_policy,
@@ -11,9 +12,9 @@ from fsspec.asyn import (  # noqa: F401, pylint:disable=unused-import
 )
 
 # dedicated async IO thread
-iothread: List[Optional[threading.Thread]] = [None]
+iothread: list[Optional[threading.Thread]] = [None]
 # global DVC event loop
-default_loop: List[Optional[asyncio.AbstractEventLoop]] = [None]
+default_loop: list[Optional[asyncio.AbstractEventLoop]] = [None]
 lock = threading.Lock()
 
 

{scmrepo-2.0.4 → scmrepo-3.3.1}/src/scmrepo/base.py

@@ -1,4 +1,5 @@
 """Manages source control systems (e.g. Git) in DVC."""
+
 from contextlib import AbstractContextManager
 
 

{scmrepo-2.0.4 → scmrepo-3.3.1}/src/scmrepo/fs.py

@@ -1,7 +1,7 @@
 import errno
 import os
 import posixpath
-from typing import TYPE_CHECKING, Any, BinaryIO, Callable, Dict, Optional, Tuple
+from typing import TYPE_CHECKING, Any, BinaryIO, Callable, Optional
 
 from fsspec.callbacks import _DEFAULT_CALLBACK
 from fsspec.spec import AbstractFileSystem
@@ -33,8 +33,8 @@ class GitFileSystem(AbstractFileSystem):
         self,
         path: Optional[str] = None,
         rev: Optional[str] = None,
-        scm: "Git" = None,
-        trie: "GitTrie" = None,
+        scm: Optional["Git"] = None,
+        trie: Optional["GitTrie"] = None,
         rev_resolver: Optional[Callable[["Git", str], str]] = None,
         **kwargs,
     ):
@@ -169,7 +169,7 @@ class GitFileSystem(AbstractFileSystem):
     def as_posix(cls, path):
         return path
 
-    def _get_key(self, path: str) -> Tuple[str, ...]:
+    def _get_key(self, path: str) -> tuple[str, ...]:
         path = self.abspath(path)
         if path == self.root_marker:
             return ()
@@ -184,7 +184,7 @@ class GitFileSystem(AbstractFileSystem):
         mode: str = "rb",
         block_size: Optional[int] = None,
         autocommit: bool = True,
-        cache_options: Optional[Dict] = None,
+        cache_options: Optional[dict] = None,
         raw: bool = False,
         **kwargs: Any,
     ) -> BinaryIO:
@@ -204,7 +204,7 @@ class GitFileSystem(AbstractFileSystem):
                 errno.EISDIR, os.strerror(errno.EISDIR), path
             ) from exc
 
-    def info(self, path: str, **kwargs: Any) -> Dict[str, Any]:
+    def info(self, path: str, **kwargs: Any) -> dict[str, Any]:
         key = self._get_key(path)
         try:
             # NOTE: to avoid wasting time computing object size, trie.info

{scmrepo-2.0.4 → scmrepo-3.3.1}/src/scmrepo/git/__init__.py

@@ -5,18 +5,14 @@ import os
 import re
 import typing
 from collections import OrderedDict
-from collections.abc import Mapping
+from collections.abc import Iterable, Mapping
 from contextlib import contextmanager
 from functools import partialmethod
 from typing import (
     TYPE_CHECKING,
     Callable,
     ClassVar,
-    Dict,
-    Iterable,
     Optional,
-    Tuple,
-    Type,
     Union,
 )
 
@@ -44,14 +40,14 @@ if TYPE_CHECKING:
 
 logger = logging.getLogger(__name__)
 
-BackendCls = Type[BaseGitBackend]
+BackendCls = type[BaseGitBackend]
 
 
 _LOW_PRIO_BACKENDS = ("gitpython",)
 
 
 class GitBackends(Mapping):
-    DEFAULT: ClassVar[Dict[str, BackendCls]] = {
+    DEFAULT: ClassVar[dict[str, BackendCls]] = {
         "dulwich": DulwichBackend,
         "pygit2": Pygit2Backend,
         "gitpython": GitPythonBackend,
@@ -72,7 +68,7 @@ class GitBackends(Mapping):
         selected = selected or list(self.DEFAULT)
         self.backends = OrderedDict((key, self.DEFAULT[key]) for key in selected)
 
-        self.initialized: Dict[str, BaseGitBackend] = {}
+        self.initialized: dict[str, BaseGitBackend] = {}
 
         self.args = args
         self.kwargs = kwargs
@@ -146,7 +142,7 @@ class Git(Base):
     def clone(
         cls,
         url: str,
-        to_path: str,
+        to_path: Union[str, os.PathLike[str]],
         rev: Optional[str] = None,
         bare: bool = False,
         mirror: bool = False,
@@ -169,7 +165,7 @@ class Git(Base):
         return rev and cls.RE_HEXSHA.search(rev)
 
     @classmethod
-    def split_ref_pattern(cls, ref: str) -> Tuple[str, str]:
+    def split_ref_pattern(cls, ref: str) -> tuple[str, str]:
         name = cls.BAD_REF_CHARS_RE.split(ref, maxsplit=1)[0]
         return name, ref[len(name) :]
 
@@ -323,13 +319,16 @@ class Git(Base):
 
     @classmethod
     def init(
-        cls, path: str, bare: bool = False, _backend: Optional[str] = None
+        cls,
+        path: Union[str, os.PathLike[str]],
+        bare: bool = False,
+        _backend: Optional[str] = None,
     ) -> "Git":
         for name, backend in GitBackends.DEFAULT.items():
             if _backend and name != _backend:
                 continue
             try:
-                backend.init(path, bare=bare)
+                backend.init(os.fsdecode(path), bare=bare)
                 # TODO: reuse created object instead of initializing a new one.
                 return cls(path)
             except NotImplementedError:
@@ -492,8 +491,8 @@ class Git(Base):
         base: Optional[str] = None,
         match: Optional[str] = None,
         exclude: Optional[str] = None,
-    ) -> Dict[str, Optional[str]]:
-        results: Dict[str, Optional[str]] = {}
+    ) -> dict[str, Optional[str]]:
+        results: dict[str, Optional[str]] = {}
         remained_revs = set()
         if base == "refs/heads":
             current_rev = self.get_rev()

{scmrepo-2.0.4 → scmrepo-3.3.1}/src/scmrepo/git/backend/base.py

@@ -1,7 +1,8 @@
 import os
 from abc import ABC, abstractmethod
+from collections.abc import Iterable, Mapping
 from enum import Enum
-from typing import TYPE_CHECKING, Callable, Iterable, Mapping, Optional, Tuple, Union
+from typing import TYPE_CHECKING, Callable, Optional, Union
 
 from scmrepo.exceptions import SCMError
 from scmrepo.git.objects import GitObject
@@ -46,7 +47,7 @@ class BaseGitBackend(ABC):
     @abstractmethod
     def clone(
         url: str,
-        to_path: str,
+        to_path: Union[str, os.PathLike[str]],
         shallow_branch: Optional[str] = None,
         progress: Optional[Callable[["GitProgressEvent"], None]] = None,
         bare: bool = False,
@@ -281,7 +282,7 @@ class BaseGitBackend(ABC):
         ref: str,
         message: Optional[str] = None,
         include_untracked: bool = False,
-    ) -> Tuple[Optional[str], bool]:
+    ) -> tuple[Optional[str], bool]:
         """Push a commit onto the specified stash.
 
         Returns a tuple of the form (rev, need_reset) where need_reset
@@ -347,7 +348,7 @@ class BaseGitBackend(ABC):
     @abstractmethod
     def status(
         self, ignored: bool = False, untracked_files: str = "all"
-    ) -> Tuple[Mapping[str, Iterable[str]], Iterable[str], Iterable[str]]:
+    ) -> tuple[Mapping[str, Iterable[str]], Iterable[str], Iterable[str]]:
         """Return tuple of (staged_files, unstaged_files, untracked_files).
 
         staged_files will be a dict mapping status (add, delete, modify) to a

{scmrepo-2.0.4 → scmrepo-3.3.1}/src/scmrepo/git/backend/dulwich/__init__.py

@@ -4,6 +4,7 @@ import logging
 import os
 import re
 import stat
+from collections.abc import Iterable, Iterator, Mapping
 from contextlib import closing
 from functools import partial
 from io import BytesIO, StringIO
@@ -11,13 +12,7 @@ from typing import (
     TYPE_CHECKING,
     Any,
     Callable,
-    Dict,
-    Iterable,
-    Iterator,
-    List,
-    Mapping,
     Optional,
-    Tuple,
     Union,
 )
 
@@ -151,18 +146,18 @@ class DulwichConfig(Config):
             return self._config.encoding
         return self._config.backends[0].encoding
 
-    def get(self, section: Tuple[str, ...], name: str) -> str:
+    def get(self, section: tuple[str, ...], name: str) -> str:
         """Return the specified setting as a string."""
         return self._config.get(section, name).decode(self.encoding)
 
-    def get_bool(self, section: Tuple[str, ...], name: str) -> bool:
+    def get_bool(self, section: tuple[str, ...], name: str) -> bool:
         """Return the specified setting as a boolean."""
         value = self._config.get_boolean(section, name)
         if value is None:
             raise ValueError("setting is not a valid boolean")
         return value
 
-    def get_multivar(self, section: Tuple[str, ...], name: str) -> Iterator[str]:
+    def get_multivar(self, section: tuple[str, ...], name: str) -> Iterator[str]:
         """Iterate over string values in the specified multivar setting."""
         for value in self._config.get_multivar(section, name):
             yield value.decode(self.encoding)
@@ -199,17 +194,17 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
         except NotGitRepository as exc:
             raise SCMError(f"{root_dir} is not a git repository") from exc
 
-        self._submodules: Dict[str, str] = self._find_submodules()
+        self._submodules: dict[str, str] = self._find_submodules()
         self._stashes: dict = {}
 
-    def _find_submodules(self) -> Dict[str, str]:
+    def _find_submodules(self) -> dict[str, str]:
         """Return dict mapping submodule names to submodule paths.
 
         Submodule paths will be relative to Git repo root.
         """
         from dulwich.config import ConfigFile, parse_submodules
 
-        submodules: Dict[str, str] = {}
+        submodules: dict[str, str] = {}
         config_path = os.path.join(self.root_dir, ".gitmodules")
         if os.path.isfile(config_path):
             config = ConfigFile.from_path(config_path)
@@ -228,7 +223,7 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
     def clone(
         cls,
         url: str,
-        to_path: str,
+        to_path: Union[str, os.PathLike[str]],
         shallow_branch: Optional[str] = None,
         progress: Optional[Callable[["GitProgressEvent"], None]] = None,
         bare: bool = False,
@@ -270,7 +265,7 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
                 else:
                     cls._set_default_tracking_branch(repo)
         except Exception as exc:  # noqa: BLE001
-            raise CloneError(url, to_path) from exc
+            raise CloneError(url, os.fsdecode(to_path)) from exc
 
     @staticmethod
     def _set_default_tracking_branch(repo: "Repo"):
@@ -332,7 +327,7 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
             self.repo.stage(list(self.repo.open_index()))
             return
 
-        files: List[bytes] = [
+        files: list[bytes] = [
             os.fsencode(fpath) for fpath in self._expand_paths(paths, force=force)
         ]
         if update:
@@ -348,7 +343,7 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
         else:
             self.repo.stage(files)
 
-    def _expand_paths(self, paths: List[str], force: bool = False) -> Iterator[str]:
+    def _expand_paths(self, paths: list[str], force: bool = False) -> Iterator[str]:
         for path in paths:
             if not os.path.isabs(path) and self._submodules:
                 # NOTE: If path is inside a submodule, Dulwich expects the
@@ -459,7 +454,7 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
         return any(p == rel or p.startswith(rel_dir) for p in self.repo.open_index())
 
     def is_dirty(self, untracked_files: bool = False) -> bool:
-        kwargs: Dict[str, Any] = {} if untracked_files else {"untracked_files": "no"}
+        kwargs: dict[str, Any] = {} if untracked_files else {"untracked_files": "no"}
         return any(self.status(**kwargs))
 
     def active_branch(self) -> str:
@@ -707,9 +702,9 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
         fetch_refs = []
 
         def determine_wants(
-            remote_refs: Dict[bytes, bytes],
+            remote_refs: dict[bytes, bytes],
             depth: Optional[int] = None,  # pylint: disable=unused-argument
-        ) -> List[bytes]:
+        ) -> list[bytes]:
             fetch_refs.extend(
                 parse_reftuples(
                     DictRefsContainer(remote_refs),
@@ -782,7 +777,7 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
         ref: str,
         message: Optional[str] = None,
         include_untracked: bool = False,
-    ) -> Tuple[Optional[str], bool]:
+    ) -> tuple[Optional[str], bool]:
         from dulwich.repo import InvalidUserIdentity
 
         from scmrepo.git import Stash
@@ -836,8 +831,8 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
     ) -> Mapping[str, Optional[str]]:
         if not base:
             base = "refs/tags"
-        rev_mapping: Dict[str, Optional[str]] = {}
-        results: Dict[str, Optional[str]] = {}
+        rev_mapping: dict[str, Optional[str]] = {}
+        results: dict[str, Optional[str]] = {}
         for ref in self.iter_refs(base=base):
             if (match and not fnmatch.fnmatch(ref, match)) or (
                 exclude and fnmatch.fnmatch(ref, exclude)
@@ -847,7 +842,7 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
             if revision and revision not in rev_mapping:
                 rev_mapping[revision] = ref
         for rev in revs:
-            results[rev] = rev_mapping.get(rev, None)
+            results[rev] = rev_mapping.get(rev)
         return results
 
     def diff(self, rev_a: str, rev_b: str, binary=False) -> str:
@@ -877,7 +872,7 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
 
     def status(
         self, ignored: bool = False, untracked_files: str = "all"
-    ) -> Tuple[Mapping[str, Iterable[str]], Iterable[str], Iterable[str]]:
+    ) -> tuple[Mapping[str, Iterable[str]], Iterable[str], Iterable[str]]:
         from dulwich.porcelain import Error
         from dulwich.porcelain import status as git_status
 
@@ -978,8 +973,21 @@ class DulwichBackend(BaseGitBackend):  # pylint:disable=abstract-method
 _IDENTITY_RE = re.compile(r"(?P<name>.+)\s+<(?P<email>.+)>")
 
 
-def _parse_identity(identity: str) -> Tuple[str, str]:
+def _parse_identity(identity: str) -> tuple[str, str]:
     m = _IDENTITY_RE.match(identity)
     if not m:
         raise SCMError("Could not parse tagger identity '{identity}'")
     return m.group("name"), m.group("email")
+
+
+def ls_remote(url: str) -> dict[str, str]:
+    from dulwich import porcelain
+    from dulwich.client import HTTPUnauthorized
+
+    try:
+        refs = porcelain.ls_remote(url)
+        return {os.fsdecode(ref): sha.decode("ascii") for ref, sha in refs.items()}
+    except HTTPUnauthorized as exc:
+        raise AuthError(url) from exc
+    except Exception as exc:  # noqa: BLE001
+        raise InvalidRemote(url) from exc