vidya 1.5.0

Vidya — programming reference library and queryable corpus for AGNOS
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

// Basic usage of the Vidya crate.
//
// Demonstrates loading content, searching, comparing across languages,
// and browsing best practices/gotchas/performance notes.
//
// Run: cargo run --example basic

use std::path::Path;
use vidya::compare::compare;
use vidya::loader::load_all;
use vidya::search::search;
use vidya::{Language, SearchQuery, Topic};

fn main() {
    // ── Load the content corpus ───────────────────────────────────────
    let registry = load_all(Path::new("content")).expect("content directory should load");

    println!("Loaded {} concepts:", registry.list().len());
    for concept in registry.list() {
        let langs: Vec<_> = concept.examples.keys().map(|l| l.to_string()).collect();
        println!("  {} — {} languages", concept.id, langs.len());
    }

    // ── Search ────────────────────────────────────────────────────────
    println!("\nSearch for 'quantum':");
    let results = search(&registry, &SearchQuery::text("quantum"));
    for r in &results {
        println!("  {} (score: {:.1})", r.title, r.score);
    }

    // Search with tag filter
    println!("\nSearch tag 'security':");
    let results = search(&registry, &SearchQuery::tagged(vec!["security".into()]));
    for r in &results {
        println!("  {} (score: {:.1})", r.title, r.score);
    }

    // Search with language filter
    let mut query = SearchQuery::text("error");
    query.language = Some(Language::Rust);
    println!("\nSearch 'error' (Rust only):");
    let results = search(&registry, &query);
    for r in &results {
        println!("  {} (score: {:.1})", r.title, r.score);
    }

    // ── Compare across languages ──────────────────────────────────────
    println!("\nCompare 'algorithms' — Rust vs Python vs Go:");
    if let Ok(cmp) = compare(
        &registry,
        "algorithms",
        &[Language::Rust, Language::Python, Language::Go],
    ) {
        println!("  Concept: {}", cmp.concept_title);
        for impl_ in &cmp.implementations {
            println!("  {} — {} chars of code", impl_.language, impl_.code.len());
        }
    }

    // ── Browse by topic ───────────────────────────────────────────────
    println!("\nKernel Topics:");
    for concept in registry.by_topic(&Topic::KernelTopics) {
        println!("  {}: {}", concept.title, concept.description);
        println!("    Best practices: {}", concept.best_practices.len());
        println!("    Gotchas: {}", concept.gotchas.len());
        println!("    Performance notes: {}", concept.performance_notes.len());
    }

    // ── Gotchas deep dive ─────────────────────────────────────────────
    if let Some(concept) = registry.get("security") {
        println!("\nSecurity gotchas:");
        for g in &concept.gotchas {
            println!("  ⚠ {}", g.title);
            println!("    {}", g.explanation);
            if let Some(ref bad) = g.bad_example {
                println!("    BAD:  {bad}");
            }
            if let Some(ref good) = g.good_example {
                println!("    GOOD: {good}");
            }
        }
    }

    // ── Performance notes ─────────────────────────────────────────────
    if let Some(concept) = registry.get("quantum_computing") {
        println!("\nQuantum computing performance notes:");
        for p in &concept.performance_notes {
            println!("  ⚡ {}", p.title);
            if let Some(ref ev) = p.evidence {
                println!("    Evidence: {ev}");
            }
        }
    }
}