sorry i missed this: we have an existing API for this which Eric improved over here: https://github.com/pantsbuild/pants/pull/16563