feat: Add --version and -V cli flag.

Issue #: mkdocstrings#186
PR mkdocstrings#174: mkdocstrings#187

src/griffe/__init__.py

@@ -16,6 +16,9 @@
 from griffe.loader import load
 from griffe.logger import get_logger
 
+# For acceptable version formats, see https://www.python.org/dev/peps/pep-0440/
+__version__ = '0.32.3'
+
 __all__: list[str] = [
     "Attribute",
     "Class",
@@ -32,3 +35,4 @@
     "Object",
     "ObjectNode",
 ]
+

src/griffe/cli.py

@@ -24,6 +24,7 @@
 
 import colorama
 
+from griffe import __version__
 from griffe.diff import ExplanationStyle, find_breaking_changes
 from griffe.docstrings.parsers import Parser
 from griffe.encoders import JSONEncoder
@@ -122,6 +123,7 @@ def get_parser() -> argparse.ArgumentParser:
 
     global_options = parser.add_argument_group(title="Global options")
     global_options.add_argument("-h", "--help", action="help", help=main_help)
+    global_options.add_argument("-V", "--version", action="version", version=f'%(prog)s ' + __version__)
 
     def add_common_options(subparser: argparse.ArgumentParser) -> None:
         common_options = subparser.add_argument_group(title="Common options")