laurus 0.6.0

Unified search library for lexical, vector, and semantic retrieval
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! Quickstart — Your first full-text search with Laurus
//!
//! This minimal example shows how to:
//! 1. Create an in-memory search engine
//! 2. Define a schema with text fields
//! 3. Index documents
//! 4. Search with a simple term query
//!
//! Run with: `cargo run --example quickstart`

mod common;

use laurus::lexical::{TermQuery, TextOption};
use laurus::{Document, Engine, LexicalSearchQuery, Schema, SearchRequestBuilder};

#[tokio::main]
async fn main() -> laurus::Result<()> {
    println!("=== Laurus Quickstart ===\n");

    // 1. Create storage and schema
    let storage = common::memory_storage()?;
    let schema = Schema::builder()
        .add_text_field("title", TextOption::default())
        .add_text_field("body", TextOption::default())
        .build();

    // 2. Create engine (no embedder needed for lexical-only search)
    let engine = Engine::new(storage, schema).await?;

    // 3. Index documents
    engine
        .add_document(
            "doc1",
            Document::builder()
                .add_text("title", "Introduction to Rust")
                .add_text(
                    "body",
                    "Rust is a systems programming language focused on safety and performance.",
                )
                .build(),
        )
        .await?;

    engine
        .add_document(
            "doc2",
            Document::builder()
                .add_text("title", "Python for Data Science")
                .add_text("body", "Python is a versatile language widely used in data science and machine learning.")
                .build(),
        )
        .await?;

    engine
        .add_document(
            "doc3",
            Document::builder()
                .add_text("title", "Web Development with JavaScript")
                .add_text("body", "JavaScript powers the modern web, from frontend frameworks to backend services.")
                .build(),
        )
        .await?;

    engine.commit().await?;
    println!("Indexed 3 documents.\n");

    // 4. Search for "rust"
    println!("[Search] term 'rust' in body:");
    let results = engine
        .search(
            SearchRequestBuilder::new()
                .lexical_query(LexicalSearchQuery::Obj(Box::new(TermQuery::new(
                    "body", "rust",
                ))))
                .limit(5)
                .build(),
        )
        .await?;
    common::print_search_results(&results);

    // 5. Search for "language"
    println!("\n[Search] term 'language' in body:");
    let results = engine
        .search(
            SearchRequestBuilder::new()
                .lexical_query(LexicalSearchQuery::Obj(Box::new(TermQuery::new(
                    "body", "language",
                ))))
                .limit(5)
                .build(),
        )
        .await?;
    common::print_search_results(&results);

    Ok(())
}