v1.2.3

Fixed

• Strip a leading UTF-8 BOM from .env file contents so the first variable is no longer silently lost when the file is saved with BOM (e.g. by some JetBrains IDEs on Windows) by [@h1whelan] in [#640]
• set_key now escapes backslashes, so values containing them (Windows paths, regular expressions) survive a write/read round-trip. Quoted values ending in an escaped backslash are no longer mis-parsed as an escaped quote, which used to swallow the following lines by [@dchaudhari7177] in [#680]
• dotenv run now prints a friendly error instead of a traceback when no command is given by [@bbc2] in [#606]
• Cache the parsed result for empty .env files so repeated dotenv_values/load_dotenv calls no longer re-read the file by [@ReinerBRO] in [#638]

v1.2.2

Added

• Support for Python 3.14, including the free-threaded (3.14t) build. (#)

Changed

• The dotenv run command now forwards flags directly to the specified command by @bbc2 in #607
• Improved documentation clarity regarding override behavior and the reference page.
• Updated PyPy support to version 3.11.
• Documentation for FIFO file support.
• Support for Python 3.9.

Fixed

• Improved set_key and unset_key behavior when interacting with symlinks by @bbc2 in #790c5
• Corrected the license specifier and added missing Python 3.14 classifiers in package metadata by @JYOuyang in #590

Breaking Changes

• dotenv.set_key and dotenv.unset_key used to follow symlinks in some
  situations. This is no longer the case. For that behavior to be restored in
  all cases, follow_symlinks=True should be used.

• In the CLI, set and unset used to follow symlinks in some situations. This
  is no longer the case.

• dotenv.set_key, dotenv.unset_key and the CLI commands set and unset
  used to reset the file mode of the modified .env file to 0o600 in some
  situations. This is no longer the case: The original mode of the file is now
  preserved. Is the file needed to be created or wasn't a regular file, mode
  0o600 is used.

Misc

• skip 000 permission tests for root user by @burnout-projects in #561
• Bump actions/checkout from 5 to 6 in the github-actions group by @dependabot[bot] in #593
• Add Windows testing to CI by @bbc2 in #604
• Improve workflow efficiency with best practices by @theskumar in #609
• Remove the use of sh in tests by @bbc2 in #612

New Contributors

• @JYOuyang made their first contribution in #590
• @burnout-projects made their first contribution in #561
• @cpackham-atlnz made their first contribution in #597

Full Changelog: v1.2.1...v1.2.2

v1.2.1

What's Changed

• Support reading .env from FIFOs (Unix) by @sidharth-sudhir in #586
• Update CI to use trusted publishing on PyPI

New Contributors

• @sidharth-sudhir made their first contribution in #586

Full Changelog: v1.2.0...v1.2.1

v1.2.0

What's Changed

• style: upgrade to use ruff by @theskumar in #567
• Use sys.exit() instead of exit() by @theskumar in #568
• feat: add PYTHON_DOTENV_DISABLED flag to disable load_dotenv (fixes #510) by @matthewfranglen in #569
• Added Python@3.14: Github CI & tox.ini by @23f3001135 in #579
• ocs: clarify what load_dotenv() does in README by @cybercoded in #575
• Bump the github-actions group across 1 directory with 2 updates by @dependabot[bot] in #577
• Move project metadata and config to pyproject.toml by @EpicWink in #583

New Contributors

• @matthewfranglen made their first contribution in #569
• @23f3001135 made their first contribution in #579
• @cybercoded made their first contribution in #575
• @EpicWink made their first contribution in #583

Full Changelog: v1.1.1...v1.2.0

v1.1.1

What's Changed

• fix: ensure find_dotenv work reliably on python 3.13 by @theskumar in #563
• fix(cli): issue with execvpe on Windows by @wrongontheinternet in #566

New Contributors

• @wrongontheinternet made their first contribution in #566

Full Changelog: v1.1.0...v1.1.1

v1.1.0

What's Changed

• Add a security policy by @bbc2 in #512
• Keep GitHub Actions up to date with GitHub's Dependabot by @cclauss in #506
• ci: fix multiline string in test.yml & use fail-fast strategy by @cclauss in #514
• Enhance dotenv run: Switch to execvpe for better resource management and signal handling by @eekstunt in #523
• ci: add py3.13 to test.yml by @waketzheng in #527
• Add Python 3.13 trove classifier by @edgarrmondragon in #535
• Bump the github-actions group with 2 updates by @dependabot in #529
• Add support for python 3.13 and drop 3.8 by @theskumar in #551
• docs: Update README.md by @chapeupreto in #516
• Some more s/Python-dotenv/python-dotenv/ by @theskumar in #552
• add _is_debugger so load_dotenv will work in pdb by @randomseed42 in #553

New Contributors

• @eekstunt made their first contribution in #523
• @waketzheng made their first contribution in #527
• @edgarrmondragon made their first contribution in #535
• @dependabot made their first contribution in #529
• @chapeupreto made their first contribution in #516
• @randomseed42 made their first contribution in #553

Full Changelog: v1.0.1...v1.1.0

v1.0.1

What's Changed

• FIx year in release date in changelog.md by @jankislinger in #453
• Gracefully handle code which has been imported from a zipfile by @samwyma in #456
• Use pathlib.Path in tests by @eumiro in #466
• fixes #473 Use https in README links by @Nicals in #474
• Allow modules using load_dotenv to be reloaded when launched in a separate thread by @freddyaboulton in #497
• Fix error handling in the rewrite function by @Qwerty-133 in #468
• Add python 3.12 and pypy3.10 to test suite by @theskumar in #498

New Contributors

• @jankislinger made their first contribution in #453
• @samwyma made their first contribution in #456
• @eumiro made their first contribution in #466
• @Nicals made their first contribution in #474
• @freddyaboulton made their first contribution in #497
• @Qwerty-133 made their first contribution in #468

Full Changelog: v1.0.0...v1.0.1

Version 1.0.0

What's Changed

• Handle situations where the cwd does not exist. by @jctanner in #446
• Add python-decouple as a related project by @kcarnold in #451
• Drop support for python 3.7, add python 3.12-dev by @theskumar in #449

New Contributors

• @jctanner made their first contribution in #446
• @kcarnold made their first contribution in #451

Full Changelog: v0.21.1...v1.0.0

Version 0.21.1

Added

• Use Python 3.11 non-beta in CI (#438 by @bbc2)
• Modernize variables code (#434 by @Nougat-Waffle)
• Modernize main.py and parser.py code (#435 by @Nougat-Waffle)
• Improve conciseness of cli.py and init.py (#439 by @Nougat-Waffle)
• Improve error message for get and list commands when env file can't be opened (#441 by @bbc2)
• Updated Licence to align with BSD OSI template (#433 by @lsmith77)

Fixed

• Fix Out-of-scope error when "dest" variable is undefined (#413 by @theGOTOguy)
• Fix IPython test warning about deprecated magic (#440 by @bbc2)
• Fix type hint for dotenv_path var, add StrPath alias (#432 by @eaf)

New Contributors

• @saimehsan made their first contribution in #426
• @Praveensenpai made their first contribution in #437
• @Nougat-Waffle made their first contribution in #434
• @mivade made their first contribution in #442
• @lsmith77 made their first contribution in #433
• @eaftan made their first contribution in #432

Full Changelog: v0.21.0...v0.21.1

Version 0.21.0

What's Changed

Added

• CLI: add support for invocations via 'python -m'. (#395 by @theskumar)
• load_dotenv function now returns False. (#388 by @larsks)
• CLI: add --format= option to list command. (#407 by @sammck)

Fixed

• Drop Python 3.5 and 3.6 and upgrade GA (#393 by @eggplants)
• Use open instead of io.open. (#389 by @rabinadk1)
• Improve documentation for variables without a value (#390 by @bbc2)
• Add parse_it to Related Projects by (#410 by @naorlivne)
• Update README.md by (#415 by @harveer07)
• Improve documentation with direct use of MkDocs by (#398 by @bbc2)

New Contributors

• @rabinadk1 made their first contribution in #389
• @larsks made their first contribution in #388
• @naorlivne made their first contribution in #410
• @eggplants made their first contribution in #393
• @sammck made their first contribution in #407
• @harveer07 made their first contribution in #415
• @theGOTOguy made their first contribution in #414

Full Changelog: v0.20.0...v0.21.0