Skip to content
HomeStar Docs

Test Reports Reference

Test Reports Reference

Section titled “Test Reports Reference”

Complete reference for pytest HTML test reports.

Latest Test Report

Section titled “Latest Test Report”

Test Categories

Section titled “Test Categories”

The test suite covers the following areas:

Health & Infrastructure

Section titled “Health & Infrastructure”
  • Server health endpoints
  • Database connectivity
  • Version information

Authentication & Authorization

Section titled “Authentication & Authorization”
  • API key validation
  • JWT token verification
  • Role-based access control (Admin, Broker, Agent)

API Endpoints

Section titled “API Endpoints”
  • List agents with pagination
  • Search agents by name/email
  • Create, update, delete agents
  • Semantic search integration

Test Configuration

Section titled “Test Configuration”

Tests use pytest with the following plugins:

  • pytest-asyncio - Async test support for FastAPI
  • pytest-html - HTML report generation
  • pytest-cov - Coverage measurement

Configuration in pyproject.toml:

[tool.pytest.ini_options]
asyncio_mode = "auto"
testpaths = ["tests"]

Report Contents

Section titled “Report Contents”

The HTML report includes:

  • Summary Section: Pass/fail counts, duration, environment info
  • Results Table: Each test with status, duration, and category
  • Failure Details: Full tracebacks with local variables for failed tests
  • Environment Info: Python version, platform, installed plugins

Publishing Reports

Section titled “Publishing Reports”

Reports are regenerated on each test run and can be published to this documentation site:

Terminal window
make publish-docs

This copies the latest reports to the docs public/reports/ directory.