feat(libvcs.cmd): Lite, typed, pythonic command wrappers for git, hg, mercurial (#319)

Experimental command wrappers

Author: tony

docs/cmd/git.md

@@ -0,0 +1,22 @@
+# `libvcs.cmd.git`
+
+For `git(1)`.
+
+Compare to: [`fabtools.git`](https://fabtools.readthedocs.io/en/0.19.0/api/git.html#git-module),
+[`salt.modules.git`](https://docs.saltproject.io/en/latest/ref/modules/all/salt.modules.git.html),
+[`ansible.builtin.git`](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/git_module.html)
+
+```{eval-rst}
+.. autosummary::
+   :recursive:
+
+   libvcs.cmd.git.Git
+```
+
+```{eval-rst}
+.. automodule:: libvcs.cmd.git
+   :members:
+   :show-inheritance:
+   :undoc-members:
+   :inherited-members:
+```

docs/cmd/hg.md

@@ -0,0 +1,18 @@
+# `libvcs.cmd.hg`
+
+For mercurial, aka `hg(1)`.
+
+```{eval-rst}
+.. autosummary::
+   :recursive:
+
+   libvcs.cmd.hg.Hg
+```
+
+```{eval-rst}
+.. automodule:: libvcs.cmd.hg
+   :members:
+   :show-inheritance:
+   :undoc-members:
+   :inherited-members:
+```

docs/cmd/index.md

@@ -0,0 +1,22 @@
+(cmd)=
+
+# `libvcs.cmd`
+
+Compare to: [`fabtools.git`](https://fabtools.readthedocs.io/en/0.19.0/api/git.html#git-module),
+[`salt.modules.git`](https://docs.saltproject.io/en/latest/ref/modules/all/salt.modules.git.html),
+[`ansible.builtin.git`](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/git_module.html)
+
+:::{warning}
+
+All APIs are considered experimental and subject to break pre-1.0. They can and will break between
+versions.
+
+:::
+
+```{toctree}
+:caption: API
+
+git
+hg
+svn
+```

docs/cmd/svn.md

@@ -0,0 +1,18 @@
+# `libvcs.cmd.svn`
+
+For subversion, aka `svn(1)`
+
+```{eval-rst}
+.. autosummary::
+   :recursive:
+
+   libvcs.cmd.svn.Svn
+```
+
+```{eval-rst}
+.. automodule:: libvcs.cmd.svn
+   :members:
+   :show-inheritance:
+   :undoc-members:
+   :inherited-members:
+```

docs/index.md

@@ -9,6 +9,7 @@
 :hidden:
 
 quickstart
+cmd/index
 states/index
 ```
 

docs/states/index.md

@@ -45,6 +45,6 @@ See examples below of git, mercurial, and subversion.
 ## Utility stuff
 
 ```{eval-rst}
-.. automodule:: libvcs.util
+.. automodule:: libvcs.cmd.core
    :members:
 ```

libvcs/__init__.py

@@ -1,11 +1,11 @@
 """Repo package for libvcs."""
 import logging
 
+from .cmd.core import CmdLoggingAdapter
 from .states.base import BaseRepo
 from .states.git import GitRepo
 from .states.hg import MercurialRepo
 from .states.svn import SubversionRepo
-from .util import CmdLoggingAdapter
 
 __all__ = [
     "GitRepo",

libvcs/cmd/__init__.py

@@ -7,8 +7,8 @@
 import sys
 from typing import Callable, Optional, Union
 
-from . import exc
-from .types import StrOrBytesPath
+from .. import exc
+from ..types import StrOrBytesPath
 
 logger = logging.getLogger(__name__)