FYI plugin authors with custom target types: 1.30.0 will require writing light weight bindings for the new Target API. See https://groups.google.com/forum/#!topic/pants-devel/WsRFODRLVZI for more context. As mentioned there, we would be happy to help you do write these bindings!

none of the documentation linked from that post contain the word "bindings"; are the docs up-to-date?

Hey Wyatt, yes, they are. Slightly confusing because the docs take the perspective of using entirely V2, ie not having V1 custom targets already. The concepts page is a brief FYI on how the target api works. You can skim it. Most of the work is are on the “Creating new fields” page. That’s 80% of what’s involved. Then finally “creating new targets” (Btw, you’ll want to be on 1.28.0 or newer)

@astonishing-jelly-60479: bindings are mentioned at the bottom of https://pants.readme.io/docs/target-api-new-targets

@witty-crayon-22786 those are bindings in the reverse direction, when you wrote a V2 target and plan to use that in your plugin, but need a V1 binding for V1 goals to still work.

well then i am also confused 😃

* No matter what, you need a V2 target definition so that Pants can parse your target when running in V2 mode. Even if you’re not yet using V2 Python, we are switch several core goals like

list

to run with V2. * Unless you are completely V2, you will need a V1 Target definition so that Pants can parse the target when running in V1 mode. If your plugin is written in V2, then the V1 binding can be a dummy binding just so that Pants can parse things.

yep, fine. but is it a “different type” of binding, or is that same type of binding that is described on the linked page?

The bulk of the new docs talk about how to write a V2 target definition. That one small part you linked to is about writing the V1 target definition.