Provide a --version option

src/towncrier/_shell.py

@@ -11,9 +11,11 @@
 from .build import _main as _build_cmd
 from .check import _main as _check_cmd
 from .create import _main as _create_cmd
+from ._version import __version__
 
 
 @click.group(cls=DefaultGroup, default="build", default_if_no_args=True)
+@click.version_option(__version__.public())
 def cli():
     pass
 

src/towncrier/newsfragments/339.feature.rst

@@ -0,0 +1 @@
+towncrier --version` was added to the command line interface to show the product version.

src/towncrier/test/test_project.py

@@ -116,6 +116,13 @@ def test_dash_m(self):
             os.makedirs("news")
             out = check_output([sys.executable, "-m", "towncrier", "--help"])
             self.assertIn(b"[OPTIONS] COMMAND [ARGS]...", out)
-            self.assertIn(b"--help  Show this message and exit.", out)
+            self.assertRegex(out, br".*--help\s+Show this message and exit.")
         finally:
             os.chdir(orig_dir)
+
+    def test_version(self):
+        """
+        `--version` command line option is available to show the current production version.
+        """
+        out = check_output(["towncrier", "--version"])
+        self.assertTrue(out.startswith(b"towncrier, version 2"))