bundle.perf_report.storage.base
===============================

.. py:module:: bundle.perf_report.storage.base

.. autoapi-nested-parse::

   Shared HDF5 storage utilities for performance data.



Attributes
----------

.. autoapisummary::

   bundle.perf_report.storage.base.MAX_NAME_LEN
   bundle.perf_report.storage.base.MAX_FILE_LEN
   bundle.perf_report.storage.base.MAX_FUNC_LEN


Functions
---------

.. autoapisummary::

   bundle.perf_report.storage.base.safe_key
   bundle.perf_report.storage.base.run_prefix
   bundle.perf_report.storage.base.write_meta
   bundle.perf_report.storage.base.list_versions
   bundle.perf_report.storage.base.list_platforms
   bundle.perf_report.storage.base.load_meta


Module Contents
---------------

.. py:data:: MAX_NAME_LEN
   :value: 128


.. py:data:: MAX_FILE_LEN
   :value: 256


.. py:data:: MAX_FUNC_LEN
   :value: 128


.. py:function:: safe_key(text: str) -> str

   Make a string safe for use as an HDF5 group key (no slashes).


.. py:function:: run_prefix(version: str, platform_id: str) -> str

.. py:function:: write_meta(store: bundle.hdf5.Store, prefix: str, machine_id: str, bundle_version: str, platform_id: str, platform_meta: dict | None = None)

   Write metadata attributes under the given prefix.


.. py:function:: list_versions(h5_path: pathlib.Path) -> list[str]

   List all stored version keys.


.. py:function:: list_platforms(h5_path: pathlib.Path, version: str) -> list[str]

   List all platform IDs stored under a version.


.. py:function:: load_meta(h5_path: pathlib.Path, version: str, platform_id: str) -> dict

   Read the metadata for a specific version+platform run.