LOG = logging.getLogger("conf.py")
LOG.info("Current location %r", os.getcwd())
LOG.info("DiracDocTools location %r", diracdoctools.__file__)
LOG.info("DiracDocTools location %r", diracdoctools.Utilities.__file__)
LOG.info("DiracDocTools location %r", diracdoctools.cmd.__file__)
# configuration
# 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.
# AUTO SETUP START
if os.environ.get("READTHEDOCS") == "True":
setUpReadTheDocsEnvironment(moduleName="DIRAC", location="../../src")
# re-create the RST files for the command references
LOG.info("Building command reference")
from diracdoctools.cmd.commandReference import run as buildCommandReference
buildCommandReference(configFile="../docs.conf")
# singlehtml build needs too much memory, so we need to create less code documentation
buildType = "limited" if any("singlehtml" in arg
for arg in sys.argv) else "full"
LOG.info("Chosing build type: %r", buildType)
from diracdoctools.cmd.codeReference import run as buildCodeDoc
buildCodeDoc(configFile="../docs.conf", buildType=buildType)
LOG.info('DiracDocTools location %r', diracdoctools.__file__)
LOG.info('DiracDocTools location %r', diracdoctools.Utilities.__file__)
LOG.info('DiracDocTools location %r', diracdoctools.cmd.__file__)
#...............................................................................
# configuration
# 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.
# diracdoctools are taken from integration, we need to specify this in rel-v7r0
os.environ['DIRAC_USE_M2CRYPTO'] = 'Yes'
# AUTO SETUP START
if os.environ.get('READTHEDOCS') == 'True':
setUpReadTheDocsEnvironment(moduleName='DIRAC')
# re-create the RST files for the command references
LOG.info('Building command reference')
from diracdoctools.cmd.commandReference import run as buildCommandReference
buildCommandReference(configFile='../docs.conf')
# singlehtml build needs too much memory, so we need to create less code documentation
buildType = 'limited' if any('singlehtml' in arg for arg in sys.argv) else 'full'
LOG.info('Chosing build type: %r', buildType)
from diracdoctools.cmd.codeReference import run as buildCodeDoc
buildCodeDoc(configFile='../docs.conf', buildType=buildType)
# Update dirac.cfg
LOG.info('Concatenating dirac.cfg')
from diracdoctools.cmd.concatcfg import run as updateCompleteDiracCFG
LOG.info('DiracDocTools location %r', diracdoctools.__file__)
LOG.info('DiracDocTools location %r', diracdoctools.Utilities.__file__)
LOG.info('DiracDocTools location %r', diracdoctools.cmd.__file__)
#...............................................................................
# configuration
# 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.
# diracdoctools are taken from integration, we need to specify this in rel-v7r0
os.environ['DIRAC_USE_M2CRYPTO'] = 'Yes'
# AUTO SETUP START
if os.environ.get('READTHEDOCS') == 'True':
setUpReadTheDocsEnvironment(moduleName='DIRAC', location='../../src')
# re-create the RST files for the command references
LOG.info('Building command reference')
from diracdoctools.cmd.commandReference import run as buildCommandReference
buildCommandReference(configFile='../docs.conf')
# singlehtml build needs too much memory, so we need to create less code documentation
buildType = 'limited' if any('singlehtml' in arg
for arg in sys.argv) else 'full'
LOG.info('Chosing build type: %r', buildType)
from diracdoctools.cmd.codeReference import run as buildCodeDoc
buildCodeDoc(configFile='../docs.conf', buildType=buildType)
# Update dirac.cfg
LOG.info('Concatenating dirac.cfg')