"""Tests for esphome.espidf.size_summary.print_summary.""" from __future__ import annotations import json from pathlib import Path import pytest from esphome.espidf.size_summary import print_summary def _write_size_json(tmp_path: Path, data: dict) -> Path: """Drop a fake esp_idf_size.json under ``tmp_path`` and return the path.""" out = tmp_path / "esp_idf_size.json" out.write_text(json.dumps(data)) return out def _esp32_size_data() -> dict: """Synthetic esp_idf_size.json for the original ESP32 (split IRAM/DRAM).""" return { "image_size": 827455, "memory_types": { "DRAM": { "size": 180736, "used": 47332, "sections": { ".dram0.bss": {"abbrev_name": ".bss", "size": 30616}, ".dram0.data": {"abbrev_name": ".data", "size": 16716}, }, }, "IRAM": { "size": 131072, "used": 80351, "sections": { ".iram0.text": {"abbrev_name": ".text", "size": 79323}, ".iram0.vectors": {"abbrev_name": ".vectors", "size": 1028}, }, }, }, } def _s3_size_data() -> dict: """Synthetic esp_idf_size.json for ESP32-S3 (unified DIRAM).""" return { "image_size": 724215, "memory_types": { "DIRAM": { "size": 341760, "used": 104999, "sections": { ".iram0.text": {"abbrev_name": ".text", "size": 58051}, ".dram0.bss": {"abbrev_name": ".bss", "size": 27088}, ".dram0.data": {"abbrev_name": ".data", "size": 19708}, ".noinit": {"abbrev_name": ".noinit", "size": 152}, }, }, "IRAM": { "size": 16384, "used": 16384, "sections": { ".iram0.text": {"abbrev_name": ".text", "size": 15356}, ".iram0.vectors": {"abbrev_name": ".vectors", "size": 1028}, }, }, }, } def test_print_summary_esp32_uses_dram( tmp_path: Path, capsys: pytest.CaptureFixture[str] ) -> None: """Original ESP32: DRAM has no ``.text``, so RAM = DRAM.used / DRAM.size unchanged.""" size_json = _write_size_json(tmp_path, _esp32_size_data()) print_summary(size_json, partitions_csv=None) out = capsys.readouterr().out assert "RAM:" in out assert "used 47332 bytes from 180736 bytes" in out def test_print_summary_s3_falls_back_to_diram( tmp_path: Path, capsys: pytest.CaptureFixture[str] ) -> None: """ESP32-S3 with no DRAM key falls back to DIRAM and reports raw region usage.""" size_json = _write_size_json(tmp_path, _s3_size_data()) print_summary(size_json, partitions_csv=None) out = capsys.readouterr().out assert "used 104999 bytes from 341760 bytes" in out def test_print_summary_skips_when_diram_total_collapses( tmp_path: Path, capsys: pytest.CaptureFixture[str] ) -> None: """A zero-size region drops the RAM line rather than divide by zero.""" size_json = _write_size_json( tmp_path, { "memory_types": { "DIRAM": { "size": 0, "used": 0, "sections": {}, }, }, }, ) print_summary(size_json, partitions_csv=None) out = capsys.readouterr().out assert "RAM:" not in out def test_print_summary_handles_missing_json( tmp_path: Path, capsys: pytest.CaptureFixture[str] ) -> None: """Missing size json is non-fatal and prints nothing.""" print_summary(tmp_path / "does_not_exist.json", partitions_csv=None) assert capsys.readouterr().out == "" def test_print_summary_handles_no_memory_types( tmp_path: Path, capsys: pytest.CaptureFixture[str] ) -> None: """A size json without ``memory_types`` still doesn't crash.""" size_json = _write_size_json(tmp_path, {"image_size": 0}) print_summary(size_json, partitions_csv=None) assert capsys.readouterr().out == "" def test_format_bar_zero_total() -> None: """A zero total must not divide by zero.""" from esphome.espidf.size_summary import format_bar assert format_bar(0, 0) == "[ ] 0.0% (used 0 bytes from 0 bytes)" def test_print_summary_flash_line( tmp_path: Path, capsys: pytest.CaptureFixture[str] ) -> None: """image_size + a factory app partition produce the Flash line.""" size_json = tmp_path / "esp_idf_size.json" size_json.write_text( json.dumps( { "memory_types": {"DRAM": {"used": 100, "size": 200}}, "image_size": 500, } ) ) partitions = tmp_path / "partitions.csv" partitions.write_text( "# name, type, subtype, offset, size\napp0, app, factory, 0x10000, 0x100000\n" ) print_summary(size_json, partitions) out = capsys.readouterr().out assert "RAM: [===== ] 50.0% (used 100 bytes from 200 bytes)" in out assert "Flash: [ ] 0.0% (used 500 bytes from 1048576 bytes)" in out