fab.steps.c_pragma_injector module

Add custom pragmas to C code which identify user and system include regions.

fab.steps.c_pragma_injector.c_pragma_injector(config, source=None, output_name=None)

A build step to inject custom pragmas to mark blocks of user and system include statements.

By default, reads .c files from the all_source artefact and creates the pragmad_c artefact.

This step does not write to the build output folder, it creates the pragmad c in the same folder as the c file. This is because a subsequent preprocessing step needs to look in the source folder for header files, including in paths relative to the c file.

Parameters:

  • config – The fab.build_config.BuildConfig object where we can read settings such as the project workspace folder or the multiprocessing flag.

  • source (Optional[ArtefactsGetter]) – (default: None) An ArtefactsGetter which give us our c files to process.

  • output_name – (default: None) The name of the artefact collection to create in the artefact store, with a sensible default

fab.steps.c_pragma_injector.inject_pragmas(fpath)

Reads a C source file but when encountering an #include preprocessor directive injects a special Fab-specific #pragma which can be picked up later by the Analyser after the preprocessing