Adjust Python 2.7 EOL message

[cjerdonek]

I'm inclined to add an option and suggest in the message how to suppress the message itself, using pip config.

@pradyunsg Is it okay to discuss this in a separate issue / PR so this can be merged?

Originally posted by @cjerdonek in #6208 (comment)

[defjaf]

So, how do we suppress the 2.7 deprecation message with pip config?

[cjerdonek]

@pradyunsg I think this should go in the next release in some form — unless you’re planning another patch release not long after. My concern is that if the message is too annoying without an easy way to suppress, it could dissuade people from using this version of pip. I admit though I haven’t checked to see in what circumstances (e.g. which commands) the message currently displays.

@defjaf I’m pretty sure there’s not currently a way to do it with pip config, which is why he said “add an option” in the original comment above.

[pradyunsg]

I admit though I haven’t checked to see in what circumstances (e.g. which commands) the message currently displays.

All invocations on Python 2.7.

I think this should go in the next release in some form — unless you’re planning another patch release not long after.

I am not warm to the idea of making a 19.0 series release, post 19.0.2.

If someone is willing to write a PR to suppress python-version related deprecation warnings in pip, I'm OK to get them in the next release but I won't block 19.0.2 on it. If it misses that window, this would have to wait till 19.1, which will be in April.

[xavfernandez]

#6126 might provide this

[nigels-com]

Some context from the coal face:

I have some C/C++ code using Conan to build with dependencies on various libraries.
I had a hard time making Conan happy on Raspberry Pi due to ARM and limited memory.
Having pip warn me about "end of days" and giving me no practical reason to wrangle Python 3 onto the device is not useful or valuable in this context.
Especially the 27th time than Conan failed to build something.

Overall the experience decreased my confidence in both Conan and Python/Pip suitability for the task.
It works on Linux. It works on Mac. But will it work in 2020? Maybe the font will be red and language will be scarier sounding? What is the point of that?

In other words: I suggest to simply remove the message. It's simply not actionable from my point of view, Python 2.7 will continue to need pip, regardless of 2020.

[cjerdonek]

Additional discussion on this issue occurred here: https://discuss.python.org/t/pip-19-0-is-now-available/757

[pradyunsg]

@nigels-com I've modified your message to have a slightly milder tone, to avoid it contributing to potentially burning out contributors and other maintainers of pip.

If you don't find that edit appropriate, please free free to ping me anywhere other than on this issue (like my username @gmail.com or on twitter by the same username or in a new issue on this repo).

[nigels-com]

@pradyunsg I'm supportive of your effort to keep things mild. We in 2.7 land just want to get on with things without undue or unintended friction.

[pradyunsg]

Personally, I think anyone who wants to help "get this fixed" is welcome to help us take #6126 forward, which is a long term fix for this issue and related issues.

That would provide a mechanism to users who don't care about certain kinds of messages to silence them while allowing the maintainers to provide useful hints to users who might not know as much.

If you care about silencing the Python 2.7 depreciation message, you should also be willing to set certain configuration options to disable such messages. #6126 is the mechanism to suppress such messages.

So, no, I'm personally not amicable to removing this message. I am amicable to providing a decent mechanism to hide this error message and genuinely prefer a general mechanism for filtering messages from within pip.

[pradyunsg]

Thanks!

We in 2.7 land just want to get on with things without undue or unintended friction.

I understand and empathize. I don't disagree with your requirement -- we should provide you a mechanism to silence that message. I don't think removing it for everyone is the right way to do it. :)

[pradyunsg]

FWIW, you can suppress that message today with an environment variable:

PYTHONWARNINGS=ignore:Please.upgrade::pip._internal.cli.base_command

(From #6147)

PYTHONWARNINGS=ignore:DEPRECATION::pip._internal.cli.base_command

[nigels-com]

An opt-out policy is a step in the right direction. Appreciated.

[pradyunsg]

I think we can break this issue into 2 smaller issues, each of which can be worked on independently:

• adding --no-warn-python-version, like Warn user when installing scripts outside PATH #4553 added --no-warn-script-location I don't want to block this on WIP - Proof of concept of selective log silencing #6126.
• updating the error message (to be a link to pip’s documentation, which contains a message like here).

These would both be good first issues for first time contributors. If no one voices any concerns, I'm going to do this and close this issue sometime in the next 24 hours.

self-notes, in case we break it up

hello there, if you're reading this, please let me know if there are any improvements I can make to the issue descriptions below.

---

There is a feature request to be able to silence Python version related warnings that pip emits (try running pip 19 on Python 2.7 to see what that means).

The way we want to handle this request is to add a new flag/command line option, similar to --no-warn-script-location to pip, in pip._internal.cli.cmdoptions.general_group (as named in code) and using that within pip's BaseCommand class for putting the version-based checking under a conditional.

Additional references:

• See Warn user when installing scripts outside PATH #4553 for how --no-warn-script-locations is implemented.

• where general options are defined

  pip/src/pip/_internal/cli/cmdoptions.py

  Line 775 in 293c91e

  general_group = {

• where general options get added

  pip/src/pip/_internal/cli/base_command.py

  Line 78 in 293c91e

  self.parser.add_option_group(gen_opts)

• where to add conditional

  pip/src/pip/_internal/cli/base_command.py

  Line 139 in 293c91e

  if sys.version_info[:2] == (3, 4):

This is a moderately complex issue that can serve as starting point for anyone who wants to help out with pip's development -- the process of fixing this should be a good introduction to pip's development workflow.

---

The error message that pip prints when run on Python 2.7 is not very informative about what timeline pip would use before dropping support or how it might approach it.

[drvink]

Click to see rant (hidden by maintainers)

I can't wait to still be dealing with The Python Every Non-Trivial Software System Having Made The Mistake Uses vs. The Python They Want You To Use in 2030 (as if ANSI-decorated messages will have had any effect to the contrary).

Anyway, there is a cleaner alternative to setting the PYTHONWARNINGS environment variable in order to silence this, as long as user site customization has not been disabled:

import os, site
if site.ENABLE_USER_SITE: os.path.join(site.getusersitepackages(), 'usercustomize.py')
# -> '/home/mdl/.local/lib/python2.7/site-packages/usercustomize.py'

Hooray. Now squirt this into that file:

try:
    import warnings
    warnings.filterwarnings('ignore', 'DEPRECATION',
                            module='pip._internal.cli.base_command')
except ImportError: pass

Ride the snake.

references: #6147, #6207, #6208, #6231

[pradyunsg]

next 24 hours.

lol me.

Closing this in favor of #6673 and #6674.