MacroPy3 1.1.0b2
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:
Tracing
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
Quick Lambdas
print(list(map(f[_[0]], ['omg', 'wtf', 'bbq'])))
# ['o', 'w', 'b']
print(list(reduce(f[_ + _], ['omg', 'wtf', 'bbq'])))
# 'omgwtfbbq
Case Classes
@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/.
Requirements
MacroPy3 is tested to run on CPython 3.4 or newer and PyPy 3.5. I has no current support for Jython. MacroPy3 is also available on PyPI.
Installation
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 pinq
or pyxl
extras like this:
$ pip install macropy3[pinq,pyxl]
then have a look at the docs at http://macropy3.readthedocs.io/en/latest/.