add --strip-dev flag to command

fixes #222

Author: RonnyPfannschmidt

CHANGELOG.rst

@@ -12,6 +12,8 @@
 * better handling of setuptools install command deprecation
 * consider ``pyproject.tomls`` when running as command
 * use list in git describe command to avoid shell expansions while supporting both windows and posix
+* add ``--strip-dev`` flag to ``python -m setuptools_scm`` to print the next guessed version cleanly
+
 
 6.3.2
 =====

src/setuptools_scm/__main__.py

@@ -1,6 +1,6 @@
 import argparse
 import os
-import warnings
+import sys
 
 from setuptools_scm import _get_version
 from setuptools_scm.config import Configuration
@@ -15,14 +15,21 @@ def main() -> None:
     try:
         pyproject = opts.config or _find_pyproject(root)
         root = opts.root or os.path.relpath(os.path.dirname(pyproject))
-        config = Configuration.from_file(pyproject)
-        config.root = root
+        config = Configuration.from_file(pyproject, root=root)
     except (LookupError, FileNotFoundError) as ex:
         # no pyproject.toml OR no [tool.setuptools_scm]
-        warnings.warn(f"{ex}. Using default configuration.")
-        config = Configuration(root)
+        print(
+            f"Warning: could not use {os.path.relpath(pyproject)},"
+            " using default configuration.\n"
+            f" Reason: {ex}.",
+            file=sys.stderr,
+        )
+        config = Configuration(root=root)
 
-    print(_get_version(config))
+    version = _get_version(config)
+    if opts.strip_dev:
+        version = version.partition(".dev")[0]
+    print(version)
 
     if opts.command == "ls":
         for fname in find_files(config.root):
@@ -48,6 +55,11 @@ def _get_cli_opts():
         help="path to 'pyproject.toml' with setuptools_scm config, "
         "default: looked up in the current or parent directories",
     )
+    parser.add_argument(
+        "--strip-dev",
+        action="store_true",
+        help="remove the dev/local parts of the version before printing the version",
+    )
     sub = parser.add_subparsers(title="extra commands", dest="command", metavar="")
     # We avoid `metavar` to prevent printing repetitive information
     desc = "List files managed by the SCM"

src/setuptools_scm/config.py

@@ -168,6 +168,7 @@ def from_file(
         name: str = "pyproject.toml",
         dist_name=None,  # type: str | None
         _load_toml=_lazy_tomli_load,
+        **kwargs,
     ):
         """
         Read Configuration from pyproject.toml (or similar).
@@ -198,7 +199,7 @@ def from_file(
         if dist_name is None:
             dist_name = _read_dist_name_from_setup_cfg()
 
-        return cls(dist_name=dist_name, **section)
+        return cls(dist_name=dist_name, **section, **kwargs)
 
 
 def _read_dist_name_from_setup_cfg():