bundle.perf_report.extractor.tracy
==================================

.. py:module:: bundle.perf_report.extractor.tracy

.. autoapi-nested-parse::

   Tracy CSV profiling data extraction.



Classes
-------

.. autoapisummary::

   bundle.perf_report.extractor.tracy.ProfileRecord
   bundle.perf_report.extractor.tracy.ProfileData
   bundle.perf_report.extractor.tracy.ProfileExtractor


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

.. py:class:: ProfileRecord

   A single zone entry from a Tracy CSV export (tracy-csvexport).


   .. py:attribute:: name
      :type:  str


   .. py:attribute:: src_file
      :type:  str


   .. py:attribute:: src_line
      :type:  int


   .. py:attribute:: total_ns
      :type:  int


   .. py:attribute:: total_perc
      :type:  float


   .. py:attribute:: counts
      :type:  int


   .. py:attribute:: mean_ns
      :type:  int


   .. py:attribute:: min_ns
      :type:  int


   .. py:attribute:: max_ns
      :type:  int


   .. py:attribute:: std_ns
      :type:  float


.. py:class:: ProfileData

   All zone records extracted from one Tracy CSV file.


   .. py:attribute:: csv_path
      :type:  pathlib.Path


   .. py:attribute:: records
      :type:  list[ProfileRecord]
      :value: []



   .. py:property:: name
      :type: str



   .. py:property:: total_calls
      :type: int



.. py:class:: ProfileExtractor

   Extract profiling data from Tracy CSV files produced by tracy-csvexport.


   .. py:method:: extract(csv_path: pathlib.Path) -> ProfileData
      :staticmethod:


      Parse a single Tracy CSV file and return structured data.



   .. py:method:: extract_from_tracy(tracy_path: pathlib.Path) -> ProfileData
      :staticmethod:


      Run tracy-csvexport on a .tracy file, save a sibling .csv, and return ProfileData.

      Requires tracy-csvexport to be on PATH (built via: bundle tracy build csvexport).
      The CSV is saved alongside the .tracy file so it can be reused without re-exporting.



   .. py:method:: extract_all(path: pathlib.Path) -> list[ProfileData]
      :staticmethod:


      Extract from a .tracy file, a single CSV file, or all CSV files in a directory.