Change: Refactor VersionCommands

* Add support for VersioningScheme and therefore different version
  parsing
* Move all VersionCommand classes into a commands package
* Mark commands sup modules as "private"

Author: bjoernricks

docs/pontos/version.md

@@ -5,11 +5,8 @@
 ```{toctree}
 :maxdepth: 1
 
-version/cmake
-version/go
-version/javascript
+version/commands
 version/project
-version/python
 version/schemes
 version/helper
 ```

docs/pontos/version/cmake.md

@@ -0,0 +1,6 @@
+# pontos.version.commands package
+
+```{eval-rst}
+.. automodule:: pontos.version.commands
+   :members:
+```

docs/pontos/version/commands.md

@@ -17,11 +17,20 @@
 
 from typing import Iterable, Tuple, Type
 
-from .cmake import CMakeVersionCommand
-from .go import GoVersionCommand
-from .javascript import JavaScriptVersionCommand
-from .python import PythonVersionCommand
-from .version import VersionCommand
+from ._cmake import CMakeVersionCommand
+from ._command import VersionCommand
+from ._go import GoVersionCommand
+from ._javascript import JavaScriptVersionCommand
+from ._python import PythonVersionCommand
+
+__all__ = (
+    "VersionCommand",
+    "CMakeVersionCommand",
+    "GoVersionCommand",
+    "JavaScriptVersionCommand",
+    "PythonVersionCommand",
+    "get_commands",
+)
 
 __COMMANDS: Tuple[Type[VersionCommand]] = (
     CMakeVersionCommand,
@@ -32,4 +41,7 @@
 
 
 def get_commands() -> Iterable[Type[VersionCommand]]:
+    """
+    Returns the available VersionCommands
+    """
     return __COMMANDS

docs/pontos/version/go.md

@@ -19,9 +19,10 @@
 import re
 from typing import Generator, Literal, Optional, Tuple, Union
 
-from pontos.version.errors import VersionError
-
-from .version import Version, VersionCommand, VersionUpdate, parse_version
+from ..errors import VersionError
+from ..schemes import PEP440VersioningScheme
+from ..version import Version, VersionUpdate
+from ._command import VersionCommand
 
 
 class CMakeVersionCommand(VersionCommand):
@@ -50,14 +51,15 @@ def get_current_version(self) -> Version:
             raise VersionError(f"{self.project_file_path} not found.")
 
         content = self.project_file_path.read_text(encoding="utf-8")
-        return CMakeVersionParser(content).get_current_version()
+        current_version = CMakeVersionParser(content).get_current_version()
+        return self.versioning_scheme.from_version(current_version)
 
     def verify_version(
-        self, version: Union[Literal["current"], Version]
+        self, version: Union[Literal["current"], Version, None]
     ) -> None:
         current_version = self.get_current_version()
 
-        if version == "current":
+        if not version or version == "current":
             return
 
         if current_version != version:
@@ -94,17 +96,19 @@ def __init__(self, cmake_content_lines: str):
 
     def get_current_version(self) -> Version:
         return (
-            parse_version(f"{self._current_version}.dev1")
+            PEP440VersioningScheme.parse_version(
+                f"{self._current_version}.dev1"
+            )
             if self.is_dev_version()
-            else parse_version(self._current_version)
+            else PEP440VersioningScheme.parse_version(self._current_version)
         )
 
     def update_version(self, new_version: Version) -> str:
-        if new_version.is_devrelease:
-            new_version = parse_version(
+        if new_version.is_dev_release:
+            new_version = PEP440VersioningScheme.parse_version(
                 f"{str(new_version.major)}."
                 f"{str(new_version.minor)}."
-                f"{str(new_version.micro)}"
+                f"{str(new_version.patch)}"
             )
             develop = True
         else:

docs/pontos/version/javascript.md

@@ -19,8 +19,8 @@
 from pathlib import Path
 from typing import Literal, Union
 
-from .scheme import VersioningScheme
-from .version import Version, VersionUpdate
+from ..schemes import VersioningScheme
+from ..version import Version, VersionUpdate
 
 
 class VersionCommand(ABC):

docs/pontos/version/python.md

@@ -19,9 +19,10 @@
 from pathlib import Path
 from typing import Literal, Union
 
-from .errors import VersionError
-from .helper import get_last_release_version
-from .version import Version, VersionCommand, VersionUpdate, parse_version
+from ..errors import VersionError
+from ..helper import get_last_release_version
+from ..version import Version, VersionUpdate
+from ._command import VersionCommand
 
 VERSION_MATCH = r'var [Vv]ersion = "(.+)"'
 TEMPLATE = """package main
@@ -60,7 +61,7 @@ def get_current_version(self) -> Version:
             )
             match = re.search(VERSION_MATCH, version_file_text)
             if match:
-                return parse_version(match.group(1))
+                return self.versioning_scheme.parse_version(match.group(1))
             else:
                 raise VersionError(
                     f"No version found in the {self.version_file_path} file."
@@ -72,12 +73,12 @@ def get_current_version(self) -> Version:
             )
 
     def verify_version(
-        self, version: Union[Literal["current"], Version]
+        self, version: Union[Literal["current"], Version, None]
     ) -> None:
         """Verify the current version of this project"""
         current_version = self.get_current_version()
 
-        if version == "current":
+        if not version or version == "current":
             return
 
         if current_version != version:
@@ -93,7 +94,9 @@ def update_version(
         try:
             current_version = self.get_current_version()
         except VersionError:
-            current_version = get_last_release_version("v")
+            current_version = get_last_release_version(
+                self.versioning_scheme.parse_version, git_tag_prefix="v"
+            )
 
         if not force and new_version == current_version:
             return VersionUpdate(previous=current_version, new=new_version)