fyi I added docs on the new macros feature: https://pants.readme.io/docs/macros

Looks great 🙂 One thing I’d add an example of is that a macro can make multiple targets. An example in keeping with your existing ones could be:

def python23_tests(name, **kwargs):
  kwargs.pop("compatibility", None)

  python_tests(
    name = name + "_py2",
    compatibility = "==2.7.*",
    **kwargs
  )

  python_tests(
    name = name + "_py3",
    compatibility = ">=3.5",
    **kwargs
  )