Dependency aliasing

[blaggacao]

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

Feature Request

• Packages provide API namespaces
• API namepsaces are mostly identified by the package name
• A package name mostly resolves to a package source
• Yet, there are valid exceptions to both norms:
  • A package should resolve to an alternate (local) source for dev (eg. python-poetry/semver dev branch to python-poetry/poetry dev branch)
  • A package namespace can be provided in different flavors by different packages (e.g. psycopg2 & psycopg2-binary)

Therefore, add [tool.poetry.dev-alternates] with exactly the same syntax as [tool.poetry.dependencies] yet with an optional aliases field on the dep object, to inform which production package's namespace is provided through this package during dev. If aliases is not specified, it shall be inferred by the dep name itself.

Example covering both cases:

[tool.poetry.dependencies]
python = "^3.7"
dodoo = "^2.0"
psycopg2 = "^2.8"

[tool.poetry.dev-alternates]
psycopg2-binary = {aliases = psycopg2, version = "^2.8"}
dodoo = {path = "../dodoo"}

Further considerations

toml file API

• It could be considered to make this a sub-path of [tool.poetry.dev-dependencies], however I consider, flat rymes are part of poetry's rythm, so stick with the groove.
• Making this a feature of [tool.poetry.dev-dependencies] itself might probably not be verbose / descriptive enough and decrease clarity and readability

Merge strategy

I should be precise in that, it shall be expected to do a true merge of the objects, so -- strictly -- psycopg2-binary = {aliases = psycopg2, version = "^2.8"} could be written as just psycopg2-binary = {aliases = psycopg2}

CLI UX

From a UX perspectve, maybe the install --develop=DEVELOP has almost a 90% overlap in semantics with the requested feature. It would be an acceptable modification to current behaviour, if:

• install --develop=DEVELOP always uses the alternate dev dep -- if specified -- in addition to install said dep in development mode

---

This FR collects a few FR in the issue catalogue, please reference them as you see fit.

[blaggacao]

Collects (at least):

• 483

• 1264

[rdozier-work]

+1 on this, not sure why it hasn't been implemented yet

[skewty]

The psycopg2 example is indirectly solved / closed. This issue affects many other packages.

Here is another:

pip install nats-py

import nats
nc = await nats.connect("tls://demo.nats.io:4443")

[tool.poetry.dependencies]
nats-py = { version = "~2.8.0" }

https://github.com/nats-io/nats.py https://pypi.org/project/nats-py/

[clintonroy]

Please see the recent discussion around package variants on the python channels, once such an option is available in the wider eco system, poetry will be able to support it.