TIL that

bdist

means

built distribution

, not

binary distribution

I think that's a distinction without a difference. Did learning that clear something else up?

Made my understanding more nuanced. I thought that

bdist

and

wheel

were synonymous. Turns out they’re not: https://docs.python.org/3/distutils/builtdist.html Context is that I’m finally attempting https://pants.readme.io/docs/python-platforms. Benjy has asked for a page the past month to explain platforms, because it’s one of the things we get the most questions and confusion with

Ah. That would be more clear from the CLI, where you have to ask

python setup.py bdist-wheel

as distinct from other forms of bdist, and you can only ask with the wheel package available to said

python

.

(not yet ready for review. still trying to figure out the best way to handle this, and the eternal struggle of how much in the weeds to go)

Without reading what you wrote, the platform used by Pants is synonymous with the wheel platform. So I think you just need to decide whether to reference the wheel PEPs or rewrite them.