Function main

examples/rust/bindings/simple_usage.rs:13–134

()

use std::error::Error;

fn main() -> Result<(), Box<dyn Error>> {
    println!("=== GraphLite Simple Usage Example ===\n");

    // Step 1: Initialize GraphLite with a database path
    // This single line handles all internal component setup
    println!("1. Initializing database...");
    let coordinator = QueryCoordinator::from_path("./example_db")
        .map_err(|e| format!("Failed to initialize database: {}", e))?;
    println!("   ✓ Database initialized\n");

    // Step 2: Create a session
    // Sessions track user context and graph/schema preferences
    println!("2. Creating session...");
    let session_id = coordinator
        .create_simple_session("example_user")
        .map_err(|e| format!("Failed to create session: {}", e))?;
    println!("   ✓ Session created: {}\n", session_id);

    // Step 3: Validate and analyze queries before execution
    println!("3. Validating and analyzing queries...");

    let test_query = "MATCH (n:Person) RETURN n.name";

    // Validate query syntax
    println!("   → Validating query...");
    match coordinator.validate_query(test_query) {
        Ok(_) => println!("     ✓ Query is valid"),
        Err(e) => println!("     ✗ Query validation failed: {}", e),
    }

    // Check if query is valid (convenience method)
    if coordinator.is_valid_query(test_query) {
        println!("     ✓ Query syntax check passed");
    }

    // Analyze query
    println!("   → Analyzing query...");
    match coordinator.analyze_query(test_query) {
        Ok(info) => {
            println!("     ✓ Query type: {:?}", info.query_type);
            println!("     ✓ Read-only: {}", info.is_read_only);
        }
        Err(e) => println!("     ✗ Query analysis failed: {}", e),
    }

    // Test with an invalid query
    println!("   → Testing invalid query...");
    let invalid_query = "MATCH (n RETURN n";
    if !coordinator.is_valid_query(invalid_query) {
        println!("     ✓ Correctly detected invalid query");
    }

    // Explain query execution plan
    println!("   → Explaining query execution plan...");
    match coordinator.explain_query(test_query) {
        Ok(plan) => {
            println!("     ✓ {}", plan.summary());
            println!("     Query Plan:\n{}", plan.format_tree());