MacroPy is an implementation of Syntactic Macros in the Python Programming Language. MacroPy provides a mechanism for user-defined functions (macros) to perform transformations on the abstract syntax tree (AST) of a Python program at import time. This is an easy way to enhance the semantics of a Python program in ways which are otherwise impossible, for example providing an extremely concise way of declaring classes.
Python like you've never seen before
MacroPy allows you to create constructs which are impossible to have in normal python code, such as:
with trace: sum([x + 5 for x in range(3)]) # sum([x + 5 for x in range(3)]) # range(3) -> [0, 1, 2] # x + 5 -> 5 # x + 5 -> 6 # x + 5 -> 7 # [x + 5 for x in range(3)] -> [5, 6, 7] # sum([x + 5 for x in range(3)]) -> 18
print(list(map(f[_], ['omg', 'wtf', 'bbq']))) # ['o', 'w', 'b'] print(list(reduce(f[_ + _], ['omg', 'wtf', 'bbq']))) # 'omgwtfbbq
@case class Point(x, y): pass p = Point(1, 2) print str(p) #Point(1, 2) print p.x #1 print p.y #2 print Point(1, 2) == Point(1, 2) # True
and more! See the docs at http://macropy3.readthedocs.io/en/latest/.
Just execute a:
$ pip install macropy3
if you want to use macros that require external libraries in order to work, you can automatically install those dependencies by installing one of the
pyxl extras like this:
$ pip install macropy3[pinq,pyxl]
then have a look at the docs at http://macropy3.readthedocs.io/en/latest/.