llmwiki-tooling 0.3.0

CLI for managing LLM-wikis with Obsidian-style wikilinks.
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

use crate::error::WikiError;
use crate::link_index::LinkIndex;
use crate::page::PageId;
use crate::wiki::Wiki;

/// Run `refs to <page>`: list all pages that link to the given page.
pub fn refs_to(wiki: &Wiki, page_name: &str) -> Result<(), WikiError> {
    let page_id = PageId::from(page_name);
    let lookup_id = wiki.canonical_id(&page_id).unwrap_or(&page_id);
    let index = LinkIndex::build(wiki)?;

    let sources = index.inbound_paths(lookup_id);

    for source in &sources {
        println!("{} -> {page_name}", source.display());
    }

    if sources.is_empty() {
        eprintln!("no inbound links to '{page_name}'");
    }

    Ok(())
}

/// Run `refs from <page>`: list all pages the given page links to.
pub fn refs_from(wiki: &Wiki, page_name: &str) -> Result<(), WikiError> {
    let page_id = PageId::from(page_name);
    let lookup_id = wiki.canonical_id(&page_id).unwrap_or(&page_id);
    let index = LinkIndex::build(wiki)?;

    let outbound = index.outbound(lookup_id);

    let mut targets: Vec<&str> = outbound.iter().map(|wl| wl.page.as_str()).collect();
    targets.sort();
    targets.dedup();

    for target in &targets {
        println!("{page_name} -> {target}");
    }

    if targets.is_empty() {
        eprintln!("no outbound links from '{page_name}'");
    }

    Ok(())
}

/// Run `refs graph`: dump the full link graph.
pub fn refs_graph(wiki: &Wiki) -> Result<(), WikiError> {
    let index = LinkIndex::build(wiki)?;
    let edges = index.all_edges();

    for (source, target) in &edges {
        println!("{source} -> {target}");
    }

    Ok(())
}