materials

doxygen.py
View Options

			# -- coding: utf-8 --

			# @file
			# @section LICENSE
			#
			# Copyright (©) 2016-2021 EPFL (École Polytechnique Fédérale de Lausanne),
			# Laboratory (LSMS - Laboratoire de Simulation en Mécanique des Solides)
			#
			# This program is free software: you can redistribute it and/or modify
			# it under the terms of the GNU Affero General Public License as published
			# by the Free Software Foundation, either version 3 of the License, or
			# (at your option) any later version.
			#
			# This program is distributed in the hope that it will be useful,
			# but WITHOUT ANY WARRANTY; without even the implied warranty of
			# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
			# GNU Affero General Public License for more details.
			#
			# You should have received a copy of the GNU Affero General Public License
			# along with this program. If not, see <https://www.gnu.org/licenses/>.

			"""
			SCons tool to generate Doxygen API documentation
			"""

			from __future__ import print_function

			from SCons.Script import Builder, Action


			def generate(env):
			action = 'doxygen $SOURCE'

			if env['verbose']:
			action = Action(action)
			else:
			action = Action(action,
			cmdstr='{}[Doxygen] {}$SOURCE'.format(
			env['COLOR_DICT']['orange'],
			env['COLOR_DICT']['end']
			))

			doxygen_builder = Builder(action=action)
			env['BUILDERS']['Doxygen'] = doxygen_builder


			def exists(env):
			return env.Detect('doxygen')