ferritin-common 0.7.0

library for rustdoc navigation and search
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

use anyhow::Result;
use ferritin_common::sources::{DocsRsSource, Source};
use semver::VersionReq;
use std::env;

fn main() -> Result<()> {
    env_logger::init();

    let args: Vec<String> = env::args().collect();
    if args.len() != 2 {
        eprintln!("Usage: {} <crate_name[@version]>", args[0]);
        eprintln!("Examples:");
        eprintln!("  {} clap", args[0]);
        eprintln!("  {} clap@latest", args[0]);
        eprintln!("  {} serde@1.0.195", args[0]);
        std::process::exit(1);
    }

    let input = &args[1];
    let (crate_name, version) = if let Some((name, ver)) = input.split_once('@') {
        (name, VersionReq::parse(ver)?)
    } else {
        (input.as_str(), VersionReq::STAR)
    };

    println!("Resolving {crate_name} version {version}\n");

    // Create client with temp cache dir
    let cache_dir = env::temp_dir().join("rustdoc-cache-example");
    let source = DocsRsSource::new(cache_dir)?;

    match source.lookup(crate_name, &version) {
        Some(crate_info) => {
            println!(
                "Resolved {}@{}: {}\n",
                crate_info.name(),
                crate_info.version().unwrap(),
                crate_info
                    .description()
                    .unwrap_or_default()
                    .replace('\n', " ")
            );
            match source.load(crate_info.name(), crate_info.version()) {
                Some(data) => {
                    println!("✓ Successfully fetched rustdoc data!");
                    println!();
                    println!("Crate: {}", data.name());
                    println!(
                        "Version: {}",
                        data.crate_version.as_deref().unwrap_or("unknown")
                    );
                    println!("Items in index: {}", data.index.len());
                    println!("External crates: {}", data.external_crates.len());
                    println!("Cache path: {}", data.fs_path().display());

                    // Print the root module name
                    if let Some(root_item) = data.index.get(&data.root) {
                        println!(
                            "Root module: {}",
                            root_item.name.as_deref().unwrap_or("(unnamed)")
                        );
                    }
                }

                None => {
                    println!("✗ json not found on docs.rs");
                    std::process::exit(1);
                }
            }
        }
        None => {
            println!("✗ Crate not found on crates.io");
            std::process::exit(1);
        }
    }

    Ok(())
}