# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.
"""Tests for environment-driven Swagger UI config defaults.

``superset.config`` is imported in a fresh subprocess for each case so the
module is evaluated under a controlled environment without reloading (and
mutating) the config module shared by the rest of the test session.
"""

import os
import subprocess
import sys

import pytest


def _resolve_swagger_default(env_value: str | None) -> str:
    """Resolve ``FAB_API_SWAGGER_UI`` for a given ``SUPERSET_ENABLE_SWAGGER_UI``.

    Evaluates ``superset.config`` in a fresh subprocess under a controlled
    environment so the result reflects only the supplied env var. Config-path
    overrides are stripped so a local ``superset_config`` cannot taint the
    default, and only the final stdout line is read in case config loading
    emits banner output.
    """
    env = dict(os.environ)
    for var in (
        "SUPERSET_ENABLE_SWAGGER_UI",
        "SUPERSET_CONFIG_PATH",
        "SUPERSET_CONFIG",
    ):
        env.pop(var, None)
    if env_value is not None:
        env["SUPERSET_ENABLE_SWAGGER_UI"] = env_value
    result = subprocess.run(  # noqa: S603
        [
            sys.executable,
            "-c",
            "import superset.config as c; print(c.FAB_API_SWAGGER_UI)",
        ],
        env=env,
        capture_output=True,
        text=True,
        check=True,
    )
    return result.stdout.strip().splitlines()[-1]


@pytest.mark.parametrize(
    "env_value, expected",
    [
        (None, "False"),  # unset -> off by default
        ("true", "True"),
        ("True", "True"),
        ("false", "False"),
        ("", "False"),
    ],
)
def test_fab_api_swagger_ui_is_env_driven_and_off_by_default(
    env_value: str | None, expected: str
) -> None:
    """Swagger UI defaults to off and follows ``SUPERSET_ENABLE_SWAGGER_UI``."""
    assert _resolve_swagger_default(env_value) == expected