# Test Environment

## Overview

**System under test**: Azaion.Loader FastAPI service at `http://localhost:8080`
**Consumer app purpose**: Python pytest suite exercising the loader through its HTTP API, validating black-box use cases without access to Cython internals.

## Test Execution

**Decision**: Local execution
**Hardware dependencies found**:
- `hardware_service.pyx`: uses `subprocess` with `lscpu`, `lspci`, `/sys/block/sda` (Linux) or PowerShell (Windows) — requires real OS hardware info
- `binary_split.py`: calls `docker load` and `docker image inspect` — requires Docker daemon
- Cython extensions: must be compiled natively for the target platform

**Execution instructions (local)**:
1. Prerequisites: Python 3.11, GCC, Docker daemon running
2. Install deps: `pip install -r requirements.txt && python setup.py build_ext --inplace`
3. Start system: `uvicorn main:app --host 0.0.0.0 --port 8080`
4. Run tests: `pytest tests/ -v --tb=short`
5. Environment variables: `RESOURCE_API_URL`, `IMAGES_PATH`, `API_VERSION`

## Docker Environment

### Services

| Service | Image / Build | Purpose | Ports |
|---------|--------------|---------|-------|
| system-under-test | Build from `Dockerfile` | Azaion.Loader | 8080 |
| mock-api | Python (httpbin or custom) | Mock Azaion Resource API | 9090 |
| mock-cdn | MinIO (S3-compatible) | Mock S3 CDN | 9000 |
| e2e-consumer | `python:3.11-slim` + pytest | Black-box test runner | — |

### Networks

| Network | Services | Purpose |
|---------|----------|---------|
| e2e-net | all | Isolated test network |

### Volumes

| Volume | Mounted to | Purpose |
|--------|-----------|---------|
| test-data | e2e-consumer:/data | Test input files |
| docker-sock | system-under-test:/var/run/docker.sock | Docker daemon access |

## Consumer Application

**Tech stack**: Python 3.11, pytest, requests
**Entry point**: `pytest tests/ -v`

### Communication with system under test

| Interface | Protocol | Endpoint | Authentication |
|-----------|----------|----------|----------------|
| Loader API | HTTP | `http://system-under-test:8080` | POST /login first |

### What the consumer does NOT have access to

- No direct access to Cython `.so` modules
- No shared filesystem with the main system (except Docker socket for verification)
- No direct access to mock-api or mock-cdn internals

## CI/CD Integration

**When to run**: On push to dev/stage/main (extend `.woodpecker/build-arm.yml`)
**Pipeline stage**: After build, before push
**Gate behavior**: Block push on failure
**Timeout**: 300 seconds (5 minutes)

## Reporting

**Format**: CSV
**Columns**: Test ID, Test Name, Execution Time (ms), Result (PASS/FAIL/SKIP), Error Message
**Output path**: `./test-results/report.csv`