fab.steps.preprocess module

Fortran and C Preprocessing.

class fab.steps.preprocess.MpCommonArgs(config, output_suffix, preprocessor, flags, name)

Bases: object

Common args for calling process_artefact() using multiprocessing.

config: BuildConfig

output_suffix: str

preprocessor: Preprocessor

flags: FlagsConfig

name: str

fab.steps.preprocess.pre_processor(config, preprocessor, files, output_collection, output_suffix, common_flags=None, path_flags=None, name='preprocess')

Preprocess Fortran or C files.

Uses multiprocessing, unless disabled in the config.

Parameters:

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

• preprocessor (Preprocessor) – The preprocessor executable.

• files (Collection[Path]) – The files to preprocess.

• output_collection (Union[str, ArtefactSet]) – The name of the output artefact collection.

• output_suffix – Suffix for output files.

• common_flags (Optional[List[str]]) – Used to construct a FlagsConfig object. (default: None)

• path_flags (Optional[List]) – Used to construct a FlagsConfig object. (default: None)

• name – Human friendly name for logger output, with sensible default. (default: 'preprocess')

fab.steps.preprocess.process_artefact(arg)

Expects an input file in the source folder. Writes the output file to the output folder, with a lower case extension.

fab.steps.preprocess.preprocess_fortran(config, source=None, **kwargs)

Wrapper to pre_processor for Fortran files.

Ensures all preprocessed files are in the build output. This means copying already preprocessed files from source to build output.

Params as per _pre_processor().

The preprocessor is taken from the FPP environment, or falls back to fpp -P.

If source is not provided, it defaults to SuffixFilter(ArtefactStore.FORTRAN_BUILD_FILES, ‘.F90’).

class fab.steps.preprocess.DefaultCPreprocessorSource

Bases: ArtefactsGetter

A source getter specifically for c preprocessing. Looks for the default output from pragma injection, falls back to default source finder. This allows the step to work with or without a preceding pragma step.

fab.steps.preprocess.preprocess_c(config, source=None, **kwargs)

Wrapper to pre_processor for C files.

Params as per _pre_processor(). If source is not provided, it defaults to DefaultCPreprocessorSource.