Docu example on "editable project in current directory" seems not to work/is unclear/suggests failing behaviour #4733
Labels
auto-locked
Outdated issues that have been locked by automation
good first issue
A good item for first time contributors to work on
type: docs
Documentation related
Description:
The documentation's (reference/pip_install.rst) example 6 says it would be possible to install a local package at a specific version,
$ pip install -e .[PDF]==3.0 # editable project in current directory
At least for the case of setuputils extras and the editable mode. Since the version
3.0
should reference to the package's version (here.
's version) it suggests that one could install local packages with a specific version like$ pip install -e .[]==3.0
which is not the case.What I've run:
throws an exception:
So does
and the cases without quotes and with
--upgrade
In contrast to that running without
-e
does throw an exception with a tracebackPossible solution:
Since the IRC #pypa said it was not possible to install/downgrade a local package to a specific version, I think the documentation should be fixed by deleting line 803 of
docs/reference/pip_install.rst
or adjusting it to not suggest that it was possible to install with
.[]==version
. Or add this functionality, so one does not need to roll back to the version one wants and then install (git checkout v0.0.5 && pip install --upgrade .
) or use the repository@
-syntax (pip install --upgrade "git+file:///home/username/package/[email protected]#egg=package"
)The text was updated successfully, but these errors were encountered: