feat: add with_env param in dotenv_values

Author: ramwin

src/dotenv/main.py

@@ -347,6 +347,7 @@ def dotenv_values(
     verbose: bool = False,
     interpolate: bool = True,
     encoding: Optional[str] = "utf-8",
+    with_env: bool = False,
 ) -> Dict[str, Optional[str]]:
     """
     Parse a .env file and return its content as a dict.
@@ -362,18 +363,26 @@ def dotenv_values(
     - `verbose`: whether to output a warning if the .env file is missing. Defaults to
       `False`.
     - `encoding`: encoding to be used to read the file. Defaults to `"utf-8"`.
+    - `with_env`: include the os.environ() to response.
 
     If both `dotenv_path` and `stream` are `None`, `find_dotenv()` is used to find the
     .env file.
     """
     if dotenv_path is None and stream is None:
         dotenv_path = find_dotenv()
 
-    return DotEnv(
+    result = DotEnv(
         dotenv_path=dotenv_path,
         stream=stream,
         verbose=verbose,
         interpolate=interpolate,
         override=True,
         encoding=encoding,
     ).dict()
+    if with_env:
+        return dict(
+            **os.environ,
+            **result,
+        )
+    else:
+        return result

tests/test_main.py

@@ -415,3 +415,9 @@ def test_dotenv_values_file_stream(dotenv_file):
         result = dotenv.dotenv_values(stream=f)
 
     assert result == {"a": "b"}
+
+
+def test_dotenv_values_with_os_environment():
+    if os.environ.get("USER"):
+        assert "USER" not in dotenv.dotenv_values(with_env=False)
+        assert "USER" in dotenv.dotenv_values(with_env=True)