poetry icon indicating copy to clipboard operation
poetry copied to clipboard

local-configurations VS global-configurations, which takes precedence

Open nhadziosma1 opened this issue 9 months ago • 1 comments

Issue Kind

Unclear documentation

Existing Link

https://python-poetry.org/docs/configuration/

Description

It is clearly stated in your documentation that poetry can be configured both locally and globally:

  • The file poetry.toml stores local-configurations of poetry.
  • The file config.toml stores the global-configurations of poetry.

However, the documentation does not specify what would happen if the same configuration (i.e. setting) was set in both files (i.e. both globally and locally) to a different option. My guess is that the local-configuration (i.e. the configuration in the poetry.toml file) would take precedence/advantage, but I am not sure, since it is not mentioned in the documentation.

nhadziosma1 avatar Apr 09 '25 12:04 nhadziosma1

Contributions to make that more explicit are welcome. And yes, local (project) config is overwriting the global settings.

Secrus avatar Apr 09 '25 12:04 Secrus