cli/sync(refactor[typing]): Type repo update payloads

why: Remove remaining Any usages while keeping repo sync behavior unchanged.

what:

- Add typed payload helpers for libvcs create_project calls

- Tighten PrivatePath constructor argument types

Author: tony

src/vcspull/_internal/private_path.py

@@ -34,7 +34,11 @@ class PrivatePath(PrivatePathBase):
     '~/notes.txt'
     """
 
-    def __new__(cls, *args: t.Any, **kwargs: t.Any) -> PrivatePath:
+    def __new__(
+        cls,
+        *args: str | os.PathLike[str],
+        **kwargs: object,
+    ) -> PrivatePath:
         return super().__new__(cls, *args, **kwargs)
 
     @classmethod

src/vcspull/cli/sync.py

@@ -13,13 +13,13 @@
 import subprocess
 import sys
 import typing as t
-from collections.abc import Callable
 from copy import deepcopy
 from dataclasses import dataclass
 from datetime import datetime
 from io import StringIO
 from time import perf_counter
 
+from libvcs._internal.run import ProgressCallbackProtocol
 from libvcs._internal.shortcuts import create_project
 from libvcs._internal.types import VCSLiteral
 from libvcs.sync.git import GitSync
@@ -48,7 +48,42 @@
 
 log = logging.getLogger(__name__)
 
-ProgressCallback = Callable[[str, datetime], None]
+ProgressCallback: t.TypeAlias = ProgressCallbackProtocol
+
+
+class RepoPayloadBase(t.TypedDict):
+    """Keyword arguments used to create a repo via libvcs."""
+
+    url: str
+    path: str | os.PathLike[str]
+    progress_callback: ProgressCallback | None
+
+
+class GitRepoPayload(RepoPayloadBase):
+    """Keyword arguments for git repositories."""
+
+    vcs: t.Literal["git"]
+
+
+class HgRepoPayload(RepoPayloadBase):
+    """Keyword arguments for Mercurial repositories."""
+
+    vcs: t.Literal["hg"]
+
+
+class SvnRepoPayload(RepoPayloadBase):
+    """Keyword arguments for Subversion repositories."""
+
+    vcs: t.Literal["svn"]
+
+
+class RepoPayload(t.TypedDict):
+    """Keyword arguments used to create a repo via libvcs."""
+
+    url: str
+    path: str | os.PathLike[str]
+    vcs: VCSLiteral | None
+    progress_callback: ProgressCallback | None
 
 
 PLAN_SYMBOLS: dict[PlanAction, str] = {
@@ -836,28 +871,39 @@ def __init__(self, repo_url: str) -> None:
 
 
 def update_repo(
-    repo_dict: t.Any,
+    repo_dict: ConfigDict,
     progress_callback: ProgressCallback | None = None,
     # repo_dict: Dict[str, Union[str, Dict[str, GitRemote], pathlib.Path]]
 ) -> GitSync:
     """Synchronize a single repository."""
-    repo_dict = deepcopy(repo_dict)
-    if "pip_url" not in repo_dict:
-        repo_dict["pip_url"] = repo_dict.pop("url")
-    if "url" not in repo_dict:
-        repo_dict["url"] = repo_dict.pop("pip_url")
+    repo_payload = t.cast("dict[str, object]", deepcopy(repo_dict))
+    if "pip_url" not in repo_payload:
+        repo_payload["pip_url"] = repo_payload.pop("url")
+    if "url" not in repo_payload:
+        repo_payload["url"] = repo_payload.pop("pip_url")
+
+    repo_payload["progress_callback"] = progress_callback or progress_cb
+
+    repo_url = t.cast("str", repo_payload["url"])
+    repo_vcs = t.cast("VCSLiteral | None", repo_payload.get("vcs"))
+    if repo_vcs is None:
+        vcs = guess_vcs(url=repo_url)
+        if vcs is None:
+            raise CouldNotGuessVCSFromURL(repo_url=repo_url)
 
-    repo_dict["progress_callback"] = progress_callback or progress_cb
+        repo_payload["vcs"] = vcs
+        repo_vcs = vcs
 
-    if repo_dict.get("vcs") is None:
-        vcs = guess_vcs(url=repo_dict["url"])
-        if vcs is None:
-            raise CouldNotGuessVCSFromURL(repo_url=repo_dict["url"])
+    assert repo_vcs is not None
 
-        repo_dict["vcs"] = vcs
+    if repo_vcs == "git":
+        r = create_project(**t.cast("GitRepoPayload", repo_payload))
+    elif repo_vcs == "svn":
+        r = t.cast("GitSync", create_project(**t.cast("SvnRepoPayload", repo_payload)))
+    else:
+        r = t.cast("GitSync", create_project(**t.cast("HgRepoPayload", repo_payload)))
 
-    r = create_project(**repo_dict)  # Creates the repo object
     r.update_repo(set_remotes=True)  # Creates repo if not exists and fetches
 
     # TODO: Fix this
-    return r  # type:ignore
+    return r