Skip to content

Suggest using the py launcher when installing Poetry globally on Windows #5611

@johnthagen

Description

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

Issue

I am starting to use Poetry and would like to try to improve some rough edges I have hit before recommending it to novice users.

On Windows, the official installation instructions state:

(Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py -UseBasicParsing).Content | python -

And similar for the master branch:

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -

The problem is that the most common way to install/invoke Python on Windows for launching is through the py launcher. Adding python to the PATH is a box that is unchecked by default. This means from an average user on Windows their first experience with trying to install Poetry the recommended way will be failure.

I recommend that the default instructions | py - or at the very least mention that you might have to do this prominently.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/docsDocumentation issues/improvements

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions