boyska/larigira
1
0
Fork 0
Code Issues 13 Pull requests Releases Activity

Make build_sphinx work on missing apidoc

Browse source 
of course in that case there will be no API doc
This commit is contained in:
boyska 2016-08-24 11:22:12 +02:00
parent 2bde308720
commit 838e7c9c86
No known key found for this signature in database
GPG key ID: 7395DCAE58289CA9
1 changed files with 13 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
doc/source/conf.py
View file

@ -13,10 +13,13 @@
# All configuration values have a default; values that are commented out
# serve to show the default.
from __future__ import print_function
import sys
import os
import subprocess
from sphinx.util.console import red
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
@ -270,14 +273,17 @@ def run_apidoc(_):
modules = ['larigira']
exclude_files = [os.path.abspath(os.path.join(proj_dir, excl))
for excl in ('larigira/rpc.py', 'larigira/dbadmin/')]
output_path = os.path.join(cur_dir, 'api')
cmd_path = 'sphinx-apidoc'
if hasattr(sys, 'real_prefix'): # Are we in a virtualenv?
# assemble the path manually
cmd_path = os.path.abspath(os.path.join(sys.prefix,
'bin',
'sphinx-apidoc'))
if not os.path.exists(cmd_path):
print(red("No apidoc available!"), file=sys.stderr)
return
for module in modules:
output_path = os.path.join(cur_dir, 'api')
cmd_path = 'sphinx-apidoc'
if hasattr(sys, 'real_prefix'): # Are we in a virtualenv?
# assemble the path manually
cmd_path = os.path.abspath(os.path.join(sys.prefix,
'bin',
'sphinx-apidoc'))
subprocess.check_call([cmd_path,
'--force',
'-o', output_path,