Files
routstr-core/tests/unit
Paperclip Deployment Engineerand9qeklajc 1ece8bbde5 test: add vulnerability-reproducing and coverage-filling tests
Adds 40 new tests across 5 test files that document critical bugs and
fill coverage gaps in the routstr-core codebase:

- test_emergency_refund_integrity.py (5 tests):
  Documents the try/except/pass vulnerability in emergency refund paths
  (base.py:3643-3653 and base.py:4607-4617) where DB store failures
  silently lose minted tokens. Verifies store_cashu_transaction catches
  all exceptions and send_token mints before DB persistence.

- test_zero_cost_fallback.py (6 tests):
  Documents the hardcoded zero-cost fallback (base.py:1012-1030) where
  exceptions from adjust_payment_for_tokens() result in total_msats=0,
  giving users free service with permanently reserved balances.

- test_db_and_payout_resilience.py (8 tests):
  Confirms store_cashu_transaction_with_retry was reverted (#600→#604).
  Documents the fee payout pay-then-reset crash window and wallet
  caching mechanism.

- test_coverage_middleware.py (11 tests):
  Fills middleware.py coverage gap (was 38%) — tests LoggingMiddleware,
  _should_log filters, request_id_context, and middleware exports.

- test_coverage_payment_helpers.py (10 tests):
  Fills payment/helpers.py coverage gap (was 52%) — tests
  check_token_balance, estimate_tokens, create_error_response,
  and image token calculation helpers.

All tests pass against current main (830 passed, 13 skipped).
2026-07-24 21:40:55 +02:00
..
2025-08-03 20:35:59 -03:00
2025-08-09 14:55:26 -03:00
2026-06-13 23:40:39 +02:00
2026-06-27 22:53:35 +02:00
2026-07-22 23:10:27 +02:00
2026-07-05 23:35:10 +02:00
fmt
2025-10-24 16:40:37 +02:00
2026-07-05 23:35:10 +02:00
2026-07-01 17:08:28 +02:00
2026-07-01 16:53:52 +02:00
2026-05-14 15:40:49 +02:00
2026-07-22 23:10:27 +02:00
2026-07-22 23:10:27 +02:00

FastAPI Async Unit Tests

This directory contains async unit tests for the Routstr proxy FastAPI application.

Installation

First, ensure you have the development dependencies installed:

uv pip install -e ".[dev]"

Running Tests

To run all tests:

pytest

To run tests with coverage:

pytest --cov=routstr --cov-report=html

To run specific test files:

pytest tests/test_main.py
pytest tests/test_models.py
pytest tests/test_proxy.py

To run only async tests:

pytest -m asyncio

Test Structure

  • conftest.py - Pytest fixtures and configuration
  • test_main.py - Tests for main app endpoints
  • test_account.py - Tests for wallet/account management endpoints
  • test_proxy.py - Tests for the proxy functionality with mocked upstream
  • test_models.py - Tests for model pricing and data structures

Key Fixtures

  • async_client - Async HTTP client for testing FastAPI endpoints
  • test_session - In-memory SQLite database session for tests
  • test_api_key - Pre-configured API key with balance
  • api_key_with_balance - API key with sufficient balance for proxy tests

Environment Variables

The tests automatically set up required environment variables in conftest.py. No manual configuration needed.

Writing New Tests

  1. Use @pytest.mark.asyncio for async tests
  2. Use the provided fixtures for database and client access
  3. Mock external dependencies (like upstream API calls)
  4. Test both success and error cases
  5. Verify database state changes when applicable