ReportGenerator
===============

Report generator for test runs.

Generates human-readable and machine-parseable reports from test results.

Classes
-------

.. py:class:: ReportGenerator

   Generates reports from test results.
   
   Usage:
       generator = ReportGenerator()
   
       # Generate markdown report
       report = generator.generate_markdown(suite_result)
       print(report)
   
       # Save to file
       generator.save_markdown(suite_result, Path("./report.md"))
   
       # Generate summary for Claude review
       summary = generator.generate_summary(suite_result)

   **Methods:**

   .. py:method:: generate_markdown()

      Generate a markdown report from test suite results.

   .. py:method:: save_markdown()

      Save markdown report to file.

   .. py:method:: generate_summary()

      Generate a summary for Claude review.

   .. py:method:: save_summary()

      Save summary to JSON file.


Functions
---------

.. py:function:: generate_markdown()

   Generate a markdown report from test suite results.
   
   Args:
       suite_result: TestSuiteResult to report on.
   
   Returns:
       Markdown-formatted report string.

.. py:function:: save_markdown()

   Save markdown report to file.
   
   Args:
       suite_result: TestSuiteResult to report on.
       filepath: Path to save report.

.. py:function:: generate_summary()

   Generate a summary for Claude review.
   
   Returns a structured dictionary suitable for AI analysis.
   
   Args:
       suite_result: TestSuiteResult to summarize.
   
   Returns:
       Summary dictionary with key information.

.. py:function:: save_summary()

   Save summary to JSON file.
   
   Args:
       suite_result: TestSuiteResult to summarize.
       filepath: Path to save summary.