"""Catalog artifact naming and writing."""from__future__importannotationsfromcollections.abcimportMappingfrompathlibimportPath__all__=["catalog_filename","write_text_artifacts"]
[docs]defcatalog_filename(asset_id:str,suffix:str=".jsonnet")->str:"""Return the standard catalog filename for an Earth Engine asset ID."""normalized=asset_id.strip().strip("/")ifnotnormalized:raiseValueError("Earth Engine asset ID must not be empty")ifnotsuffix.startswith("."):raiseValueError(f"Catalog filename suffix must start with '.': {suffix!r}")returnnormalized.replace("/","_")+suffix
[docs]defwrite_text_artifacts(output_dir:Path,artifacts:Mapping[Path|str,str],)->list[Path]:"""Write a deterministic set of UTF-8 text artifacts below output_dir."""output_root=output_dir.resolve()written:list[Path]=[]forrelative_path,contentinartifacts.items():relative=Path(relative_path)ifrelative.is_absolute()or".."inrelative.parts:raiseValueError(f"Artifact path must be relative and remain below the output directory: {relative}")destination=(output_root/relative).resolve()ifnotdestination.is_relative_to(output_root):raiseValueError(f"Artifact path escapes output directory: {relative}")destination.parent.mkdir(parents=True,exist_ok=True)destination.write_text(content,encoding="utf-8",newline="\n")written.append(destination)returnwritten