buildtools/call-sphinx-build.py

   1 #! /usr/bin/env python3
   2 # SPDX-License-Identifier: BSD-3-Clause
   3 # Copyright(c) 2019 Intel Corporation
   4 #
   5
   6 import sys
   7 import os
   8 from os.path import join
   9 from subprocess import run, PIPE, STDOUT
  10 from distutils.version import StrictVersion
  11
  12 (sphinx, version, src, dst) = sys.argv[1:]  # assign parameters to variables
  13
  14 # set the version in environment for sphinx to pick up
  15 os.environ['DPDK_VERSION'] = version
  16
  17 # for sphinx version >= 1.7 add parallelism using "-j auto"
  18 ver = run([sphinx, '--version'], stdout=PIPE,
  19           stderr=STDOUT).stdout.decode().split()[-1]
  20 sphinx_cmd = [sphinx]
  21 if StrictVersion(ver) >= StrictVersion('1.7'):
  22     sphinx_cmd += ['-j', 'auto']
  23
  24 # find all the files sphinx will process so we can write them as dependencies
  25 srcfiles = []
  26 for root, dirs, files in os.walk(src):
  27     srcfiles.extend([join(root, f) for f in files])
  28
  29 # run sphinx, putting the html output in a "html" directory
  30 process = run(sphinx_cmd + ['-b', 'html', src, join(dst, 'html')], check=True)
  31 print(str(process.args) + ' Done OK')
  32
  33 # create a gcc format .d file giving all the dependencies of this doc build
  34 with open(join(dst, '.html.d'), 'w') as d:
  35     d.write('html: ' + ' '.join(srcfiles) + '\n')