v6.3.0 introduced pkg_resources side effects

Bắt đầu với commit 470145ca7d103bdf6081bcfde09933ab81a56a5b và lần theo quá trình import qua debugpy.server.api đến debugpy/_vendored/pydevd/pydevd_plugins/init.py. Chạy notebook tái hiện sự cố được liên kết với ipykernel<6.3.0, ipykernel==6.3.0 và head hiện tại, đồng thời theo dõi sys.path và pkg_resources. Công việc được coi là hoàn tất khi trình tái hiện không còn thất bại nếu không có workaround dành riêng cho notebook và mọi ảnh hưởng đến hoạt động debug của pydevd đã được hiểu rõ.

ipykernel v6.3.0, I believe 470145ca7d103bdf6081bcfde09933ab81a56a5b specifically, introduced an indirect import on the pkg_resources module, via debugpy.server.api.

During this import, debugpy imports pkg_resources (here).

The pkg_resources module has some import-time side-effects that cause problems in complex notebooks:

It’s important to note that the global working_set object is initialized from sys.path when pkg_resources is first imported, but is only updated if you do all future sys.path manipulation via pkg_resources APIs.

I am filing this with ipykernel because I believe it's the place we start caring about the sys.path manipulations - it is somewhat common for notebooks to include !pip install foo steps, which impacts sys.path without using the pkg_resources APIs. However, I'd like to discuss where a fix should live.

I'm part of the TensorFlow docs team, and we have an increasing number of notebooks that have a "restart runtime" requirement (e.g.). I don't think fixing every notebook is the right solution, and we could apply a fix in our own infrastructure, but I would favour a fix at the root, if possible.

When we fix it in the notebook, we reload the module (e.g.), however we should unload the module completely if we fix this before any notebook code, in case the notebook uses pkg_resources. If we were to do this, say, in ipykernel, would it impact the notebook kernel or other environment factors? e.g. in the use of pydevd or debugging?

In case it helps, this notebook can be used to reproduce the failure. ipykernel<6.3.0 works, but ipykernel==6.3.0 (and at head) fail.