"""Tests for the Arduino framework version floor."""

import pytest

from esphome.components.esp8266 import (
    _arduino_check_versions,
    _format_framework_arduino_version,
    _framework_package_version,
)
import esphome.config_validation as cv
from esphome.const import CONF_PLATFORM_VERSION, CONF_VERSION
from esphome.core import EsphomeError


def test_versions_before_3_are_rejected() -> None:
    with pytest.raises(cv.Invalid, match="no longer supported") as excinfo:
        _arduino_check_versions({CONF_VERSION: "2.7.4"})
    assert excinfo.value.path == [CONF_VERSION]


def test_supported_versions_pass() -> None:
    value = _arduino_check_versions({CONF_VERSION: "3.0.2"})
    assert value[CONF_VERSION] == "3.0.2"
    assert "espressif8266@3.2.0" in value[CONF_PLATFORM_VERSION]

    value = _arduino_check_versions({CONF_VERSION: "recommended"})
    assert value[CONF_VERSION] == "3.1.2"
    assert "espressif8266@4.2.1" in value[CONF_PLATFORM_VERSION]


def test_framework_package_version() -> None:
    assert _framework_package_version(cv.Version(3, 1, 2)) == "3.30102.0"
    assert _framework_package_version(cv.Version(3, 2, 0)) == "3.30200.0"
    # A future major bump needs its own encoding, not a doomed registry lookup
    with pytest.raises(EsphomeError, match="not supported yet"):
        _framework_package_version(cv.Version(4, 0, 0))
    # Cores before 3.x cannot build ESPHome (C++20) and are rejected
    with pytest.raises(EsphomeError, match="requires core 3"):
        _framework_package_version(cv.Version(2, 7, 4))


def test_format_framework_arduino_version_pins_all_series() -> None:
    """The PlatformIO source formatter across every encoding era."""

    assert _format_framework_arduino_version(cv.Version(3, 1, 2)) == "~3.30102.0"
    # Pre-3 cores are rejected with the version line anchored
    with pytest.raises(cv.Invalid, match="requires core 3"):
        _format_framework_arduino_version(cv.Version(2, 7, 4))
    # Anchored to the framework version line, not a bare EsphomeError
    with pytest.raises(cv.Invalid, match="not supported yet") as excinfo:
        _format_framework_arduino_version(cv.Version(4, 0, 0))
    assert excinfo.value.path == ["version"]