Ergonomic, hermetic, user-friendly software build system for Python, Go, Java, Kotlin, Protobuf, Scala, Shell. Pants lets you fearlessly scale up your codebase!

Pants

hi! is there a document that describes the precedence with with Options are applied? i.e. if an Option is set in the pants toml file, and also via a cli flag, and also via an env var, which value will win? I don't see that documented on <https://www.pantsbuild.org/2.20/docs/using-pants/key-concepts/options|this page>. thanks!

I think the order is (from lowest priority to highest)
• pants built in default
• Pants.toml
• Env var
• CLI flag

Btw the page you found has a section that lists them “by precedence” which I think is what you wanted to know: <https://www.pantsbuild.org/2.20/docs/using-pants/key-concepts/options#setting-options|https://www.pantsbuild.org/2.20/docs/using-pants/key-concepts/options#setting-options>

Can you think of how we could improve the docs to make it clearer for next time?

wow it was right in front of my face :face_palm:

it could certainly be clearer by moving the precedence details to its own section and explicitly calling out which is lowest and which is highest

No need to apologise, I was genuinely asking to see how we could make it better, and less likely for someone to miss it