sync/git(fix[GitSync]): Honor git_shallow and tls_verify constructor args

why: Passing git_shallow=True or tls_verify=True never set the attribute, so
the next obtain() raised AttributeError. The implicit **kwargs-to-__dict__
assignment that once populated them was removed in v0.4.4, leaving the
`if "x" not in kwargs` blocks to set only the default-False case.
what:
- Accept git_shallow and tls_verify as explicit keyword-only params on
  GitSync.__init__ and assign them directly
- Type create_project's **kwargs as t.Any (was dict[Any, Any], which mis-typed
  every forwarded keyword) so the now-typed params type-check
- Document git_shallow in the GitSync docstring
- Add a regression test: attributes are set, and git_shallow drives a shallow
  (depth-1) clone
- CHANGES: Fixes entry

Author: tony

CHANGES

@@ -20,6 +20,12 @@ $ uv add libvcs --prerelease allow
 _Notes on the upcoming release will go here._
 <!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
 
+### Fixes
+
+#### GitSync honors `git_shallow` and `tls_verify` constructor arguments (#531)
+
+Passing `git_shallow=True` or `tls_verify=True` to {class}`~libvcs.sync.git.GitSync` left the matching attribute unset, so the next {meth}`~libvcs.sync.git.GitSync.obtain` raised `AttributeError`. Both are now accepted as keyword-only constructor arguments and applied when cloning.
+
 ## libvcs 0.41.0 (2026-05-10)
 
 libvcs 0.41.0 is a pytest-plugin compatibility release. It renames libvcs's Git and Mercurial config fixtures so the plugin no longer occupies fixture names used by third-party pytest plugins, and it keeps the docs stack aligned with the current gp-sphinx theme pipeline.

src/libvcs/_internal/shortcuts.py

@@ -38,7 +38,7 @@ def create_project(
     path: StrPath,
     vcs: t.Literal["git"],
     progress_callback: ProgressCallbackProtocol | None = None,
-    **kwargs: dict[t.Any, t.Any],
+    **kwargs: t.Any,
 ) -> GitSync: ...
 
 
@@ -49,7 +49,7 @@ def create_project(
     path: StrPath,
     vcs: t.Literal["svn"],
     progress_callback: ProgressCallbackProtocol | None = None,
-    **kwargs: dict[t.Any, t.Any],
+    **kwargs: t.Any,
 ) -> SvnSync: ...
 
 
@@ -60,7 +60,7 @@ def create_project(
     path: StrPath,
     vcs: t.Literal["hg"],
     progress_callback: ProgressCallbackProtocol | None = ...,
-    **kwargs: dict[t.Any, t.Any],
+    **kwargs: t.Any,
 ) -> HgSync: ...
 
 
@@ -71,7 +71,7 @@ def create_project(
     path: StrPath,
     vcs: None = None,
     progress_callback: ProgressCallbackProtocol | None = None,
-    **kwargs: dict[t.Any, t.Any],
+    **kwargs: t.Any,
 ) -> GitSync | HgSync | SvnSync: ...
 
 
@@ -81,7 +81,7 @@ def create_project(
     path: StrPath,
     vcs: VCSLiteral | None = None,
     progress_callback: ProgressCallbackProtocol | None = None,
-    **kwargs: dict[t.Any, t.Any],
+    **kwargs: t.Any,
 ) -> GitSync | HgSync | SvnSync:
     r"""Return an object representation of a VCS repository.
 

src/libvcs/sync/git.py

@@ -211,6 +211,8 @@ def __init__(
         url: str,
         path: StrPath,
         remotes: GitRemotesArgs = None,
+        git_shallow: bool = False,
+        tls_verify: bool = False,
         **kwargs: t.Any,
     ) -> None:
         """Local git repository.
@@ -220,6 +222,10 @@ def __init__(
         url : str
             URL of repo
 
+        git_shallow : bool
+            Clone with history truncated to the latest commit (``--depth 1``,
+            default False)
+
         tls_verify : bool
             Should certificate for https be checked (default False)
 
@@ -258,10 +264,8 @@ def __init__(
                }
             )
         """
-        if "git_shallow" not in kwargs:
-            self.git_shallow = False
-        if "tls_verify" not in kwargs:
-            self.tls_verify = False
+        self.git_shallow = git_shallow
+        self.tls_verify = tls_verify
 
         self._remotes: GitSyncRemoteDict
 

tests/sync/test_git.py

@@ -120,6 +120,43 @@ def test_repo_git_obtain_full(
     assert (tmp_path / "myrepo").exists()
 
 
+def test_git_shallow_and_tls_verify_kwargs_are_honored(
+    tmp_path: pathlib.Path,
+    git_remote_repo: pathlib.Path,
+) -> None:
+    """``git_shallow`` and ``tls_verify`` populate their attributes.
+
+    Regression: each kwarg previously left its attribute unset, so the next
+    ``obtain()`` raised ``AttributeError``.
+    """
+    # tls_verify reaches the attribute. Its clone-time ``config`` wiring is
+    # broken independently of this fix and tracked separately, so we don't
+    # drive a clone with it here.
+    assert (
+        GitSync(
+            url=git_remote_repo.as_uri(),
+            path=tmp_path / "tls",
+            tls_verify=True,
+        ).tls_verify
+        is True
+    )
+
+    # git_shallow drives a depth-1 (shallow) clone in obtain().
+    git_repo = GitSync(
+        url=git_remote_repo.as_uri(),
+        path=tmp_path / "myrepo",
+        git_shallow=True,
+    )
+    assert git_repo.git_shallow is True
+    git_repo.obtain()
+
+    is_shallow = run(
+        ["git", "rev-parse", "--is-shallow-repository"],
+        cwd=tmp_path / "myrepo",
+    )
+    assert is_shallow == "true"
+
+
 @pytest.mark.parametrize(
     # Postpone evaluation of options so fixture variables can interpolate
     ("constructor", "lazy_constructor_options"),