"""Adopt environment section in pytest configuration files."""

from __future__ import annotations

import os
import sys
from dataclasses import dataclass
from itertools import chain
from typing import TYPE_CHECKING

import pytest

if TYPE_CHECKING:
    from collections.abc import Iterator

if sys.version_info >= (3, 11):  # pragma: >=3.11 cover
    import tomllib
else:  # pragma: <3.11 cover
    import tomli as tomllib


def pytest_addoption(parser: pytest.Parser) -> None:
    """Add section to configuration files."""
    help_msg = "a line separated list of environment variables of the form (FLAG:)NAME=VALUE"
    parser.addini("env", type="linelist", help=help_msg, default=[])


@dataclass
class Entry:
    """Configuration entries."""

    key: str
    value: str
    transform: bool
    skip_if_set: bool


@pytest.hookimpl(tryfirst=True)
def pytest_load_initial_conftests(
    args: list[str],  # noqa: ARG001
    early_config: pytest.Config,
    parser: pytest.Parser,  # noqa: ARG001
) -> None:
    """Load environment variables from configuration files."""
    for entry in _load_values(early_config):
        if entry.skip_if_set and entry.key in os.environ:
            continue
        # transformation -> replace environment variables, e.g. TEST_DIR={USER}/repo_test_dir.
        os.environ[entry.key] = entry.value.format(**os.environ) if entry.transform else entry.value


def _load_values(early_config: pytest.Config) -> Iterator[Entry]:
    has_toml_conf = False
    for path in chain.from_iterable([[early_config.rootpath], early_config.rootpath.parents]):  # noqa: PLR1702
        toml_file = path / "pyproject.toml"
        if toml_file.exists():
            with toml_file.open("rb") as file_handler:
                config = tomllib.load(file_handler)
                if "tool" in config and "pytest_env" in config["tool"]:
                    has_toml_conf = True
                    for key, entry in config["tool"]["pytest_env"].items():
                        if isinstance(entry, dict):
                            value = str(entry["value"])
                            transform, skip_if_set = bool(entry.get("transform")), bool(entry.get("skip_if_set"))
                        else:
                            value, transform, skip_if_set = str(entry), False, False
                        yield Entry(key, value, transform, skip_if_set)
            break

    if not has_toml_conf:
        for line in early_config.getini("env"):
            # INI lines e.g. D:R:NAME=VAL has two flags (R and D), NAME key, and VAL value
            parts = line.partition("=")
            ini_key_parts = parts[0].split(":")
            flags = {k.strip().upper() for k in ini_key_parts[:-1]}
            # R: is a way to designate whether to use raw value -> perform no transformation of the value
            transform = "R" not in flags
            # D: is a way to mark the value to be set only if it does not exist yet
            skip_if_set = "D" in flags
            key = ini_key_parts[-1].strip()
            value = parts[2].strip()
            yield Entry(key, value, transform, skip_if_set)
