"""Ferrite beads: recover Z from evidence; never invent; never abort ingest.""" from __future__ import annotations import json from pathlib import Path import pytest from pydantic import ValidationError from backend.periscopex.ferrite_z import recover_bead_specs, z_from_datasheet_text from backend.periscopex.graph import _load_component_models from backend.periscopex.models import ComponentModel, InductorSpecs, SimpleComponentSpecs from backend.periscopex.resolve_passives import simple_to_typed_passive_specs def test_ferrite_bead_quoted_ohm_fills_z_not_henries(): specs = InductorSpecs( component_subtype="passive.ferrite_bead", value_formatted="120 ohm @ 100 MHz", current_rating_a="3A", dcr_ohms=0.03, ) assert specs.impedance_ohm == 120.0 assert specs.value_henries is None model = ComponentModel(mpn="BLM21PG121SN1D", specs=specs) assert model.specs.impedance_ohm == 120.0 def test_ferrite_bead_live_payload_fills_z_from_formatted(): model = ComponentModel.model_validate({ "mpn": "BLM21PG121SN1D", "specs": { "specs_type": "inductor", "component_subtype": "passive.ferrite_bead", "value_henries": 120.0, "value_formatted": "120 ohm @ 100 MHz", "tolerance": None, "package": "0805", "current_rating_a": "3A", "dcr_ohms": 0.03, }, }) assert model.specs.impedance_ohm == 120.0 assert model.specs.value_henries is None assert model.specs.current_rating_a == "3A" assert model.specs.dcr_ohms == 0.03 def test_ferrite_bead_with_impedance_ohm_still_ok(): specs = InductorSpecs( component_subtype="passive.ferrite_bead", value_formatted="120 ohm @ 100 MHz", impedance_ohm=120.0, current_rating_a="3A", dcr_ohms=0.03, ) assert specs.impedance_ohm == 120.0 assert specs.value_henries is None def test_inductor_still_requires_value_henries(): with pytest.raises(ValidationError, match="inductor requires value_henries"): InductorSpecs( component_subtype="passive.inductor", value_formatted="15nH", ) def test_load_models_bead_without_z_does_not_raise(tmp_path: Path): payload = { "mpn": "BLM21PG121SN1D", "specs": { "specs_type": "inductor", "component_subtype": "passive.ferrite_bead", "value_formatted": "FB", "current_rating_a": "3A", "dcr_ohms": 0.03, }, } (tmp_path / "BLM21PG121SN1D.json").write_text(json.dumps(payload) + "\n") loaded = _load_component_models(tmp_path) assert "BLM21PG121SN1D" in loaded assert loaded["BLM21PG121SN1D"].impedance_ohm is None def test_load_models_skips_inductor_missing_henries(tmp_path: Path): bad = { "mpn": "LQW-BAD", "specs": { "specs_type": "inductor", "component_subtype": "passive.inductor", "value_formatted": "x", }, } (tmp_path / "LQW-BAD.json").write_text(json.dumps(bad) + "\n") loaded = _load_component_models(tmp_path) assert loaded == {} def test_simple_to_typed_bead_without_z(): simple = SimpleComponentSpecs( specs_type="passive", component_subtype="passive.ferrite_bead", values={"current_rating_a": "3A", "dcr_ohms": 0.03}, ) specs = simple_to_typed_passive_specs(simple) assert specs.specs_type == "inductor" assert specs.impedance_ohm is None assert specs.dcr_ohms == 0.03 def test_bead_mpn_datasheet_text_fills_z(): text = ( "BLM21PG121SN1D chip ferrite bead\n" "Impedance (at 100MHz / 20°C) 120 ohm\n" "Rated current 3A\n" "DC resistance 0.03 ohm\n" ) hit = z_from_datasheet_text(text) assert hit is not None z, formatted = hit assert z == 120.0 assert "100" in formatted assert "datasheet" in formatted specs = InductorSpecs( component_subtype="passive.ferrite_bead", value_formatted="FB", current_rating_a="3A", dcr_ohms=0.03, ) filled = recover_bead_specs(specs, extra_text=text) assert filled.impedance_ohm == 120.0 assert filled.value_henries is None def test_bead_mpn_datasheet_without_z_does_not_invent(): text = "BLM21PG121SN1D\nRated current 3 A\nDCR 0.03 ohm max\nPackage 0805" assert z_from_datasheet_text(text) is None specs = InductorSpecs( component_subtype="passive.ferrite_bead", value_formatted="FB", current_rating_a="3A", dcr_ohms=0.03, ) filled = recover_bead_specs(specs, extra_text=text) assert filled.impedance_ohm is None model = ComponentModel(mpn="BLM21PG121SN1D", specs=filled) assert model.specs.impedance_ohm is None def _write_text_pdf(path: Path, text: str) -> None: """Write a one-page PDF pypdf can extract without PyMuPDF.""" escaped = ( text.replace("\\", "\\\\").replace("(", "\\(").replace(")", "\\)") ) lines = escaped.split("\n") ops = ["BT /F1 12 Tf 72 720 Td"] for i, line in enumerate(lines): if i: ops.append("0 -16 Td") ops.append(f"({line}) Tj") ops.append("ET") stream = "\n".join(ops).encode("latin-1", "replace") objects = [ b"1 0 obj << /Type /Catalog /Pages 2 0 R >> endobj\n", b"2 0 obj << /Type /Pages /Kids [3 0 R] /Count 1 >> endobj\n", ( b"3 0 obj << /Type /Page /Parent 2 0 R /MediaBox [0 0 612 792] " b"/Contents 4 0 R /Resources << /Font << /F1 5 0 R >> >> >> endobj\n" ), b"4 0 obj << /Length %d >> stream\n" % len(stream) + stream + b"\nendstream endobj\n", b"5 0 obj << /Type /Font /Subtype /Type1 /BaseFont /Helvetica >> endobj\n", ] header = b"%PDF-1.4\n" body = header offsets = [0] for obj in objects: offsets.append(len(body)) body += obj xref_pos = len(body) xref = [b"xref\n0 6\n0000000000 65535 f \n"] for off in offsets[1:]: xref.append(f"{off:010d} 00000 n \n".encode()) trailer = ( b"trailer << /Root 1 0 R /Size 6 >>\nstartxref\n" + str(xref_pos).encode() + b"\n%%EOF\n" ) path.parent.mkdir(parents=True, exist_ok=True) path.write_bytes(body + b"".join(xref) + trailer) _BEAD_MODEL = { "mpn": "BLM21PG121SN1D", "specs": { "specs_type": "inductor", "component_subtype": "passive.ferrite_bead", "value_formatted": "FB", "current_rating_a": "3A", "dcr_ohms": 0.03, }, } def test_bead_mpn_datasheet_pdf_fills_z(tmp_path: Path): models = tmp_path / "models" models.mkdir() (models / "BLM21PG121SN1D.json").write_text(json.dumps(_BEAD_MODEL) + "\n") _write_text_pdf( tmp_path / "uploads" / "datasheets" / "BLM21PG121SN1D.pdf", "BLM21PG121SN1D\nImpedance (at 100MHz / 20C) 120 ohm\nRated current 3A", ) loaded = _load_component_models(models) assert loaded["BLM21PG121SN1D"].impedance_ohm == 120.0 assert loaded["BLM21PG121SN1D"].value_henries is None persisted = json.loads((models / "BLM21PG121SN1D.json").read_text()) assert persisted["specs"]["impedance_ohm"] == 120.0 assert persisted["specs"]["value_henries"] is None assert "100" in (persisted["specs"].get("value_formatted") or "") def test_bead_live_json_persist_unstuffs_henries(tmp_path: Path): models = tmp_path / "models" models.mkdir() payload = { "mpn": "BLM21PG121SN1D", "specs": { "specs_type": "inductor", "component_subtype": "passive.ferrite_bead", "value_henries": 120.0, "value_formatted": "120 ohm @ 100 MHz", "package": "0805", "current_rating_a": "3A", "dcr_ohms": 0.03, }, } (models / "BLM21PG121SN1D.json").write_text(json.dumps(payload) + "\n") loaded = _load_component_models(models) assert loaded["BLM21PG121SN1D"].impedance_ohm == 120.0 assert loaded["BLM21PG121SN1D"].value_henries is None persisted = json.loads((models / "BLM21PG121SN1D.json").read_text()) assert persisted["specs"]["impedance_ohm"] == 120.0 assert persisted["specs"]["value_henries"] is None def test_bead_mpn_datasheet_pdf_without_z_does_not_invent(tmp_path: Path): models = tmp_path / "models" models.mkdir() (models / "BLM21PG121SN1D.json").write_text(json.dumps(_BEAD_MODEL) + "\n") _write_text_pdf( tmp_path / "uploads" / "datasheets" / "BLM21PG121SN1D.pdf", "BLM21PG121SN1D\nRated current 3 A\nDCR 0.03 ohm max\nPackage 0805", ) loaded = _load_component_models(models) assert "BLM21PG121SN1D" in loaded assert loaded["BLM21PG121SN1D"].impedance_ohm is None assert loaded["BLM21PG121SN1D"].value_henries is None def test_bead_mpn_library_blob_fills_z(tmp_path: Path): models = tmp_path / "proj" / "models" models.mkdir(parents=True) (models / "BLM21PG121SN1D.json").write_text(json.dumps(_BEAD_MODEL) + "\n") blob = tmp_path / "library" / "datasheets" / "blobs" / "deadbeef.pdf" _write_text_pdf( blob, "Impedance (at 100MHz / 20C) 120 ohm\nRated current 3A", ) ref = tmp_path / "library" / "datasheets" / "refs" / "BLM21PG121SN1D.json" ref.parent.mkdir(parents=True, exist_ok=True) ref.write_text(json.dumps({ "hash": "deadbeef", "blob_key": "library/datasheets/blobs/deadbeef.pdf", "mpn": "BLM21PG121SN1D", }) + "\n") loaded = _load_component_models(models, extra_pdf_dirs=[tmp_path]) assert loaded["BLM21PG121SN1D"].impedance_ohm == 120.0 assert loaded["BLM21PG121SN1D"].value_henries is None