Uninstall instructions unclear

Issue info

Poetry version: 1.0.5 OS: Ubuntu 18.04.1 LTS Shell: zsh

Problem

I’m trying to uninstall poetry.

I think when I ran the curl command I piped it into the default python instead of python3.7. When I run any command, I get a RuntimeWarning of the form:

/home/derekyu/.poetry/lib/poetry/_vendor/py2.7/subprocess32.py:149: 
RuntimeWarning: The _posixsubprocess module is not being used. 
Child process reliability may suffer if your program uses threads.
  "program uses threads.", RuntimeWarning)

This error suggests that I’m calling it from python 2.7 instead of 3.7, which is ideally what I would like to be using.

Methods used to attempt resolution of problem

The instructions suggest using the --uninstall option. Running that gives me:

➜  ~ poetry --uninstall
[NoSuchOptionException]
The "--uninstall" option does not exist.

along with the associated stack trace. Running it without the options -- gave me:

➜  ~ poetry uninstall
The command "uninstall" is not defined.

Did you mean this?
    install

I can’t seem to find the get-poetry.py that is being continually referenced in the docs. If it helps, I ran find / get-poetry.py and didn’t get anything. Should it be included in ~/.poetry/ ?

The docs say:

If you decide Poetry isn’t your thing, you can completely remove it from your system by running the installer again with the --uninstall option or by setting the POETRY_UNINSTALL environment variable before executing the installer.

I poked around in ~/.poetry/lib but without calling it from ~/.poetry/bin I get reference errors, which make sense.

My resolution

curl https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py > get-poetry
➜  ~ python get-poetry.py --uninstall
# We are sorry to see you go!

This will uninstall Poetry.

It will remove the `poetry` command from Poetry's bin directory, located at:

$HOME/.poetry/bin

This will also remove Poetry from your system's PATH.

()
Are you sure you want to uninstall Poetry? (y/[n]) y

Points that may require clarification

1. is the RuntimeWarning due to the default installer using python 2.7?
2. how come there isn’t a poetry uninstall option?
3. Should the docs be amended to suggest that you use python3.7 when curling the installer.
4. Should the installer be installed into ~/.poetry/lib/ for ease of use?

[jaepil-choi]

This should be on the official uninstallation instruction.

[finswimmer]

Hello @DerekYu177 ,

is the RuntimeWarning due to the default installer using python 2.7? That’s a problem with vendoring the subprocess package for python2. See https://github.com/python-poetry/poetry/issues/2106

how come there isn’t a poetry uninstall option? AFAIK there was some work to have such a command. But it was somehow tricky to get work on windows.

You are right that the docs can be improved about how to uninstall poetry:

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

Should the docs be amended to suggest that you use python3.7 when curling the installer.

It doesn’t matter with which python poetry was installed. Once it is installed it requires to find python in the path. This might change in the future:

• https://github.com/python-poetry/poetry/pull/1042
• https://github.com/python-poetry/poetry/pull/1878

Should the installer be installed into ~/.poetry/lib/ for ease of use?

That’s on you if and where you want to place the installer. 😃 poetry just provides the scripts and gives a suggestion on how to optain and start it.

fin swimmer