python-poetry / poetry

Python packaging and dependency management made easy
https://python-poetry.org
MIT License
31.89k stars 2.28k forks source link

Installation Steps for Windows #9873

Closed kevinrawal closed 1 day ago

kevinrawal commented 1 week ago

Issue Kind

Missing documentation

Existing Link

https://python-poetry.org/docs/#installing-manually

Description

In this section, the manual installation steps for Poetry are provided. However, users unfamiliar with macOS might find it confusing because, for Windows, the command should be Scripts\pip install -U pip setuptools instead of /bin/pip install -U pip setuptools. To improve clarity, we should update the instructions to explicitly include steps for Windows users.

kevinrawal commented 1 week ago

I want to work on this if it makes sense.

swills1 commented 2 days ago

The documentation states the instructions are for Unix only, "As this is an advanced installation method, these instructions are Unix-only..."

The complete Windows equivalent would be;

# Step 1: Create a virtual environment
python -m venv %VENV_PATH%

# Step 2: Upgrade pip and setuptools
%VENV_PATH%\Scripts\pip install -U pip setuptools

# Step 3: Install poetry
%VENV_PATH%\Scripts\pip install poetry

In order to match the linked docs formatting;

python -m venv %VENV_PATH%
%VENV_PATH%\Scripts\pip install -U pip setuptools
%VENV_PATH%\Scripts\pip install poetry