gh-120057: Add os.reload_environ() function #126268
Conversation
Replace the os.environ.refresh() method with a new os.reload_environ() function.
Doc/library/os.rst
Outdated
| .. function:: reload_environ() | ||
|
|
||
| Update :data:`os.environ` and :data:`os.environb` with changes to the | ||
| environment made by :func:`os.putenv`, by :func:`os.unsetenv`, or made |
There was a problem hiding this comment.
I think that it is better to say "the process environment".
os.putenv and os.unsetenv update the cache, so there is no need to reload after them. You should refer to the C functions.
Please add a note that this function is not thread safe. Calling it while the environment is modified in other thread has undefined behavior. Reading from os.environ or calling os.getenv during reloading can return empty result.
There was a problem hiding this comment.
If the process environment is mentioned, perhaps it can be specifically mentioned that it is the current process environment (I think)
Edit
Or, it can be called the current program.
There was a problem hiding this comment.
os.putenv() and os.unsetenv() don't update os.environ: see test_reload_environ().
|
@serhiy-storchaka: Please review the updated PR. I addressed your review. |
Co-authored-by: Bénédikt Tran <[email protected]>
|
@picnixz: I applied your suggestions. |
There was a problem hiding this comment.
LGTM! (although see @AA-Turner's suggested docs wording tweaks)
Co-authored-by: Adam Turner <[email protected]>
Co-authored-by: Bénédikt Tran <[email protected]>
|
Merged, thanks for reviews! |
Replace the os.environ.refresh() method with a new os.reload_environ() function.
📚 Documentation preview 📚: https://cpython-previews--126268.org.readthedocs.build/