cmd,sync/_async(fix): Enable async doctests to run

why: Doctests were commented out and never executed
what:
- cmd/_async/git.py: Use tmp_path and create_git_remote_repo fixtures
- cmd/_async/hg.py: Use create_hg_remote_repo fixture
- cmd/_async/svn.py: Use create_svn_remote_repo fixture
- sync/_async/git.py: Use create_git_remote_repo fixture
- sync/_async/hg.py: Use create_hg_remote_repo fixture
- sync/_async/svn.py: Use create_svn_remote_repo fixture

All doctests now actually run and test real functionality.

Author: tony

src/libvcs/cmd/_async/git.py

@@ -36,12 +36,13 @@ class AsyncGit:
 
     Examples
     --------
-    >>> import asyncio
     >>> async def example():
-    ...     git = AsyncGit(path="/path/to/repo")
+    ...     git = AsyncGit(path=tmp_path)
+    ...     await git.run(['init'])
     ...     status = await git.status()
-    ...     return status
-    >>> # asyncio.run(example())
+    ...     return 'On branch' in status or 'No commits yet' in status
+    >>> asyncio.run(example())
+    True
     """
 
     progress_callback: AsyncProgressCallbackProtocol | None = None
@@ -128,11 +129,12 @@ async def run(
 
         Examples
         --------
-        >>> import asyncio
         >>> async def example():
-        ...     git = AsyncGit(path="/path/to/repo")
-        ...     return await git.run(["status"])
-        >>> # asyncio.run(example())
+        ...     git = AsyncGit(path=tmp_path)
+        ...     await git.run(['init'])
+        ...     return 'On branch' in await git.run(['status'])
+        >>> asyncio.run(example())
+        True
         """
         cli_args: list[str]
         if isinstance(args, Sequence) and not isinstance(args, (str, bytes)):
@@ -223,11 +225,14 @@ async def clone(
 
         Examples
         --------
-        >>> import asyncio
         >>> async def example():
-        ...     git = AsyncGit(path="/tmp/myrepo")
-        ...     await git.clone(url="https://github.com/user/repo")
-        >>> # asyncio.run(example())
+        ...     repo_path = tmp_path / 'cloned_repo'
+        ...     git = AsyncGit(path=repo_path)
+        ...     url = f'file://{create_git_remote_repo()}'
+        ...     await git.clone(url=url)
+        ...     return (repo_path / '.git').exists()
+        >>> asyncio.run(example())
+        True
         """
         if make_parents and not self.path.exists():
             self.path.mkdir(parents=True)

src/libvcs/cmd/_async/hg.py

@@ -56,12 +56,14 @@ class AsyncHg:
 
     Examples
     --------
-    >>> import asyncio
     >>> async def example():
-    ...     hg = AsyncHg(path="/path/to/repo")
-    ...     output = await hg.pull()
-    ...     return output
-    >>> # asyncio.run(example())
+    ...     repo_path = tmp_path / 'hg_repo'
+    ...     hg = AsyncHg(path=repo_path)
+    ...     url = f'file://{create_hg_remote_repo()}'
+    ...     await hg.clone(url=url)
+    ...     return (repo_path / '.hg').exists()
+    >>> asyncio.run(example())
+    True
     """
 
     progress_callback: AsyncProgressCallbackProtocol | None = None

src/libvcs/cmd/_async/svn.py

@@ -39,12 +39,14 @@ class AsyncSvn:
 
     Examples
     --------
-    >>> import asyncio
     >>> async def example():
-    ...     svn = AsyncSvn(path="/path/to/working-copy")
-    ...     info = await svn.info()
-    ...     return info
-    >>> # asyncio.run(example())
+    ...     repo_path = tmp_path / 'svn_wc'
+    ...     svn = AsyncSvn(path=repo_path)
+    ...     url = f'file://{create_svn_remote_repo()}'
+    ...     await svn.checkout(url=url)
+    ...     return (repo_path / '.svn').exists()
+    >>> asyncio.run(example())
+    True
     """
 
     progress_callback: AsyncProgressCallbackProtocol | None = None

src/libvcs/sync/_async/git.py

@@ -62,15 +62,14 @@ class AsyncGitSync(AsyncBaseSync):
 
     Examples
     --------
-    >>> import asyncio
     >>> async def example():
-    ...     repo = AsyncGitSync(
-    ...         url="https://github.com/vcs-python/libvcs",
-    ...         path="/tmp/libvcs",
-    ...     )
+    ...     url = f'file://{create_git_remote_repo()}'
+    ...     repo_path = tmp_path / 'git_sync_repo'
+    ...     repo = AsyncGitSync(url=url, path=repo_path)
     ...     await repo.obtain()
-    ...     await repo.update_repo()
-    >>> # asyncio.run(example())
+    ...     return (repo_path / '.git').exists()
+    >>> asyncio.run(example())
+    True
     """
 
     bin_name = "git"

src/libvcs/sync/_async/hg.py

@@ -25,15 +25,14 @@ class AsyncHgSync(AsyncBaseSync):
 
     Examples
     --------
-    >>> import asyncio
     >>> async def example():
-    ...     repo = AsyncHgSync(
-    ...         url="https://hg.example.com/repo",
-    ...         path="/tmp/myrepo",
-    ...     )
+    ...     url = f'file://{create_hg_remote_repo()}'
+    ...     repo_path = tmp_path / 'hg_sync_repo'
+    ...     repo = AsyncHgSync(url=url, path=repo_path)
     ...     await repo.obtain()
-    ...     await repo.update_repo()
-    >>> # asyncio.run(example())
+    ...     return (repo_path / '.hg').exists()
+    >>> asyncio.run(example())
+    True
     """
 
     bin_name = "hg"

src/libvcs/sync/_async/svn.py

@@ -31,15 +31,14 @@ class AsyncSvnSync(AsyncBaseSync):
 
     Examples
     --------
-    >>> import asyncio
     >>> async def example():
-    ...     repo = AsyncSvnSync(
-    ...         url="svn://svn.example.com/repo",
-    ...         path="/tmp/myrepo",
-    ...     )
+    ...     url = f'file://{create_svn_remote_repo()}'
+    ...     repo_path = tmp_path / 'svn_sync_repo'
+    ...     repo = AsyncSvnSync(url=url, path=repo_path)
     ...     await repo.obtain()
-    ...     await repo.update_repo()
-    >>> # asyncio.run(example())
+    ...     return (repo_path / '.svn').exists()
+    >>> asyncio.run(example())
+    True
     """
 
     bin_name = "svn"