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')