pytest_plugin(feat): Add caching to async fixtures

why: Async fixtures should match sync fixture performance pattern
what:
- Add master_copy caching to async_git_repo fixture
- Add async_hg_repo fixture with caching
- Add async_svn_repo fixture with caching
- Add tests for new async_hg_repo and async_svn_repo fixtures

Author: tony

src/libvcs/pytest_plugin.py

@@ -24,6 +24,8 @@
     import pytest_asyncio
 
     from libvcs.sync._async.git import AsyncGitSync
+    from libvcs.sync._async.hg import AsyncHgSync
+    from libvcs.sync._async.svn import AsyncSvnSync
 
     HAS_PYTEST_ASYNCIO = True
 except ImportError:
@@ -818,10 +820,19 @@ async def async_git_repo(
         """
         remote_repo_name = unique_repo_name(remote_repos_path=projects_path)
         new_checkout_path = projects_path / remote_repo_name
+        master_copy = remote_repos_path / "async_git_repo"
+
+        if master_copy.exists():
+            shutil.copytree(master_copy, new_checkout_path)
+            yield AsyncGitSync(
+                url=f"file://{git_remote_repo}",
+                path=new_checkout_path,
+            )
+            return
 
         repo = AsyncGitSync(
             url=f"file://{git_remote_repo}",
-            path=new_checkout_path,
+            path=master_copy,
             remotes={
                 "origin": GitRemote(
                     name="origin",
@@ -833,6 +844,81 @@ async def async_git_repo(
         await repo.obtain()
         yield repo
 
+    @pytest_asyncio.fixture
+    @skip_if_hg_missing
+    async def async_hg_repo(
+        remote_repos_path: pathlib.Path,
+        projects_path: pathlib.Path,
+        hg_remote_repo: pathlib.Path,
+        set_hgconfig: pathlib.Path,
+    ) -> t.AsyncGenerator[AsyncHgSync, None]:
+        """Pre-made async hg clone of remote repo checked out to user's projects dir.
+
+        Async equivalent of :func:`hg_repo` fixture.
+
+        Examples
+        --------
+        >>> @pytest.mark.asyncio
+        ... async def test_hg_operations(async_hg_repo):
+        ...     revision = await async_hg_repo.get_revision()
+        ...     assert revision is not None
+        """
+        remote_repo_name = unique_repo_name(remote_repos_path=projects_path)
+        new_checkout_path = projects_path / remote_repo_name
+        master_copy = remote_repos_path / "async_hg_repo"
+
+        if master_copy.exists():
+            shutil.copytree(master_copy, new_checkout_path)
+            yield AsyncHgSync(
+                url=f"file://{hg_remote_repo}",
+                path=new_checkout_path,
+            )
+            return
+
+        repo = AsyncHgSync(
+            url=f"file://{hg_remote_repo}",
+            path=master_copy,
+        )
+        await repo.obtain()
+        yield repo
+
+    @pytest_asyncio.fixture
+    @skip_if_svn_missing
+    async def async_svn_repo(
+        remote_repos_path: pathlib.Path,
+        projects_path: pathlib.Path,
+        svn_remote_repo: pathlib.Path,
+    ) -> t.AsyncGenerator[AsyncSvnSync, None]:
+        """Pre-made async svn checkout of remote repo checked out to user's projects dir.
+
+        Async equivalent of :func:`svn_repo` fixture.
+
+        Examples
+        --------
+        >>> @pytest.mark.asyncio
+        ... async def test_svn_operations(async_svn_repo):
+        ...     revision = await async_svn_repo.get_revision()
+        ...     assert revision is not None
+        """
+        remote_repo_name = unique_repo_name(remote_repos_path=projects_path)
+        new_checkout_path = projects_path / remote_repo_name
+        master_copy = remote_repos_path / "async_svn_repo"
+
+        if master_copy.exists():
+            shutil.copytree(master_copy, new_checkout_path)
+            yield AsyncSvnSync(
+                url=f"file://{svn_remote_repo}",
+                path=new_checkout_path,
+            )
+            return
+
+        repo = AsyncSvnSync(
+            url=f"file://{svn_remote_repo}",
+            path=master_copy,
+        )
+        await repo.obtain()
+        yield repo
+
 
 @pytest.fixture
 def add_doctest_fixtures(

tests/sync/_async/test_hg.py

@@ -124,3 +124,25 @@ async def test_get_revision(
         revision = await repo.get_revision()
         # Mercurial revisions are numeric (0, 1, 2, ...)
         assert revision.strip().isdigit() or revision.strip() == ""
+
+
+class TestAsyncHgRepoFixture:
+    """Tests for the async_hg_repo pytest fixture."""
+
+    @pytest.mark.asyncio
+    async def test_async_hg_repo_fixture(
+        self,
+        async_hg_repo: AsyncHgSync,
+    ) -> None:
+        """Test that async_hg_repo fixture provides a working repository."""
+        assert async_hg_repo.path.exists()
+        assert (async_hg_repo.path / ".hg").exists()
+
+    @pytest.mark.asyncio
+    async def test_async_hg_repo_revision(
+        self,
+        async_hg_repo: AsyncHgSync,
+    ) -> None:
+        """Test async_hg_repo fixture can get revision."""
+        revision = await async_hg_repo.get_revision()
+        assert revision.strip().isdigit() or revision.strip() == ""

tests/sync/_async/test_svn.py

@@ -246,3 +246,26 @@ async def test_get_revision_file(
         revision = await repo.get_revision_file("./")
         # SVN revisions start at 0 for empty repos
         assert revision == 0
+
+
+class TestAsyncSvnRepoFixture:
+    """Tests for the async_svn_repo pytest fixture."""
+
+    @pytest.mark.asyncio
+    async def test_async_svn_repo_fixture(
+        self,
+        async_svn_repo: AsyncSvnSync,
+    ) -> None:
+        """Test that async_svn_repo fixture provides a working repository."""
+        assert async_svn_repo.path.exists()
+        assert (async_svn_repo.path / ".svn").exists()
+
+    @pytest.mark.asyncio
+    async def test_async_svn_repo_revision(
+        self,
+        async_svn_repo: AsyncSvnSync,
+    ) -> None:
+        """Test async_svn_repo fixture can get revision."""
+        revision = await async_svn_repo.get_revision()
+        # SVN revisions start at 0 for empty repos
+        assert revision == 0