Add a "only-version" version scheme

docs/extending.md

@@ -84,6 +84,8 @@ representing the version.
 `no-guess-dev`
 : Does no next version guessing, just adds `.post1.devN`
 
+`just-version`
+: Just use the version from the tag, as given.
 
 ### `setuptools_scm.local_scheme`
 Configures how the local part of a version is rendered given a

pyproject.toml

@@ -101,6 +101,7 @@ PKG-INFO = "setuptools_scm.fallbacks:parse_pkginfo"
 "post-release" = "setuptools_scm.version:postrelease_version"
 "python-simplified-semver" = "setuptools_scm.version:simplified_semver_version"
 "release-branch-semver" = "setuptools_scm.version:release_branch_semver_version"
+"just-version" = "setuptools_scm.version:just_version"
 
 [tool.setuptools.packages.find]
 where = ["src"]

src/setuptools_scm/version.py

@@ -299,6 +299,10 @@ def release_branch_semver(version: ScmVersion) -> str:
     return release_branch_semver_version(version)
 
 
+def just_version(version: ScmVersion) -> str:
+    return version.format_with("{tag}")
+
+
 def no_guess_dev_version(version: ScmVersion) -> str:
     if version.exact:
         return version.format_with("{tag}")

testing/test_version.py

@@ -18,6 +18,7 @@
 from setuptools_scm.version import release_branch_semver_version
 from setuptools_scm.version import ScmVersion
 from setuptools_scm.version import simplified_semver_version
+from setuptools_scm.version import just_version
 
 
 c = Configuration()
@@ -169,6 +170,32 @@ def test_bump_dev_version_nonzero_raises() -> None:
     with pytest.raises(ValueError, match=match):
         guess_next_version(m("1.0.dev1"))
 
+@pytest.mark.parametrize(
+    "version",
+    [
+        "1.dev0",
+        "1.0.dev456",
+        "1.0a1",
+        "1.0a2.dev456",
+        "1.0a12.dev456",
+        "1.0a12",
+        "1.0b1.dev456",
+        "1.0b2",
+        "1.0b2.post345.dev456",
+        "1.0b2.post345",
+        "1.0rc1.dev456",
+        "1.0rc1",
+        "1.0",
+        "1.0.post456.dev34",
+        "1.0.post456",
+        "1.0.15",
+        "1.1.dev1",
+    ],
+)
+def test_just_version(version: str) -> None:
+    assert version == just_version(meta(version, config=c))
+    assert version == just_version(meta(version, distance=2, config=c))
+
 
 @pytest.mark.parametrize(
     ("tag", "expected"),