Embedded interpreters: No way to extend `sys.path`

Feature or enhancement

Proposal:

Setting up an embedded Python interpreter often involves augmenting sys.path with some application-specific subdirectories, so as not to pollute the system's normal Python installation.

Unfortunately, PyConfig only affords either replacing the default path wholesale, or leaving it as-is (via module_search_paths_set). There appears to be no way to augment sys.path with application-specific directories and no documented way to retrieve the default contents of sys.path.

A workable solution might be to enhance cfg.module_search_paths_set so that when it's set to 2 or 3, the application's paths shall be prepended / appended to sys.path instead of replacing it.

Has this already been discussed elsewhere?

I have already discussed this feature proposal on Discourse

Links to previous discussion of this feature:

https://discuss.python.org/t/embedding-how-do-i-extend-sys-path/75734

Bắt đầu với tài liệu PyConfig và hành vi của module_search_paths_set được mô tả trong issue, sau đó đọc cuộc thảo luận Discourse được liên kết để nắm bối cảnh thiết kế trước đây. Xác định cách kết hợp các đường dẫn dành riêng cho ứng dụng với sys.path mặc định và hành vi API được ghi trong tài liệu nên như thế nào; việc hoàn thành cần bao gồm một bản triển khai đã được thống nhất cùng tài liệu hoặc các bài kiểm thử tương ứng.