---
title: "Test Suite Guide"
---

# Test Suite Guide

Use focused Cargo targets to validate HeliosDB Nano features from the source tree.

## Quick Start

```bash
cd HeliosDB-Nano
cargo test
```

For a narrower run, choose the area you are validating.

## Focused Test Areas

| Area | Command |
|------|---------|
| SQL branching | `cargo test branch_sql_integration_tests` |
| Materialized views | `cargo test materialized_view_tests` |
| Materialized view integration | `cargo test materialized_view_integration` |
| System views and REPL metadata | `cargo test repl_meta_commands` |
| Time-travel and system views | `cargo test time_travel_system_views_tests` |
| PostgreSQL SCRAM auth | `cargo test --test postgres_scram_auth_tests` |
| PostgreSQL SSL/TLS | `cargo test --test postgres_ssl_tests` |
| PostgreSQL extended protocol | `cargo test --test postgres_extended_protocol_tests` |
| Binary int4 protocol regression | `cargo test --test v334_a15_binary_int4` |

## Manual Smoke Test

```bash
./target/release/heliosdb-nano repl << 'EOF'
CREATE TABLE smoke (id INT, name TEXT);
INSERT INTO smoke VALUES (1, 'ok');
SELECT * FROM smoke AS OF NOW;
CREATE DATABASE BRANCH smoke_branch FROM main AS OF NOW;
SELECT branch_name FROM pg_database_branches();
DROP DATABASE BRANCH smoke_branch;
\q
EOF
```

## Build Before Running Release-Binary Checks

```bash
cargo build --release
```

## See Also

- [Advanced Feature Testing Guide](https://www.heliosdb.com/docs/nano/guides/testing_guide/)
- [SQL Features](https://www.heliosdb.com/docs/nano/features/sql_features/)