ae-base 0.3.36__tar.gz → 0.3.37__tar.gz

{ae_base-0.3.36 → ae_base-0.3.37}/LICENSE.md

@@ -1,4 +1,4 @@
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_project V0.3.29 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_project V0.3.30 -->
 ### GNU GENERAL PUBLIC LICENSE
 
 Version 3, 29 June 2007

{ae_base-0.3.36/ae_base.egg-info → ae_base-0.3.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ae_base
-Version: 0.3.36
+Version: 0.3.37
 Summary: ae namespace module portion base: basic constants, helper functions and context manager
 Home-page: https://gitlab.com/ae-group/ae_base
 Author: AndiEcker
@@ -51,19 +51,19 @@ Requires-Dist: types-setuptools; extra == "tests"
 Requires-Dist: wheel; extra == "tests"
 Requires-Dist: twine; extra == "tests"
 
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.92 -->
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.13 -->
-# base 0.3.36
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.94 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.14 -->
+# base 0.3.37
 
 [![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_base/develop?logo=python)](
     https://gitlab.com/ae-group/ae_base)
 [![LatestPyPIrelease](
-    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.35?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.35)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.36?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.36)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 
->ae_base module 0.3.36.
+>ae_base module 0.3.37.
 
 [![Coverage](https://ae-group.gitlab.io/ae_base/coverage.svg)](
     https://ae-group.gitlab.io/ae_base/coverage/index.html)

{ae_base-0.3.36 → ae_base-0.3.37}/README.md

@@ -1,16 +1,16 @@
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.92 -->
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.13 -->
-# base 0.3.36
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.94 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.14 -->
+# base 0.3.37
 
 [![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_base/develop?logo=python)](
     https://gitlab.com/ae-group/ae_base)
 [![LatestPyPIrelease](
-    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.35?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.35)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.36?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.36)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 
->ae_base module 0.3.36.
+>ae_base module 0.3.37.
 
 [![Coverage](https://ae-group.gitlab.io/ae_base/coverage.svg)](
     https://ae-group.gitlab.io/ae_base/coverage/index.html)

{ae_base-0.3.36 → ae_base-0.3.37}/ae/base.py

@@ -69,6 +69,9 @@ use :func:`env_str` to determine the value of an OS environment variable with au
 helper functions provided by this namespace portion to determine the values of the most important system environment
 variables for your application are :func:`sys_env_dict` and :func:`sys_env_text`.
 
+to integrate system environment variables from ``.env`` files into :data:`os.environ` the helper functions
+:func:parse_dotenv`, :func:`load_env_var_defaults` and :func:`load_dotenvs` are provided.
+
 
 android-specific constants and helper functions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -129,20 +132,21 @@ import importlib.abc
 import importlib.util
 import os
 import platform
+import re
 import shutil
 import socket
 import sys
 import unicodedata
+import warnings
 
 from configparser import ConfigParser, ExtendedInterpolation
 from contextlib import contextmanager
 from importlib.machinery import ModuleSpec
 from inspect import getinnerframes, getouterframes, getsourcefile
 from types import ModuleType
-from typing import Any, Callable, Dict, Generator, Iterable, List, Optional, Tuple, Union
-
+from typing import Any, Callable, Dict, Generator, Iterable, List, Optional, Tuple, Union, cast
 
-__version__ = '0.3.36'
+__version__ = '0.3.37'
 
 
 DOCS_FOLDER = 'docs'                            #: project documentation root folder name
@@ -169,6 +173,33 @@ DEF_ENCODING = 'ascii'
 """ encoding for :func:`force_encoding` that will always work independent from destination (console, file sys, ...).
 """
 
+DOTENV_FILE_NAME = '.env'                       #: name of the file containing console/shell environment variables
+_env_line = re.compile(r"""
+    ^
+    (?:export\s+)?      # optional export
+    ([\w.]+)            # key
+    (?:\s*=\s*|:\s+?)   # separator
+    (                   # optional value begin
+        '(?:\'|[^'])*'  #   single quoted value
+        |               #   or
+        "(?:\"|[^"])*"  #   double quoted value
+        |               #   or
+        [^#\n]+         #   unquoted value
+    )?                  # value end
+    (?:\s*\#.*)?        # optional comment
+    $
+    """, re.VERBOSE)
+_env_variable = re.compile(r"""
+    (\\)?               # is it escaped with a backslash?
+    (\$)                # literal $
+    (                   # collect braces with var for sub
+        \{?             #   allow brace wrapping
+        ([A-Z0-9_]+)    #   match the variable
+        }?              #   closing brace
+    )                   # braces end
+    """, re.IGNORECASE | re.VERBOSE)
+
+
 NAME_PARTS_SEP = '_'                            #: name parts separator character, e.g. for :func:`norm_name`
 
 SKIPPED_MODULES = ('ae.base', 'ae.paths', 'ae.dynamicod', 'ae.core', 'ae.console', 'ae.gui_app', 'ae.gui_help',
@@ -248,7 +279,7 @@ def deep_dict_update(data: dict, update: dict):
     """ update the optionally nested data dict in-place with the items and sub-items from the update dict.
 
     :param data:                dict to be updated/extended. non-existing keys of dict-sub-items will be added.
-    :param update:              dict with the [sub-]items to update in the :paramref:`.data` dict.
+    :param update:              dict with the [sub-]items to update in the :paramref:`~deep_dict_update.data` dict.
 
     .. hint:: the module/portion :mod:`ae.deep` is providing more deep update helper functions.
 
@@ -272,7 +303,7 @@ def dummy_function(*_args, **_kwargs):
 
 
 def duplicates(values: Iterable) -> list:
-    """ determine all duplicates in the iterable specified in the :paramref:`.values` argument.
+    """ determine all duplicates in the iterable specified in the :paramref:`~duplicates.values` argument.
 
     inspired by Ritesh Kumars answer to https://stackoverflow.com/questions/9835762.
 
@@ -398,6 +429,42 @@ def in_wd(new_cwd: str) -> Generator[None, None, None]:
         os.chdir(cur_dir)
 
 
+def load_dotenvs():
+    """ detect and load multiple ``.env`` files in/above the current working directory and the calling module folder.
+
+    .. hint:: call from main module of project/app in order to also load ``.env`` files in/above the project folder.
+    """
+    load_env_var_defaults(os.getcwd())
+    load_env_var_defaults(os.path.dirname(stack_var('__file__', depth=2)))
+
+
+def load_env_var_defaults(start_dir: str):
+    """ detect and load chain of ``.env`` files starting in the specified folder or one above.
+
+    :param start_dir:           folder to start search of an ``.env`` file, if not found then checks the parent folder.
+                                if a first ``.env`` file got found, then load their console/shell environment variables
+                                into Python's :data:`os.environ`. after loading the first one, repeat to check for
+                                further ``.env`` files in the parent folder to load them too, until either detecting
+                                a folder without an ``.env`` file or until an ``.env`` got loaded from the root folder.
+
+    .. note::
+        only variables that are not declared in :data:`os.environ` will be added (with the
+        value specified in the ``.env`` file to be loaded).
+    """
+    file_path = os.path.abspath(os.path.join(start_dir, DOTENV_FILE_NAME))
+    if not os.path.isfile(file_path):
+        file_path = os.path.join(os.path.dirname(start_dir), DOTENV_FILE_NAME)
+
+    while os.path.isfile(file_path):
+        for var_nam, var_val in parse_dotenv(file_path).items():
+            if var_nam not in os.environ:
+                os.environ[var_nam] = var_val
+
+        if os.sep not in file_path:
+            break           # pragma: no cover # prevent endless-loop for ``.env`` file in root dir (os.sep == '/')
+        file_path = os.path.join(os.path.dirname(os.path.dirname(file_path)), DOTENV_FILE_NAME)
+
+
 def main_file_paths_parts(portion_name: str) -> Tuple[Tuple[str, ...], ...]:
     """ determine tuple of supported main/version file name path part tuples.
 
@@ -445,7 +512,14 @@ def module_file_path(local_object: Optional[Callable] = None) -> str:
         if file_path:
             return norm_path(file_path)
 
-    return stack_var('__file__', depth=2) or ""   # or use sys._getframe().f_code.co_filename
+    file_path = stack_var('__file__')
+    if not file_path:                                   # pragma: no cover
+        try:
+            # noinspection PyProtectedMember,PyUnresolvedReferences
+            file_path = sys._getframe().f_back.f_code.co_filename   # type: ignore # pylint: disable=protected-access
+        except (AttributeError, Exception):                         # pylint: disable=broad-except # pragma: no cover
+            file_path = ""
+    return file_path
 
 
 def module_name(*skip_modules: str, depth: int = 0) -> Optional[str]:
@@ -531,13 +605,13 @@ def norm_path(path: str, make_absolute: bool = True, remove_base_path: str = "",
 
 
 def now_str(sep: str = "") -> str:
-    """ return the current timestamp as string (to use as suffix for file and variable/attribute names).
+    """ return the current UTC timestamp as string (to use as suffix for file and variable/attribute names).
 
     :param sep:                 optional prefix and separator character (separating date from time and in time part
                                 the seconds from the microseconds).
-    :return:                    timestamp as string (length=20 + 3 * len(sep)).
+    :return:                    UTC timestamp as string (length=20 + 3 * len(sep)).
     """
-    return datetime.datetime.now().strftime("{sep}%Y%m%d{sep}%H%M%S{sep}%f".format(sep=sep))
+    return datetime.datetime.utcnow().strftime("{sep}%Y%m%d{sep}%H%M%S{sep}%f".format(sep=sep))
 
 
 def os_host_name() -> str:
@@ -612,6 +686,45 @@ def os_user_name() -> str:
     return getpass.getuser()
 
 
+def parse_dotenv(file_path: str) -> Dict[str, str]:
+    """ parse ``.env`` file content and return environment variable names as dict keys and values as dict values.
+
+    :param file_path:           string with the name/path of an existing ``.env``/:data:`DOTENV_FILE_NAME` file.
+    :return:                    dict with environment variable names and values
+    """
+    env_vars: Dict[str, str] = {}
+    for line in cast(str, read_file(file_path)).splitlines():
+        match = _env_line.search(line)
+        if not match:
+            if not re.search(r'^\s*(?:#.*)?$', line):  # not comment or blank
+                warnings.warn(f"'{line!r}' in '{file_path}' doesn't match {DOTENV_FILE_NAME} format", SyntaxWarning)
+            continue
+
+        var_nam, var_val = match.groups()
+        var_val = "" if var_val is None else var_val.strip()
+
+        # remove surrounding quotes, unescape all chars except $ so variables can be escaped properly
+        match = re.match(r'^([\'"])(.*)\1$', var_val)
+        if match:
+            delimiter, var_val = match.groups()
+            if delimiter == '"':
+                var_val = re.sub(r'\\([^$])', r'\1', var_val)
+        else:
+            delimiter = None
+        if delimiter != "'":
+            for parts in _env_variable.findall(var_val):
+                if parts[0] == '\\':
+                    replace = "".join(parts[1:-1])          # don't replace escaped variables
+                else:
+                    # substitute variables in a value, replace it with the value from the environment
+                    replace = env_vars.get(parts[-1], os.environ.get(parts[-1], ""))
+                var_val = var_val.replace("".join(parts[0:-1]), replace)
+
+        env_vars[var_nam] = var_val
+
+    return env_vars
+
+
 def project_main_file(import_name: str, project_path: str = "") -> str:
     """ determine the main module file path of a project package, containing the project __version__ module variable.
 
@@ -878,12 +991,12 @@ if os_platform == 'android':                                    # pragma: no cov
     # 'android' (see # https://bugs.python.org/issue28141 and https://bugs.python.org/issue32073). these functions are
     # used by shutil.copy2/copy/copytree/move to copy OS-specific file attributes.
     # although shutil.copytree() and shutil.move() are copying/moving the files correctly when the copy_function
-    # arg is set to :func:`shutil.copyfile`, they will finally also crash afterwards when they try to set the attributes
+    # arg is set to :func:`shutil.copyfile`, they will finally also crash afterward when they try to set the attributes
     # on the destination root directory.
     shutil.copymode = dummy_function
     shutil.copystat = dummy_function
 
-    # import permissions module from python-for-android (pythonforandroid/recipes/android/src/android/permissions.py)
+    # import permissions module from python-for-android (recipes/android/src/android/permissions.py)
     # noinspection PyUnresolvedReferences
     from android.permissions import request_permissions, Permission     # type: ignore # pylint: disable=import-error
     from jnius import autoclass                                         # type: ignore

{ae_base-0.3.36 → ae_base-0.3.37/ae_base.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ae_base
-Version: 0.3.36
+Version: 0.3.37
 Summary: ae namespace module portion base: basic constants, helper functions and context manager
 Home-page: https://gitlab.com/ae-group/ae_base
 Author: AndiEcker
@@ -51,19 +51,19 @@ Requires-Dist: types-setuptools; extra == "tests"
 Requires-Dist: wheel; extra == "tests"
 Requires-Dist: twine; extra == "tests"
 
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.92 -->
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.13 -->
-# base 0.3.36
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.94 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.14 -->
+# base 0.3.37
 
 [![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_base/develop?logo=python)](
     https://gitlab.com/ae-group/ae_base)
 [![LatestPyPIrelease](
-    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.35?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.35)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.36?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.36)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 
->ae_base module 0.3.36.
+>ae_base module 0.3.37.
 
 [![Coverage](https://ae-group.gitlab.io/ae_base/coverage.svg)](
     https://ae-group.gitlab.io/ae_base/coverage/index.html)

{ae_base-0.3.36 → ae_base-0.3.37}/setup.py

@@ -1,4 +1,4 @@
-# THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_project V0.3.29
+# THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_project V0.3.30
 """ setup this project with setuptools and aedev.setup_project. """
 import pprint
 import sys

{ae_base-0.3.36 → ae_base-0.3.37}/tests/test_base.py

@@ -1,5 +1,7 @@
 """ ae.base unit tests """
 import os
+import tempfile
+
 import pytest
 import shutil
 import sys
@@ -12,12 +14,38 @@ from typing import cast
 
 # noinspection PyProtectedMember
 from ae.base import (
-    BUILD_CONFIG_FILE, PY_EXT, PY_INIT, PY_MAIN, TESTS_FOLDER, UNSET,
+    BUILD_CONFIG_FILE, DOTENV_FILE_NAME, PY_EXT, PY_INIT, PY_MAIN, TESTS_FOLDER, UNSET,
     app_name_guess, build_config_variable_values, camel_to_snake, deep_dict_update, dummy_function, duplicates, env_str,
-    force_encoding, full_stack_trace, import_module, instantiate_config_parser, in_wd, main_file_paths_parts,
-    module_attr, module_file_path, module_name, norm_line_sep, norm_name, norm_path, now_str,
-    os_host_name, os_local_ip, _os_platform, os_user_name, project_main_file, read_file, round_traditional,
-    snake_to_camel, stack_frames, stack_var, stack_vars, sys_env_dict, sys_env_text, to_ascii, write_file)
+    force_encoding, full_stack_trace, import_module, instantiate_config_parser, in_wd,
+    load_env_var_defaults, load_dotenvs, main_file_paths_parts, module_attr, module_file_path, module_name,
+    norm_line_sep, norm_name, norm_path, now_str, os_host_name, os_local_ip, _os_platform, os_user_name,
+    parse_dotenv, project_main_file, read_file, round_traditional, snake_to_camel, stack_frames, stack_var, stack_vars,
+    sys_env_dict, sys_env_text, to_ascii, write_file)
+
+
+env_var_name = 'env_var_nam1'
+env_var_val = 'value of env var'
+folder_name = 'fdr'
+full_folders = (0, 1, 3)
+
+@pytest.fixture
+def os_env_test_env():
+    """ create .env files to test and backup os.environ. """
+    with tempfile.TemporaryDirectory() as tmp_path:
+        for deep in range(6):
+            file_path = os.path.join(tmp_path, *((folder_name,) * deep))
+            os.makedirs(file_path, exist_ok=True)
+            if deep in full_folders:
+                content = (os.linesep +
+                           env_var_name + "='" + env_var_val + str(deep) + "'")
+                write_file(os.path.join(file_path, DOTENV_FILE_NAME), content)
+
+        old_env = os.environ
+        os.environ = old_env.copy()
+
+        yield tmp_path
+
+        os.environ = old_env
 
 
 module_test_var = 'module_test_var_val'   # used for stack_var()/try_exec() tests
@@ -281,6 +309,51 @@ class TestBaseHelpers:
             assert os.getcwd() == tst_dir
         assert os.getcwd() == old_dir
 
+    def test_load_dotenvs(self, os_env_test_env):
+        assert env_var_name not in os.environ
+        load_dotenvs()
+        assert env_var_name not in os.environ
+
+    def test_load_env_var_defaults_not_loaded(self, os_env_test_env):
+        assert env_var_name not in os.environ
+
+        load_env_var_defaults('/')
+        assert env_var_name not in os.environ
+
+        load_env_var_defaults('.')
+        assert env_var_name not in os.environ
+
+        load_env_var_defaults(os.path.join(os_env_test_env, *((folder_name, ) * 5)))
+        assert env_var_name not in os.environ
+
+        load_env_var_defaults(os.path.join(os_env_test_env, *((folder_name, ) * 6)))    # invalid/too-deep path
+        assert env_var_name not in os.environ
+
+    def test_load_env_var_defaults_load_start_parent_first_no_chain(self, os_env_test_env):
+        load_env_var_defaults(os.path.join(os_env_test_env, *((folder_name, ) * 4)))
+        assert env_var_name in os.environ
+        assert os.environ[env_var_name] == env_var_val + '3'
+
+    def test_load_env_var_defaults_load_start_first_no_chain(self, os_env_test_env):
+        load_env_var_defaults(os.path.join(os_env_test_env, *((folder_name, ) * 3)))
+        assert env_var_name in os.environ
+        assert os.environ[env_var_name] == env_var_val + '3'
+
+    def test_load_env_var_defaults_load_start_parent_first_in_chain(self, os_env_test_env):
+        load_env_var_defaults(os.path.join(os_env_test_env, *((folder_name, ) * 2)))
+        assert env_var_name in os.environ
+        assert os.environ[env_var_name] == env_var_val + '1'
+
+    def test_load_env_var_defaults_load_start_no_parent_first_in_chain(self, os_env_test_env):
+        load_env_var_defaults(os.path.join(os_env_test_env, *((folder_name, ) * 1)))
+        assert env_var_name in os.environ
+        assert os.environ[env_var_name] == env_var_val + '1'
+
+    def test_load_env_var_defaults_load_start_on_second_within_chain(self, os_env_test_env):
+        load_env_var_defaults(os.path.join(os_env_test_env, *((folder_name, ) * 0)))
+        assert env_var_name in os.environ
+        assert os.environ[env_var_name] == env_var_val + '0'
+
     def test_main_file_paths_parts(self):
         assert isinstance(main_file_paths_parts(""), tuple)
         assert len(main_file_paths_parts(""))
@@ -401,6 +474,129 @@ class TestBaseHelpers:
         print(os_user_name())
         assert os_user_name()
 
+    def test_parse_dotenv_error_space_prefixed_var_name(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write(' var_nam="var val"')
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' not in loaded      # added warning
+
+    def test_parse_dotenv_double_quoted_value(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write('var_nam="var val"')
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val"
+
+    def test_parse_dotenv_single_value(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("var_nam='var val'")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val"
+
+    def test_parse_dotenv_start_parent_first_in_chain(self, os_env_test_env):
+        assert env_var_name not in os.environ
+        file_path = os.path.join(os_env_test_env, folder_name, DOTENV_FILE_NAME)
+        loaded = parse_dotenv(file_path)
+        assert env_var_name in loaded
+        assert loaded[env_var_name] == env_var_val + '1'
+
+    def test_parse_dotenv_space_surrounded_value(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("var_nam   =   var val   ")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val"
+
+    def test_parse_dotenv_unquoted_value(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("var_nam=var val")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val"
+
+    def test_parse_dotenv_var_escaped_double_quote(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write('var_nam="escaped\\"val"')
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == 'escaped"val'
+
+    def test_parse_dotenv_var_empty_value(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("var_nam=")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == ""
+
+    def test_parse_dotenv_var_expands_variables_found_in_values(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("env_var=var val\nvar_nam=$env_var")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val"
+            assert 'env_var' in loaded
+            assert loaded['env_var'] == "var val"
+
+    def test_parse_dotenv_var_expands_variable_wrapped_in_brackets(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("env_var=var val\n\n\nvar_nam=${env_var} tst")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val tst"
+            assert 'env_var' in loaded
+            assert loaded['env_var'] == "var val"
+
+    def test_parse_dotenv_var_expands_undefined_variable_to_empty_string(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("var_nam=$env_var")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'env_var' not in loaded
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == ""
+
+    def test_parse_dotenv_var_expands_in_double_quoted_values(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("env_var=tst\nvar_nam=\"var val $env_var\"")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val tst"
+
+    def test_parse_dotenv_var_not_expands_in_single_quoted_values(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("var_nam='var val $env_var'")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val $env_var"
+
+    def test_parse_dotenv_var_not_expands_escaped_variables(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("var_nam=var val \\$env_var \${env_var}")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val $env_var ${env_var}"
+
+    def test_parse_dotenv_var_export_keyword(self):
+        with tempfile.NamedTemporaryFile(mode="w") as fp:
+            fp.write("export var_nam=var val")
+            fp.seek(0)
+            loaded = parse_dotenv(fp.name)
+            assert 'var_nam' in loaded
+            assert loaded['var_nam'] == "var val"
+
     def test_project_main_file(self):
         assert project_main_file("not_existing_xy.tst") == ""
 
@@ -619,8 +815,8 @@ class TestModuleHelpers:
         assert module_attr(mod_name, attr_name=att_name) is None
 
     def test_module_file_path(self):
-        assert module_file_path()
-        assert module_file_path(lambda: 0)
+        assert module_file_path() == __file__
+        assert module_file_path(lambda: 0) == __file__
 
     def test_module_name(self):
         assert module_name() == 'test_base'