repositories: deprecate default option and introduce possibility to disable PyPI explicitly

[radoering]

Related-to: #6713

• Added tests for changed code.
• Updated documentation for changed code.

Motivation

While reviewing #6879, I figured out that there is a huge inconsistence between the implementation and the documentation of the default source (originally posted in #6879 (review)):

implementation	documentation
If there is no explicit default, PyPI is only the default if there is no primary, otherwise it's secondary. default is the highest priority. In other words, implicit PyPI always comes after primary but is not always the default.	It's a bit difficult to find but it says that primary sources take precedence over PyPI and that the default source takes precedence over secondary sources. It does not clearly say but implies that if there is no explicit default, PyPI always is the default. If you combine everything, it seems primary sources should take precedence over the default source (even if it's not PyPI).

In my opinion, the documentation makes more sense, but changing the implementation to match the documentation is a breaking change because it puts the explicit default source from highest priority to lower than all primary sources.

Thinking a bit about the problem, I came to the conclusion that we do not really need to explicitly specify a default source if we had another option to disable PyPI. Currently, specifying a default source has two effects:

1. It disables PyPI.
2. It defines the source with the highest priority.

The second effect is not really required because you can achieve the same result by making the source the first one in pyroject.toml.

The first effect is kind of implicit and from an UI perspective probably shouldn't be coupled to a specific repository. That's why I think we should deprecate configuring sources as default and introduce an option to disable PyPI.

Implementation details

• Deprecate default=true for sources
• Introduce new command poetry source default:
  • Options: --enable-pypi, --disable-pypi
  • When executed without an option it shows the current state (enabled/disabled).

pyproject.toml:

[tool.poetry]
...
default-source-pypi = false

[github-actions]

Deploy preview for website ready!

✅ Preview
https://website-6cbx58ltz-python-poetry.vercel.app

Built with commit 3e91102.
This pull request is being automatically deployed with vercel-action

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.