poetry icon indicating copy to clipboard operation
poetry copied to clipboard

[docs] configuration documentation does not specify the precedence of each method

Open danielknell opened this issue 3 years ago • 3 comments

  • [x] I have searched the issues of this repo and believe that this is not a duplicate.

Issue

https://python-poetry.org/docs/configuration/ specifies which methods are availible to configure poetry, but does not specify the precedence of the options.

e.g. if a value is set via both poetry config, poetry config --local, and an environment variable, the documentation does not specify which method will be picked.

(local trumping global is obvious, but local vs env is less so)

looking at the code it looks like the sources have the following priority (top wins):

  • environment var
  • ./poetry.toml
  • ~/.config/pypoetry/auth.toml
  • ~/.config/pypoetry/config.toml

it would be nice to have this formalised so we can be confident it wont change without warning.

danielknell avatar Jan 12 '22 14:01 danielknell