def _build_plugin_docs(package):
"""Build Sphinx project files for a plugin."""
project = SphinxProject(
PLUGIN_PATH / package, PLUGIN_DOCS_PATH / package)
if project.project_exists():
if not plugin_manager.is_loaded(package):
logger.log_message(
'Plugin must be loaded to build the project files.')
return
try:
project.build()
except:
except_hooks.print_exception()
logger.log_message(
'An error occured while building project ' +
'files for plugin "{0}".'.format(package))
else:
logger.log_message(
'Project files have been built for ' +
'plugin "{0}".'.format(package))
else:
logger.log_message(
'Sphinx project does not exist for ' +
'plugin "{0}".'.format(package))
def _build_source_python_docs():
"""Build Sphinx project files for Source.Python."""
project = SphinxProject(SP_PACKAGES_PATH, SP_DOCS_PATH)
if project.project_exists():
# Update version and release
conf_file = project.project_source_dir / 'conf.py'
with conf_file.open() as f:
lines = f.readlines()
# Get the version string
version = '' if is_unversioned() else f'v{VERSION}'
with conf_file.open('w') as f:
for line in lines:
if line.startswith(('version', 'release')):
line = '{0} = \' {1}\'\n'.format(
line.split(maxsplit=1)[0], version)
f.write(line)
# Create/update credits.rst
with project.project_source_dir.joinpath('general',
'credits.rst').open('w') as f:
f.write(_get_updated_credits_wiki())
try:
project.build()
except:
logger.log_message('An error occured while building ' +
'project files for Source.Python.')
else:
logger.log_message(
'Project files have been built for Source.Python.')
else:
logger.log_message('Sphinx project does not exist for Source.Python.')
def _build_custom_package_docs(package):
"""Build Sphinx project files for a custom package."""
project = SphinxProject(CUSTOM_PACKAGES_PATH / package,
CUSTOM_PACKAGES_DOCS_PATH / package)
if project.project_exists():
try:
project.build()
except:
logger.log_message(
'An error occured while building project ' +
'files for custom package "{0}".'.format(package))
else:
logger.log_message('Project files have been built for ' +
'custom package "{0}".'.format(package))
else:
logger.log_message('Sphinx project does not exist for ' +
'custom package "{0}".'.format(package))
def _build_custom_package_docs(self, package):
"""Build Sphinx project files for a custom package."""
project = SphinxProject(
CUSTOM_PACKAGES_PATH / package,
CUSTOM_PACKAGES_DOCS_PATH / package)
if project.project_exists():
try:
project.build()
except:
self.logger.log_message(
'An error occured while building project ' +
'files for custom package "{0}".'.format(package))
else:
self.logger.log_message(
'Project files have been built for ' +
'custom package "{0}".'.format(package))
else:
self.logger.log_message(
'Sphinx project does not exist for ' +
'custom package "{0}".'.format(package))
def _build_source_python_docs(self):
"""Build Sphinx project files for Source.Python."""
project = SphinxProject(SP_PACKAGES_PATH, SP_DOCS_PATH)
if project.project_exists():
# Update version and release
conf_file = project.project_source_dir / 'conf.py'
with conf_file.open() as f:
lines = f.readlines()
# Get the version string
version = VERSION if VERSION == 'unversioned' else (
'v{0}'.format(VERSION))
with conf_file.open('w') as f:
for line in lines:
if line.startswith(('version', 'release')):
line = '{0} = \' {1}\'\n'.format(
line.split(maxsplit=1)[0], version)
f.write(line)
# Create/update credits.rst
with project.project_source_dir.joinpath(
'general', 'credits.rst').open('w') as f:
f.write(self._get_updated_credits_wiki())
try:
project.build()
except:
self.logger.log_message(
'An error occured while building ' +
'project files for Source.Python.')
else:
self.logger.log_message(
'Project files have been built for Source.Python.')
else:
self.logger.log_message(
'Sphinx project does not exist for Source.Python.')
def _build_plugin_docs(self, package):
"""Build Sphinx project files for a plugin."""
project = SphinxProject(
PLUGIN_PATH / package, PLUGIN_DOCS_PATH / package)
if project.project_exists():
if not self.manager.is_loaded(package):
self.logger.log_message(
'Plugin must be loaded to build the project files.')
return
try:
project.build()
except:
self.logger.log_message(
'An error occured while building project ' +
'files for plugin "{0}".'.format(package))
else:
self.logger.log_message(
'Project files have been built for ' +
'plugin "{0}".'.format(package))
else:
self.logger.log_message(
'Sphinx project does not exist for ' +
'plugin "{0}".'.format(package))
