get/install-poetry.py - confusing installation instructions

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

Issue

User trying to install poetry using current documentation might have following experience:

Installation contains infobox:

The get-poetry.py script described here will be replaced in Poetry 1.2 by install-poetry.py. From Poetry 1.1.7 onwards, you can already use this script as described here.

Following osx / linux / bashonwindows install instructions show only url to download an run get-poetry.py

Running get-poetry.py prints “this installation script is obsolete”.

Beside that, with poetry 1.1.1 I had an issue with “ModuleCannotBeFound” for cleo module.

Proposal - add or change the link to install-poetry.py

Taking into account, that even obsolete get-poetry.py script installs the version higher than 1.1.7, it would be better to change the instruction to use install-poetry.py instead.

Change it to:

curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py | python -

It saves the “obsolete” message and to me it worked better.

[vlcinsky]

@finswimmer go to https://python-poetry.org/docs/ which shows doc for poetry version 1.1 (not for “master”).

There is “install-poetry.py” mention in the infobox, but there is no url on this text and the curl instruction reads:

curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python -

On “master” version the instruction is correct but taking into account that default page goes to version “1.1”, things are confusing.

[finswimmer]

While it’s good practice to use the most current software version, nothing in the current docs suggests that using the old version (get-poetry.py) is incorrect.

In general there’s nothing wrong with using get-poetry.py. It’s just deprecated, which means “be aware that this will be replaced by another way of doing it soon”. The problems with python 3.10 in windows are due to the missing _vendor folder in the release (see https://github.com/python-poetry/poetry/issues/4846#issuecomment-988806589). This was not intended and will be fixed by a new release.