"""scripts/sweep_blend_bsdf.py の _generate_tmp_yaml 仕様ベーステスト． 仕様出典: 実装サマリー §E - E1: weight/alpha パラメータが一時 YAML に正しく書き込まれること - E2: geometry.meshes の STL パスが一時 YAML からの相対パス（POSIX 区切り）に変換されること （旧仕様は絶対パス化．Windows で生成した YAML を研究室サーバで読めないため 2026-09-13 に scene/paths.py の relative_mesh_path による YAML 相対パスへ変更） - E3: 一時 YAML が BOM なし UTF-8 で書かれること - E4: name フィールドが "baseline_minitias_blend_{job_name}" 形式に更新されること テスト戦略: - subprocess（sm-render 実行）は含まない．_generate_tmp_yaml の純変換ロジックのみをテストする - 実際の TEMPLATE_YAML（configs/scene_baseline_blend.yaml）を使用する - 出力先は tmp_path フィクスチャ（実ファイル）を使用する（testing.md のモック方針） """ from __future__ import annotations import sys from pathlib import Path, PurePosixPath, PureWindowsPath from types import ModuleType from unittest import mock import pytest import yaml # --------------------------------------------------------------------------- # sweep_blend_bsdf モジュールをインポートするヘルパ # --------------------------------------------------------------------------- _ROOT = Path(__file__).resolve().parents[2] _SCRIPT_PATH = _ROOT / "scripts" / "sweep_blend_bsdf.py" _TEMPLATE_YAML = _ROOT / "configs" / "scene_baseline_blend.yaml" def _load_sweep_module() -> ModuleType: """sweep_blend_bsdf.py を直接インポートする． scripts/ は通常のパッケージではないため importlib.util で直接ロードする． モジュールキャッシュに登録して再 import を防ぐ． """ import importlib.util spec = importlib.util.spec_from_file_location("sweep_blend_bsdf", _SCRIPT_PATH) assert spec is not None, f"スクリプトが見つかりません: {_SCRIPT_PATH}" module = importlib.util.module_from_spec(spec) # モジュールキャッシュに登録（2回目以降の import を安全にする） sys.modules["sweep_blend_bsdf"] = module assert spec.loader is not None spec.loader.exec_module(module) # type: ignore[union-attr] return module @pytest.fixture(scope="module") def sweep_module() -> ModuleType: """sweep_blend_bsdf モジュールを返すフィクスチャ（モジュールスコープ）．""" return _load_sweep_module() # --------------------------------------------------------------------------- # テンプレート YAML の存在確認（前提条件チェック） # --------------------------------------------------------------------------- def test_template_yaml_exists(): """configs/scene_baseline_blend.yaml が存在すること（テストの前提条件）． このファイルがなければ E 系テスト全体が無効になる． """ assert _TEMPLATE_YAML.exists(), ( f"テンプレート YAML が見つかりません: {_TEMPLATE_YAML}\n" "configs/scene_baseline_blend.yaml を生成してからテストを実行してください．" ) # --------------------------------------------------------------------------- # E1: weight/alpha が一時 YAML に正しく書き込まれる # --------------------------------------------------------------------------- class TestGenerateTmpYamlParameters: """E1 系: weight と alpha が一時 YAML の正しいパスに書き込まれること．""" @pytest.fixture(autouse=True) def _patch_tmp_dir(self, tmp_path, sweep_module): """TMP_DIR を tmp_path に差し替えて一時 YAML の出力先をテスト用にする．""" with mock.patch.object(sweep_module, "TMP_DIR", tmp_path): yield def test_weight_written_to_printer_white(self, sweep_module): """生成された YAML の materials.printer_white.weight が入力値 0.15 と一致すること． 仕様 E1: weight=0.15 が一時 YAML の printer_white.weight に書き込まれる """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) assert data["materials"]["printer_white"]["weight"] == pytest.approx(0.15) def test_alpha_written_to_roughconductor_component(self, sweep_module): """生成された YAML の components[1].alpha が入力値 0.3 と一致すること． 仕様 E1: alpha=0.3 が components[1].alpha に書き込まれる """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) assert data["materials"]["printer_white"]["components"][1]["alpha"] == pytest.approx(0.3) def test_weight_0_05_written_correctly(self, sweep_module): """weight=0.05 が正しく書き込まれること（スイープ最小値）． 仕様 E1: スイープグリッドの全値で正しく書き込まれること """ tmp_yaml = sweep_module._generate_tmp_yaml(0.05, 0.1) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) assert data["materials"]["printer_white"]["weight"] == pytest.approx(0.05) def test_alpha_0_6_written_correctly(self, sweep_module): """alpha=0.6 が正しく書き込まれること（スイープ最大値）． 仕様 E1: スイープグリッドの全値で正しく書き込まれること """ tmp_yaml = sweep_module._generate_tmp_yaml(0.30, 0.6) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) assert data["materials"]["printer_white"]["components"][1]["alpha"] == pytest.approx(0.6) def test_weight_0_30_written_correctly(self, sweep_module): """weight=0.30 が正しく書き込まれること（スイープ最大値）． 仕様 E1: スイープグリッドの全値で正しく書き込まれること """ tmp_yaml = sweep_module._generate_tmp_yaml(0.30, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) assert data["materials"]["printer_white"]["weight"] == pytest.approx(0.30) def test_component0_type_still_diffuse_after_write(self, sweep_module): """components[0].type が "diffuse" のまま保持されること（破壊的書き換えがないこと）． 仕様 E1: alpha 書き換えは components[1] のみに影響する """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) assert data["materials"]["printer_white"]["components"][0]["type"] == "diffuse" def test_component1_type_still_roughconductor_after_write(self, sweep_module): """components[1].type が "roughconductor" のまま保持されること． 仕様 E1: alpha 書き換えは値のみで type フィールドは変更しない """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) assert data["materials"]["printer_white"]["components"][1]["type"] == "roughconductor" # --------------------------------------------------------------------------- # E2: geometry.meshes の path が一時 YAML からの相対パス（POSIX 区切り）に変換されること # --------------------------------------------------------------------------- class TestGenerateTmpYamlRelativePaths: """E2 系: メッシュパスは一時 YAML のディレクトリからの相対パス（POSIX 区切り）で書かれ， YAML の場所から解決するとテンプレートと同じ実在のメッシュを指すこと． 旧仕様（絶対パス化）は Windows で生成した YAML（C:\\Users\\...）を研究室サーバで 読めないため廃止した（2026-09-13．scene/paths.py relative_mesh_path）． """ @pytest.fixture(autouse=True) def _patch_tmp_dir(self, tmp_path, sweep_module): """TMP_DIR を tmp_path に差し替える．""" if tmp_path.resolve().drive.upper() != _ROOT.drive.upper(): pytest.skip("tmp_path とリポジトリが別ドライブのため相対パスで表せない環境") with mock.patch.object(sweep_module, "TMP_DIR", tmp_path): yield @staticmethod def _generate(sweep_module) -> tuple[Path, list[dict]]: tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) meshes = data["geometry"]["meshes"] assert len(meshes) > 0, "meshes が空のため検証不可" return tmp_yaml, meshes def test_no_mesh_path_is_absolute(self, sweep_module): """全メッシュの path が（POSIX でも Windows でも）絶対パスでないこと． 仕様 E2: 絶対パスだと別マシン（研究室サーバ）で読めない """ _, meshes = self._generate(sweep_module) for mesh in meshes: p = mesh["path"] assert not PurePosixPath(p).is_absolute(), f"mesh '{mesh.get('id')}': {p}" assert not PureWindowsPath(p).is_absolute(), f"mesh '{mesh.get('id')}': {p}" assert not PureWindowsPath(p).drive, f"mesh '{mesh.get('id')}': {p}" def test_mesh_paths_use_posix_separator(self, sweep_module): """区切り文字は / のみであること（Windows で生成しても Linux で読める）．""" _, meshes = self._generate(sweep_module) for mesh in meshes: assert "\\" not in mesh["path"], f"mesh '{mesh.get('id')}': {mesh['path']}" def test_relative_path_resolves_to_template_mesh(self, sweep_module): """YAML の場所から解決すると，テンプレート（configs/）基準の元のメッシュを指すこと． 仕様 E2: template_base = TEMPLATE_YAML.parent（configs/）基準の実体を， 書き出し先 YAML のディレクトリからの相対パスで表す """ tmp_yaml, meshes = self._generate(sweep_module) template = yaml.safe_load(_TEMPLATE_YAML.read_text(encoding="utf-8")) originals = {m["id"]: m["path"] for m in template["geometry"]["meshes"]} assert {m["id"] for m in meshes} == set(originals) for mesh in meshes: resolved = (tmp_yaml.parent / mesh["path"]).resolve() expected = (_TEMPLATE_YAML.parent / originals[mesh["id"]]).resolve() assert resolved == expected, f"mesh '{mesh.get('id')}': {mesh['path']}" assert resolved.is_file(), f"mesh '{mesh.get('id')}' の実体がありません: {resolved}" # --------------------------------------------------------------------------- # E3: 一時 YAML が BOM なし UTF-8 で書かれること # --------------------------------------------------------------------------- class TestGenerateTmpYamlEncoding: """E3 系: 一時 YAML のエンコーディング仕様．""" @pytest.fixture(autouse=True) def _patch_tmp_dir(self, tmp_path, sweep_module): """TMP_DIR を tmp_path に差し替える．""" with mock.patch.object(sweep_module, "TMP_DIR", tmp_path): yield def test_output_file_has_no_bom(self, sweep_module): """一時 YAML ファイルが UTF-8 BOM（EF BB BF）で始まっていないこと． 仕様 E3: BOM なし UTF-8（Mitsuba YAML パーサは BOM 付きで失敗するため） """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) raw = tmp_yaml.read_bytes() # UTF-8 BOM は 0xEF 0xBB 0xBF bom = b"\xef\xbb\xbf" assert not raw.startswith(bom), ( "一時 YAML が UTF-8 BOM で始まっています．BOM なし UTF-8 で書き込んでください．" ) def test_output_file_is_valid_utf8(self, sweep_module): """一時 YAML ファイルが UTF-8 として正常にデコードできること． 仕様 E3: UTF-8 エンコーディングで書かれていること """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) raw = tmp_yaml.read_bytes() # UnicodeDecodeError が発生しなければ OK decoded = raw.decode("utf-8") assert len(decoded) > 0 def test_output_file_parseable_as_yaml(self, sweep_module): """一時 YAML ファイルが YAML として正常にパースできること． 仕様 E3: 書き込み後に yaml.safe_load で再読み込みできること（エンコーディング崩れなし） """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) assert isinstance(data, dict) assert "name" in data # --------------------------------------------------------------------------- # E4: name フィールドが "baseline_minitias_blend_{job_name}" 形式になること # --------------------------------------------------------------------------- class TestGenerateTmpYamlName: """E4 系: 一時 YAML の name フィールド仕様．""" @pytest.fixture(autouse=True) def _patch_tmp_dir(self, tmp_path, sweep_module): """TMP_DIR を tmp_path に差し替える．""" with mock.patch.object(sweep_module, "TMP_DIR", tmp_path): yield def test_name_starts_with_baseline_minitias_blend(self, sweep_module): """name が "baseline_minitias_blend_" で始まること． 仕様 E4: name フィールドが "baseline_minitias_blend_{job_name}" 形式 """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) assert data["name"].startswith("baseline_minitias_blend_") def test_name_contains_weight_and_alpha(self, sweep_module): """name に weight と alpha の値が含まれること． 仕様 E4: job_name = f"w{weight}_a{alpha}" 形式 """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) # job_name は "w0.15_a0.3" 相当 name = data["name"] assert "0.15" in name, f"weight 0.15 が name に含まれない: {name}" assert "0.3" in name, f"alpha 0.3 が name に含まれない: {name}" def test_name_format_for_weight_0_05_alpha_0_1(self, sweep_module): """weight=0.05, alpha=0.1 のとき name が適切な形式であること． 仕様 E4: スイープグリッドの全組合せで name が正しい形式になる """ tmp_yaml = sweep_module._generate_tmp_yaml(0.05, 0.1) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) name = data["name"] assert name.startswith("baseline_minitias_blend_") assert "0.05" in name assert "0.1" in name def test_name_format_for_weight_0_30_alpha_0_6(self, sweep_module): """weight=0.30, alpha=0.6 のとき name が適切な形式であること． 仕様 E4: スイープグリッドの最大値でも name が正しい形式になる """ tmp_yaml = sweep_module._generate_tmp_yaml(0.30, 0.6) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) name = data["name"] assert name.startswith("baseline_minitias_blend_") assert "0.3" in name # 0.30 → "0.3" が含まれれば OK assert "0.6" in name def test_name_differs_across_different_params(self, sweep_module): """異なるパラメータ組み合わせで生成された name が異なること． 仕様 E4: name がジョブ識別子を含むため各ジョブで一意になる """ tmp1 = sweep_module._generate_tmp_yaml(0.05, 0.1) tmp2 = sweep_module._generate_tmp_yaml(0.30, 0.6) with tmp1.open(encoding="utf-8") as f: d1 = yaml.safe_load(f) with tmp2.open(encoding="utf-8") as f: d2 = yaml.safe_load(f) assert d1["name"] != d2["name"], "異なるパラメータで同じ name が生成されています" def test_original_template_name_is_not_used(self, sweep_module): """テンプレートの元の name ("baseline_minitias_blend") がそのまま使われないこと． 仕様 E4: name フィールドがジョブごとに更新される """ tmp_yaml = sweep_module._generate_tmp_yaml(0.15, 0.3) with tmp_yaml.open(encoding="utf-8") as f: data = yaml.safe_load(f) # テンプレートの元 name は "baseline_minitias_blend"（サフィックスなし） assert data["name"] != "baseline_minitias_blend", ( "name がテンプレートのまま更新されていません" )