TESTING.md

Testing & CI/CD Guide (Python)

This document explains how to run the test suite, execute performance benchmarks, and understand the automated quality checks for the gate_learner project.

Running Tests Locally

1. Unit and Integration Tests

To run all unit tests and integration tests:

uv run pytest

2. Documentation Tests

To verify that all code examples in the documentation and doc comments compile and run correctly:

uv run pytest --doctest-modules

3. Linting and Formatting

We use ruff to enforce strict code quality and formatting standards:

# Check for lint errors
uv run ruff check

# Format code
uv run ruff format

4. Performance Benchmarks

Untuk menjalankan pengujian performa menggunakan pyperf dan menghasilkan laporan JSON serta HTML secara otomatis:

uv run python benches/mlp_benchmark.py -o benchmark_results.json