Ichthyostega
109d682408
Knowledge-Technology(Claude Opus 5) used - to assess the situation and present implementation avenues - for discussion while shaping the solution - for generating code and validating results Clang based tooling is used frequently for code analysis and navigation. This requires however that the exact flags and invocation is captured for each possible translation unit in the code base. That knowledge exists solely in the build system, and the established way to hand it over is the LLVM "JSON Compilation Database". SCons has provided a `CompilationDatabase` builder since 4.0, and it fits our setup well: it installs an emitter on the object builders and captures each command line while the dependency graph is constructed. Hence nothing is compiled -- generating takes about two seconds -- and the result always describes the complete build graph as declared, rather than the target actually requested on this invocation. This feature is provided as ''opt-in'', either through the sticky option `COMPILEDB=yes` or by direct invocation with `scons compiledb` The `compile_commands.json` is generated into the build output `target/' dir For configuration, a `.clangd` in project root instructs the language server where to find this file. __Note__ the ordering constraint recorded in `CompileDB.py`: the emitter must be installed only after `Platform.configure()` has run, or it also captures the `conftest_*` compilations of the configure checks. That is why this is a plain helper invoked from the `SConstruct` -- similar to Setup, Options, Platform -- and not a tool loaded from the `LumieraEnvironment`.
79 lines
2.3 KiB
Python
79 lines
2.3 KiB
Python
# coding: utf-8
|
||
##
|
||
## SConstruct - SCons based build-system for Lumiera
|
||
##
|
||
|
||
# Copyright (C)
|
||
# 2008-2025 Hermann Vosseler <Ichthyostega@web.de>
|
||
#
|
||
# **Lumiera** is free software; you can redistribute it and/or modify it
|
||
# under the terms of the GNU General Public License as published by the
|
||
# Free Software Foundation; either version 2 of the License, or (at your
|
||
# option) any later version. See the file COPYING for further details.
|
||
#####################################################################
|
||
|
||
|
||
# NOTE: scons -h for help.
|
||
# This script /defines/ the components and how they fit together.
|
||
# SCons will derive dependencies and the necessary build steps.
|
||
# Read more about the SCons build system at: https://www.scons.org
|
||
|
||
|
||
# NOTE: Lumiera SCons extension modules and plugins
|
||
#--------------------------------------------------
|
||
import sys
|
||
sys.path.append('./admin/scons')
|
||
#--------------------------------------------------
|
||
|
||
|
||
import Setup
|
||
import Options
|
||
import Platform
|
||
import CompileDB
|
||
|
||
from Buildhelper import *
|
||
from LumieraEnvironment import *
|
||
|
||
|
||
|
||
#####################################################################
|
||
|
||
env = Setup.defineBuildEnvironment() # dirs & compiler flags
|
||
env = Platform.configure(env) # library dependencies
|
||
compileDB = CompileDB.setup(env) # code intelligence (opt-in: COMPILEDB=yes)
|
||
|
||
|
||
|
||
### === MAIN BUILD === ##############################################
|
||
|
||
# call subdir SConscript(s) to define the actual build targets...
|
||
SConscript(dirs=['data','src','src/tool','research','tests','doc'], exports='env')
|
||
|
||
|
||
|
||
|
||
# additional files to be cleaned when cleaning 'build'
|
||
env.Clean ('build', [ 'scache.conf', '.sconf_temp', '.sconsign.dblite', 'config.log' ])
|
||
|
||
|
||
|
||
### === Alias Targets === ###########################################
|
||
|
||
# pick up the targets defined by the sub SConscripts
|
||
#Import('lumiera plugins tools gui testsuite doxydoc')
|
||
Import('lumiera plugins tools gui testsuite')
|
||
|
||
build = env.Alias('build', lumiera + plugins + tools + gui + compileDB)
|
||
# this defines the SCons **default target**
|
||
env.Default('build')
|
||
|
||
|
||
#env.Alias ('all', build + testsuite + doxydoc)
|
||
env.Alias ('all', build + testsuite)
|
||
#env.Alias ('doc', doxydoc)
|
||
env.Alias ('none')
|
||
|
||
env.Alias('install', gui)
|
||
env.Alias('install', '$DESTDIR')
|
||
|
||
#####################################################################
|