python-dotenv breaking changes

1.2.2

9 breaking changes, first published March 1, 2026.

• Behavior changed dotenv run
  The dotenv run command now passes flags straight through to the specified command, so flag handling by dotenv run may differ from before. github.com
• Behavior changed dotenv.set_key
  dotenv.set_key used to follow symlinks in some situations and no longer does. To restore the old behavior in all cases, pass follow_symlinks=True. github.com
• Behavior changed dotenv.unset_key
  dotenv.unset_key used to follow symlinks in some situations and no longer does. To restore the old behavior in all cases, pass follow_symlinks=True. github.com
• Behavior changed set
  The CLI set command used to follow symlinks in some situations and no longer does. github.com
• Behavior changed unset
  The CLI unset command used to follow symlinks in some situations and no longer does. github.com
• Signature changed dotenv.cli.run
  Was def run(ctx: click.Context, override: bool, commandline: List[str]) -> None; now def run(ctx: click.Context, override: bool, commandline: tuple[str, ...]) -> None. pypi.org
• Signature changed dotenv.main.rewrite
  Was def rewrite(path: StrPath, encoding: Optional[str]) -> Iterator[Tuple[IO[str], IO[str]]]; now def rewrite(path: StrPath, encoding: Optional[str], follow_symlinks: bool = False) -> Iterator[Tuple[IO[str], IO[str]]]. pypi.org
• Signature changed dotenv.set_key
  Was def set_key(dotenv_path: StrPath, key_to_set: str, value_to_set: str, quote_mode: str = 'always', export: bool = False, encoding: Optional[str] = 'utf-8') -> Tuple[Optional[bool], str, str]; now def set_key(dotenv_path: StrPath... pypi.org
• Signature changed dotenv.unset_key
  Was def unset_key(dotenv_path: StrPath, key_to_unset: str, quote_mode: str = 'always', encoding: Optional[str] = 'utf-8') -> Tuple[Optional[bool], str]; now def unset_key(dotenv_path: StrPath, key_to_unset: str, quote_mode: str = 'always'... pypi.org

1.2.0

2 breaking changes, first published October 26, 2025.

• Removed dotenv.cli.list
  dotenv.cli.list was removed in python-dotenv 1.2.0 pypi.org
• Renamed dotenv.cli.set
  Use dotenv.cli.set_value instead. pypi.org

1.1.0

3 breaking changes, first published March 25, 2025.

• Removed
  Python 3.8 is no longer supported in this release, so code running on Python 3.8 should move to a newer Python version. github.com
• Signature changed dotenv.cli.enumerate_env
  Was def enumerate_env(); now def enumerate_env() -> Optional[str]. pypi.org
• Signature changed dotenv.cli.run_command
  Was def run_command(command: List[str], env: Dict[str, str]) -> int; now def run_command(command: List[str], env: Dict[str, str]) -> None. pypi.org

Check your code

These are the changes. To see which of them reach your code, scan a public repository, or have your coding agent call check_code with your manifest or lockfile over MCP. The API reads every change in every version, not only the newest. On Team and up, a fix pull request opens for the changes that reach a connected repository. Nothing merges or deploys.