from preprocessor import Preprocessor
p = Preprocessor()

# Include paths for headers can be specified
p.add_include_path('/path/to/headers')

# You can ignore missing includes to skip system included headers, such as stdio.h
p.ignore_missing_includes = True

# Macros can be defined before parsing
p.define('MACRO_A', '1')
p.define('MACRO_B', '(x + y / z)', ['x', 'y', 'z'])

# Source or headers can be included
p.include('/path/to/file.c')

# Multiple files can be included
# Source can also be supplied in place
p.include('/dummy/path.c', """
#ifdef MACRO_A
#define MACRO_C(x,y,z)  MACRO_B(x,y,z)
#else
#define MACRO_C(x,y,z)  (1)
#endif 

int main()
{
    return MACRO_C(1,2,3);
}
"""
)

# once the required source is parsed, expressions can be expanded
print(p.expand('MACRO_A + MACRO_C(1,2,3)')) # returns "1 + (1 + 2 / 3)"

# expressions can also be evaluated if they resolve to to primitive expressions
print(p.evaluate('MACRO_A + MACRO_C(1,2,3)')) # returns 2

# The preprocessed source can then be expanded
print(p.source())
# prints:
# int main()
# {
#     return 1 + 2 / 3;
# }