X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=blobdiff_plain;f=docs%2Fconf.py;fp=docs%2Fconf.py;h=b007a9e9917d5920d5899562dff70ed7573aa68b;hb=27090106c7bb23ff93bda6bb9798fe3b94686124;hp=d5decd537bc2f718d85d324649db233a2630a35b;hpb=1446ca9ed6f9eab0f36a5a45f4b62a377341b7f5;p=releng%2Fglobal-jjb.git diff --git a/docs/conf.py b/docs/conf.py index d5decd53..b007a9e9 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -18,10 +18,24 @@ # documentation root, use os.path.abspath to make it absolute, like shown here. # import os +import subprocess import sys import sphinx_bootstrap_theme + sys.path.insert(0, os.path.abspath('..')) + +def format_version(version): + fmt = '{tag}.dev{commitcount}+{gitsha}' + parts = version.split('-') + assert len(parts) in (3, 4) + dirty = len(parts) == 4 + tag, count, sha = parts[:3] + if count == '0' and not dirty: + return tag + return fmt.format(tag=tag, commitcount=count, gitsha=sha.lstrip('g')) + + # -- General configuration ------------------------------------------------ # If your documentation needs a minimal Sphinx version, state it here. @@ -67,7 +81,13 @@ author = 'Linux Foundation Releng' # built documents. # # The short X.Y version. -version = '0.21.0-dev' +command = 'git describe --tags --long --dirty' +try: + git_version = format_version( + subprocess.check_output(command.split()).decode('utf-8').strip()) +except subprocess.CalledProcessError: # Handle docs builds from tarball + git_version = "v0.0.9999-local" +version = git_version # The full version, including alpha/beta/rc tags. release = version