●Change8

Migrating to python-dotenv v1.1.0

Version v1.1.0 introduces 1 breaking change. This guide details how to update your code.

Released: 3/25/2025

1
Breaking Changes
3
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

dotenv.run_is_debuggerload_dotenv

Breaking Changes

●Issue #1

Support for Python 3.8 has been dropped. Projects still running on Python 3.8 must upgrade to Python 3.9 or later before upgrading python-dotenv.

Migration Steps

  1. 1
    Upgrade your runtime to Python 3.9 or newer (Python 3.8 is no longer supported).
  2. 2
    Re‑run your test suite under the new Python version to catch any compatibility issues.
  3. 3
    If you rely on load_dotenv inside a debugger, no action needed – the new _is_debugger helper is added automatically.

Release Summary

python-dotenv 1.1.0 adds Python 3.13 support, drops Python 3.8, introduces execvpe in dotenv run, and includes several CI and documentation improvements.

Need More Details?

View the full release notes and all changes for python-dotenv v1.1.0.

View Full Changelog