Refactor version schemes into proper package structure

- Create _scm_version.py module with ScmVersion, meta(), tag_to_version() and parsing utilities
- Create _version_schemes/ package with organized submodules:
  - _common.py: shared utilities (SEMVER constants, combine_version_with_local_parts)
  - _standard.py: standard version and local schemes
  - _towncrier.py: towncrier-based version scheme
  - __init__.py: public API with format_version()
- Update all imports throughout vcs-versioning and setuptools-scm
- Update test imports to use new module structure
- Delete old _version_schemes.py and _version_schemes_towncrier.py files

This refactoring improves code organization by:
1. Separating the core ScmVersion data structure from version schemes
2. Grouping related schemes in dedicated modules
3. Making the package structure more maintainable and extensible
4. Maintaining full backward compatibility through re-exports

All tests pass (380 vcs-versioning + 127 setuptools-scm)

Author: RonnyPfannschmidt

vcs-versioning/src/vcs_versioning/__init__.py

@@ -10,9 +10,9 @@
 # Public API exports
 from ._config import DEFAULT_LOCAL_SCHEME, DEFAULT_VERSION_SCHEME, Configuration
 from ._pyproject_reading import PyProjectData
+from ._scm_version import ScmVersion
 from ._version_cls import NonNormalizedVersion, Version
 from ._version_inference import infer_version_string
-from ._version_schemes import ScmVersion
 
 
 def build_configuration_from_pyproject(

vcs-versioning/src/vcs_versioning/_backends/_git.py

@@ -21,7 +21,7 @@
 from .._run_cmd import CompletedProcess as _CompletedProcess
 from .._run_cmd import require_command as _require_command
 from .._run_cmd import run as _run
-from .._version_schemes import ScmVersion, meta, tag_to_version
+from .._scm_version import ScmVersion, meta, tag_to_version
 from ._scm_workdir import Workdir, get_latest_file_mtime
 
 if TYPE_CHECKING:

vcs-versioning/src/vcs_versioning/_backends/_hg.py

@@ -12,8 +12,8 @@
 from .._run_cmd import CompletedProcess
 from .._run_cmd import require_command as _require_command
 from .._run_cmd import run as _run
+from .._scm_version import ScmVersion, meta, tag_to_version
 from .._version_cls import Version
-from .._version_schemes import ScmVersion, meta, tag_to_version
 from ._scm_workdir import Workdir, get_latest_file_mtime
 
 log = logging.getLogger(__name__)

vcs-versioning/src/vcs_versioning/_backends/_scm_workdir.py

@@ -6,7 +6,7 @@
 from pathlib import Path
 
 from .._config import Configuration
-from .._version_schemes import ScmVersion
+from .._scm_version import ScmVersion
 
 log = logging.getLogger(__name__)
 

vcs-versioning/src/vcs_versioning/_dump_version.py

@@ -11,7 +11,7 @@
 
 if TYPE_CHECKING:
     from . import _types as _t
-    from ._version_schemes import ScmVersion
+    from ._scm_version import ScmVersion
 
 log = logging.getLogger(__name__)
 

vcs-versioning/src/vcs_versioning/_entrypoints.py

@@ -12,21 +12,21 @@
 ]
 if TYPE_CHECKING:
     from . import _types as _t
-    from . import _version_schemes
     from ._config import Configuration, ParseFunction
+    from ._scm_version import ScmVersion
 
 log = logging.getLogger(__name__)
 
 
 def version_from_entrypoint(
     config: Configuration, *, entrypoint: str, root: _t.PathT
-) -> _version_schemes.ScmVersion | None:
+) -> ScmVersion | None:
     from ._discover import iter_matching_entrypoints
 
     log.debug("version_from_ep %s in %s", entrypoint, root)
     for ep in iter_matching_entrypoints(root, entrypoint, config):
         fn: ParseFunction = ep.load()
-        maybe_version: _version_schemes.ScmVersion | None = fn(root, config=config)
+        maybe_version: ScmVersion | None = fn(root, config=config)
         log.debug("%s found %r", ep, maybe_version)
         if maybe_version is not None:
             return maybe_version
@@ -55,7 +55,7 @@ def _iter_version_schemes(
     entrypoint: str,
     scheme_value: _t.VERSION_SCHEMES,
     _memo: set[object] | None = None,
-) -> Iterator[Callable[[_version_schemes.ScmVersion], str]]:
+) -> Iterator[Callable[[ScmVersion], str]]:
     if _memo is None:
         _memo = set()
     if isinstance(scheme_value, str):
@@ -75,7 +75,7 @@ def _iter_version_schemes(
 
 
 def _call_version_scheme(
-    version: _version_schemes.ScmVersion,
+    version: ScmVersion,
     entrypoint: str,
     given_value: _t.VERSION_SCHEMES,
     default: str | None = None,

vcs-versioning/src/vcs_versioning/_fallbacks.py

@@ -9,7 +9,7 @@
     from . import _types as _t
 from ._config import Configuration
 from ._integration import data_from_mime
-from ._version_schemes import ScmVersion, meta, tag_to_version
+from ._scm_version import ScmVersion, meta, tag_to_version
 
 log = logging.getLogger(__name__)
 

vcs-versioning/src/vcs_versioning/_get_version_impl.py

@@ -12,8 +12,8 @@
 from . import _types as _t
 from ._config import Configuration
 from ._overrides import _read_pretended_version_for
+from ._scm_version import ScmVersion
 from ._version_cls import _validate_version_cls
-from ._version_schemes import ScmVersion
 from ._version_schemes import format_version as _format_version
 
 EMPTY_TAG_REGEX_DEPRECATION = DeprecationWarning(

vcs-versioning/src/vcs_versioning/_overrides.py

@@ -19,7 +19,7 @@
 
 from . import _config
 from . import _types as _t
-from . import _version_schemes as version
+from ._scm_version import ScmVersion, meta  # noqa: F401 - for type checking
 from ._version_cls import Version as _Version
 
 log = logging.getLogger(__name__)
@@ -173,9 +173,9 @@ def _read_pretended_metadata_for(
 
 
 def _apply_metadata_overrides(
-    scm_version: version.ScmVersion | None,
+    scm_version: ScmVersion | None,
     config: _config.Configuration,
-) -> version.ScmVersion | None:
+) -> ScmVersion | None:
     """Apply metadata overrides to a ScmVersion object.
 
     This function reads pretend metadata from environment variables and applies
@@ -247,7 +247,7 @@ def _apply_metadata_overrides(
 
 def _read_pretended_version_for(
     config: _config.Configuration,
-) -> version.ScmVersion | None:
+) -> ScmVersion | None:
     """read a a overridden version from the environment
 
     tries ``SETUPTOOLS_SCM_PRETEND_VERSION``
@@ -265,7 +265,7 @@ def _read_pretended_version_for(
     pretended = reader.read("PRETEND_VERSION")
 
     if pretended:
-        return version.meta(tag=pretended, preformatted=True, config=config)
+        return meta(tag=pretended, preformatted=True, config=config)
     else:
         return None