feat(create_project): Guess VCS from URL

Author: tony

src/libvcs/_internal/shortcuts.py

@@ -10,7 +10,11 @@
 from libvcs import GitSync, HgSync, SvnSync
 from libvcs._internal.run import ProgressCallbackProtocol
 from libvcs._internal.types import StrPath, VCSLiteral
-from libvcs.exc import InvalidVCS
+from libvcs.exc import InvalidVCS, LibVCSException
+from libvcs.url import registry as url_tools
+
+if t.TYPE_CHECKING:
+    from typing_extensions import TypeGuard
 
 
 @t.overload
@@ -20,7 +24,7 @@ def create_project(
     dir: StrPath,
     vcs: t.Literal["git"],
     progress_callback: t.Optional[ProgressCallbackProtocol] = None,
-    **kwargs: dict[t.Any, t.Any]
+    **kwargs: dict[t.Any, t.Any],
 ) -> GitSync:
     ...
 
@@ -32,7 +36,7 @@ def create_project(
     dir: StrPath,
     vcs: t.Literal["svn"],
     progress_callback: t.Optional[ProgressCallbackProtocol] = None,
-    **kwargs: dict[t.Any, t.Any]
+    **kwargs: dict[t.Any, t.Any],
 ) -> SvnSync:
     ...
 
@@ -44,7 +48,7 @@ def create_project(
     dir: StrPath,
     vcs: t.Literal["hg"],
     progress_callback: t.Optional[ProgressCallbackProtocol] = ...,
-    **kwargs: dict[t.Any, t.Any]
+    **kwargs: dict[t.Any, t.Any],
 ) -> HgSync:
     ...
 
@@ -53,9 +57,9 @@ def create_project(
     *,
     url: str,
     dir: StrPath,
-    vcs: VCSLiteral,
+    vcs: t.Optional[VCSLiteral] = None,
     progress_callback: t.Optional[ProgressCallbackProtocol] = None,
-    **kwargs: dict[t.Any, t.Any]
+    **kwargs: dict[t.Any, t.Any],
 ) -> Union[GitSync, HgSync, SvnSync]:
     r"""Return an object representation of a VCS repository.
 
@@ -71,6 +75,24 @@ def create_project(
     >>> isinstance(r, GitSync)
     True
     """
+    if vcs is None:
+        vcs_matches = url_tools.registry.match(url=url, is_explicit=True)
+
+        if len(vcs_matches) == 0:
+            raise LibVCSException(f"No vcs found for {url}")
+        if len(vcs_matches) > 1:
+            raise LibVCSException(f"No exact matches for {url}")
+
+        assert vcs_matches[0].vcs is not None
+
+        def is_vcs(val: t.Any) -> "TypeGuard[VCSLiteral]":
+            return isinstance(val, str) and val in ["git", "hg", "svn"]
+
+        if is_vcs(vcs_matches[0].vcs):
+            vcs = vcs_matches[0].vcs
+        else:
+            raise InvalidVCS(f"{url} does not have supported vcs: {vcs}")
+
     if vcs == "git":
         return GitSync(url=url, dir=dir, progress_callback=progress_callback, **kwargs)
     elif vcs == "hg":