README
¶
Integration Tests for Hex Phase 2
This directory contains end-to-end integration tests for the Hex CLI Phase 2 implementation.
Test Files
- helpers.go - Common test utilities and helper functions
- storage_test.go - Database persistence and conversation/message CRUD
- tools_test.go - Tool registry, executor, and individual tool tests
- api_test.go - Anthropic API client and streaming tests
- ui_test.go - UI model state and lifecycle tests (simplified)
- scenarios_test.go - End-to-end realistic user workflows
Running Tests
# Run all integration tests
go test ./test/integration/...
# Run in short mode (skips slow/API tests)
go test -short ./test/integration/...
# Run with coverage
go test -cover ./test/integration/...
# Run specific test
go test -run TestStorageIntegration ./test/integration/...
Test Requirements
Storage Tests
- SQLite database created and initialized
- Conversations and messages persisted
- Foreign key constraints work
- Timestamps update correctly
Tools Tests
- All three tools (Read, Write, Bash) registered
- Tools execute successfully
- Approval/denial flow works
- Concurrent execution is safe
API Tests (Skipped in Short Mode)
- Require
ANTHROPIC_API_KEYenvironment variable - Test streaming responses
- Test token counting
- Test error handling
UI Tests
- Model initialization
- State transitions
- Message handling
- Basic lifecycle
Scenario Tests
- Complete workflows combining all components
- Error recovery
- Resume conversation
- Multi-tool sequences
Notes
- Tests use temporary databases (
t.TempDir()) - All tests clean up after themselves
- API tests are skipped in
-shortmode - Some tests check for specific error messages (may be brittle)
Documentation
¶
Index ¶
- func AssertFileContains(t *testing.T, path, expectedContent string)
- func AssertFileExists(t *testing.T, path string)
- func CreateTestConversation(t *testing.T, db *sql.DB, model string) string
- func CreateTestDir(t *testing.T) string
- func CreateTestFile(t *testing.T, content string) string
- func CreateTestMessage(t *testing.T, db *sql.DB, conversationID, role, content string) string
- func MockAPIClient(t *testing.T, _ []core.MessageResponse) *core.Client
- func SetupTestDB(t *testing.T) *sql.DB
- func WaitForCondition(t *testing.T, timeout time.Duration, interval time.Duration, ...)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AssertFileContains ¶
AssertFileContains checks that a file contains expected content
func AssertFileExists ¶
AssertFileExists checks that a file exists and has expected content
func CreateTestConversation ¶
CreateTestConversation creates a conversation with test data
func CreateTestDir ¶
CreateTestDir creates a temporary test directory
func CreateTestFile ¶
CreateTestFile creates a temporary test file with content
func CreateTestMessage ¶
CreateTestMessage creates a message in the database
func MockAPIClient ¶
MockAPIClient returns a mock API client for testing This is a placeholder - actual implementation depends on whether you have mocking infrastructure
func SetupTestDB ¶
SetupTestDB creates a temporary test database
Types ¶
This section is empty.
Source Files
Click to show internal directories.
Click to hide internal directories.