Function _resolve_variable_substitution

ci/compiler/platformio_ini.py:444–485

Resolve variable substitution in a configuration value. Supports patterns like ${env:generic-esp.build_flags} and ${platformio.build_cache_dir}. Args: value: Value potentially containing variable references config: ConfigParser to resolve variables from Returns:

(
    value: str, config: configparser.ConfigParser
)

def _resolve_variable_substitution(
    value: str, config: configparser.ConfigParser
) -> str:
    """
    Resolve variable substitution in a configuration value.
    Supports patterns like ${env:generic-esp.build_flags} and ${platformio.build_cache_dir}.

    Args:
        value: Value potentially containing variable references
        config: ConfigParser to resolve variables from

    Returns:
        Value with variables resolved
    """
    if not value or "${" not in value:
        return value

    # Pattern to match ${section.option} or ${section:subsection.option}
    pattern = r"\$\{([^}]+)\}"

    def replace_variable(match: re.Match[str]) -> str:
        var_ref = match.group(1)

        # Handle section:subsection.option format (like env:generic-esp.build_flags)
        if ":" in var_ref:
            section_part, option = var_ref.split(".", 1)
            section = section_part.replace(":", ":")
        else:
            # Handle section.option format (like platformio.build_cache_dir)
            section, option = var_ref.split(".", 1)

        try:
            if config.has_option(section, option):
                return config.get(section, option)
            else:
                # Return original if not found
                return match.group(0)
        except (configparser.NoSectionError, configparser.NoOptionError):
            # Return original if resolution fails
            return match.group(0)

    return re.sub(pattern, replace_variable, value)


def _resolve_list_variables(