rust-tests
运行和调试glhf的Rust测试。运行测试、修复测试失败或添加新测试用例时使用。
📖 中文导读:运行和调试glhf的Rust测试。运行测试、修复测试失败或添加新测试用例时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: rust-tests description: Run and debug Rust tests for glhf. Use when running tests, fixing test failures, or adding new test cases.
Rust Testing Guide
Running Tests
All Tests
cargo test
Embedding Tests (require model download)
cargo test embed -- --ignored
Specific Tests
cargo test test_name # Run tests matching name
cargo test --lib # Only library tests
cargo test --test integration # Only integration tests
cargo test -- --nocapture # Show println output
Test Structure
tests/
├── integration.rs # End-to-end tests
└── common/
└── mod.rs # Test utilities (TestEnv, fixtures)
src/
├── db/mod.rs # Unit tests in #[cfg(test)] mod tests
├── embed.rs # Embedding tests (#[ignore] for CI)
└── document.rs # Document struct tests
Test Utilities
TestEnv (tests/common/mod.rs)
let env = TestEnv::new(); // Creates temp directory
let project = env.create_project("path"); // Creates project dir
let jsonl = env.write_jsonl(&project, "file.jsonl", &lines);
Fixtures
fn user_message(content: &str, session: &str) -> String
fn assistant_message(content: &str, session: &str) -> String
fn assistant_with_blocks(texts: &[&str], session: &str) -> String
fn file_history_snapshot() -> String
fn malformed_json() -> String
Test Categories
| Category | Location | Run Command |
|---|---|---|
| Unit tests | src/**/*.rs |
cargo test --lib |
| Integration | tests/integration.rs |
cargo test --test integration |
| Doc tests | src/**/*.rs |
cargo test --doc |
| Embedding | src/embed.rs |
cargo test embed -- --ignored |
| Benchmarks | benches/indexing.rs |
cargo bench |
Writing Tests
Database Tests
#[test]
fn test_database_operation() {
let env = TestEnv::new();
let db_path = env.index_dir.join("test.db");
let mut db = Database::open(&db_path).unwrap();
let doc = Document::new(
ChunkKind::Message,
"test content".to_string(),
PathBuf::from("/test"),
);
db.insert_documents(&[doc]).unwrap();
let results = db.search_fts("test", 10).unwrap();
assert_eq!(results.len(), 1);
}
Embedding Tests (ignored by default)
#[test]
#[ignore = "Requires model download"]
fn test_embedding() {
let embedder = Embedder::new().unwrap();
let embedding = embedder.embed_query("test").unwrap();
assert_eq!(embedding.len(), 512); // Potion-base-32M dimension
}
Common Failures
| Error | Cause | Fix |
|---|---|---|
Failed to load model |
Missing/corrupted model | Delete HF cache, re-run |
sqlite-vec not loaded |
Init order | Call init_sqlite_vec() before open |
FTS5 match failed |
Bad query syntax | Escape special chars |